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 -		Список жестких дисков со вложенными свойствами «размер» и «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 список	всегда	Информация о каждом обработанном сервере Пример: [{"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.7/modules/oneandone_server_module.html