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 boolean	Варианты: no yes ←	При создании нескольких серверов одновременно, следует ли различать имена хостов, добавляя номер после них, или заменяя этот номер в строке имени хоста, если там есть %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 -	Варианты: cloud ← baremetal k8s_node	Тип создаваемого сервера.
ssh_key -		Публичный ключ SSH пользователя (содержимое, а не путь).
state -	Варианты: present ← absent running stopped	Определите состояние сервера для создания, удаления, запуска или остановки.
vcore -		Общее количество процессоров. Должен быть указан вместе с параметрами cores_per_processor, ram и hdds.
wait boolean	Варианты: no yes ←	Подождать, пока сервер не перейдет в состояние «запущен», перед возвратом. Также используется для операции удаления (установите в «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 list	всегда	Информация о каждом обработанном сервере Пример: [{"hostname": "мой-сервер", "id": "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.9/modules/oneandone_server_module.html