oneandone_server - Создание, уничтожение, запуск, остановка и перезагрузка сервера 1&1 Host.

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

Обзор
- Требования
Параметры
Примеры
Возвращаемые значения
Статус
- Автор

Обзор

Создание, уничтожение, обновление, запуск, остановка и перезагрузка сервера 1&1 Host. При создании сервера можно опционально подождать, пока он станет «работающим», прежде чем вернуть результат.

Требования

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

1and1
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_url		Пользовательский URL API. Переопределяет переменную среды ONEANDONE_API_URL.
appliance		Имя или ID операционной системы для сервера. Требуется только для состояния 'present'.
auth_token обязательно		Токен аутентификации API, предоставленный 1&1. Переопределяет переменную среды ONEANDONE_AUTH_TOKEN.
auto_increment	Варианты: да ← нет	При одновременном создании нескольких серверов, указывает, следует ли различать имена хостов добавлением номера после них или заменой номера в строке имени хоста на %02d или %03d.
cores_per_processor		Количество ядер на процессор. Должно быть указано вместе с параметрами vcore, ram и hdds.
count	Значение по умолчанию: 1	Количество серверов для создания.
datacenter	Варианты: US ← ES DE GB	Расположение дата-центра.
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	Значение по умолчанию: None	Открытый ключ SSH пользователя (содержимое, а не путь).
state	Варианты: present ← absent running stopped	Определение состояния сервера для создания, удаления, запуска или остановки.
vcore		Общее количество процессоров. Должно быть указано вместе с параметрами cores_per_processor, ram и hdds.
wait	Варианты: да ← нет	Подождать, пока сервер не перейдет в состояние '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": "id-сервера"}]

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимости.

Автор

Амель Аджинович (@aajdinov)
Итан Девенпорт (@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.5/modules/oneandone_server_module.html