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 bool |
| При создании нескольких серверов одновременно, определяет, следует ли добавлять номер к именам хостов или подставлять его в строку имени хоста, где есть %02d или %03d. |
| cores_per_processor | Количество ядер на процессор. Должно быть указано вместе с параметрами vcore, ram и hdds. | |
| count | Значение по умолчанию: 1 | Количество серверов для создания. |
| datacenter |
| Расположение дата-центра. |
| description | Описание сервера. | |
| firewall_policy | Имя или ID политики брандмауэра. | |
| fixed_instance_size обязательно |
| Имя или 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 |
| Тип сервера для создания. |
| ssh_key | Открытый ключ SSH пользователя (содержимое, а не путь). | |
| state |
| Определяет состояние сервера для создания, удаления, запуска или остановки. |
| vcore | Общее количество процессоров. Должно быть указано вместе с параметрами cores_per_processor, ram и hdds. | |
| wait bool |
| Подождать, пока сервер не перейдет в состояние '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-сервера"}] |
Статус
Этот модуль помечен как превью, что означает, что гарантии обратной совместимости интерфейса нет.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, поддерживаемых сообществом 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.6/modules/oneandone_server_module.html
