oneandone_server – Создание, удаление, запуск, остановка и перезагрузка сервера 1&1 Host

Новая версия с 2.5.

Описание
Требования
Параметры
Примеры
Значения возврата
Статус

Описание

Создание, удаление, обновление, запуск, остановка и перезагрузка сервера 1&1 Host. При создании сервера можно дождаться его запуска ('running') перед возвратом.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

1and1
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_url -		Пользовательский URL API. Переопределяет переменную окружения ONEANDONE_API_URL.
appliance -		Имя или ID операционной системы сервера. Требуется только для состояния 'present'.
auth_token - / требуется		Аутентификационный токен API, предоставленный 1&1. Переопределяет переменную окружения ONEANDONE_AUTH_TOKEN.
auto_increment boolean	Варианты: нет да ←	При создании нескольких серверов одновременно, добавлять ли порядковый номер к имени хоста или подставлять его в строку имени хоста, где присутствует %02d или %03d.
cores_per_processor -		Количество ядер на процессор. Должно быть указано вместе с параметрами vcore, ram и hdds.
count -	По умолчанию: 1	Количество серверов для создания.
datacenter -	Варианты: США ← Испания Германия Великобритания	Расположение ЦОД.
description -		Описание сервера.
firewall_policy -		Имя или ID политики брандмауэра.
fixed_instance_size - / требуется	Варианты: S M L XL XXL 3XL 4XL 5XL	Имя или ID размера экземпляра сервера. Требуется только для состояния 'present', и взаимоисключительно с параметрами vcore, cores_per_processor, ram и hdds.
hdds -		Список жёстких дисков с вложенными свойствами "size" и "is_main". Должен быть указан вместе с параметрами vcore, cores_per_processor и ram.
hostname -		Имя хоста или ID сервера. Используется только при состоянии 'present'.
load_balancer -		Имя или ID балансировщика нагрузки.
monitoring_policy -		Имя или ID политики мониторинга.
private_network -		Имя или ID частной сети.
ram -		Объем оперативной памяти. Должен быть указан вместе с параметрами vcore, cores_per_processor и hdds.
server -		Идентификатор сервера (ID или имя хоста). Требуется для всех состояний, кроме 'running' и 'present'.
server_type -	Варианты: облачный ← baremetal k8s_node	Тип сервера для создания.
ssh_key -		Открытый ключ SSH пользователя (содержимое, а не путь).
state -	Варианты: present ← absent running stopped	Определение состояния сервера для создания, удаления, запуска или остановки.
vcore -		Общее количество процессоров. Должен быть указан вместе с параметрами cores_per_processor, ram и hdds.
wait boolean	Варианты: нет да ←	Дождаться состояния 'running' сервера перед возвратом. Также используется для операции удаления (установите 'false', если вы не хотите ждать удаления каждого отдельного сервера перед продолжением других задач.)
wait_interval -	По умолчанию: 5	Определяет количество секунд ожидания при использовании методов wait_for.
wait_timeout -	По умолчанию: 600	Время ожидания в секундах, прежде чем ожидание будет прервано.

Примеры

# Provisioning example. Creates three servers and enumerate their names.

- oneandone_server:
    auth_token: oneandone_private_api_key
    hostname: node%02d
    fixed_instance_size: XL
    datacenter: US
    appliance: C5A349786169F140BCBC335675014C08
    auto_increment: true
    count: 3

# Create three servers, passing in an ssh_key.

- oneandone_server:
    auth_token: oneandone_private_api_key
    hostname: node%02d
    vcore: 2
    cores_per_processor: 4
    ram: 8.0
    hdds:
      - size: 50
        is_main: false
    datacenter: ES
    appliance: C5A349786169F140BCBC335675014C08
    count: 3
    wait: yes
    wait_timeout: 600
    wait_interval: 10
    ssh_key: SSH_PUBLIC_KEY

# Removing server

- oneandone_server:
    auth_token: oneandone_private_api_key
    state: absent
    server: 'node01'

# Starting server.

- oneandone_server:
    auth_token: oneandone_private_api_key
    state: running
    server: 'node01'

# Stopping server

- oneandone_server:
    auth_token: oneandone_private_api_key
    state: stopped
    server: 'node01'

Значения возврата

Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое	Описание
servers список	всегда	Информация о каждом обработанном сервере Пример: [{"hostname": "мой-сервер", "id": "идентификатор-сервера"}]

Статус

Гарантируется, что этот модуль будет иметь обратную совместимость. [превью]
Этот модуль поддерживается Сообществом Ansible. [сообщество]

Авторы

Amel Ajdinovic (@aajdinov)
Ethan Devenport (@edevenport)

Подсказка

Если вы обнаружили какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/oneandone_server_module.html