digital_ocean_droplet – Создание и удаление капли DigitalOcean
Новая в версии 2.8.
Описание
- Создать и удалить каплю в DigitalOcean и, по желанию, дождаться её активации.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| backups boolean |
| указывает, следует ли включить автоматические резервные копии. |
| id - | Числовое значение, идентификатор капли, с которой требуется взаимодействие. псевдонимы: droplet_id | |
| image - | Это псевдоним образа, с которым требуется создать каплю. псевдонимы: image_id | |
| ipv6 boolean |
| включить IPv6 для вашей капли. |
| monitoring boolean |
| указывает, следует ли установить агент DigitalOcean для мониторинга. |
| name - | Строка, это имя капли — должно соответствовать правилам именования хостов. | |
| oauth_token - / обязательно | Токен DigitalOcean OAuth. Может быть указан в переменных окружения DO_API_KEY, DO_API_TOKEN, или DO_OAUTH_TOKENпсевдонимы: API_TOKEN | |
| private_networking boolean |
| добавить дополнительный, частный сетевой интерфейс для капли для меж-капельного взаимодействия. |
| region - | Это псевдоним региона, в котором вы хотите создать сервер. псевдонимы: region_id | |
| size - | Это псевдоним размера, с которым вы хотите создать каплю. псевдонимы: size_id | |
| ssh_keys - | массив ID ключей SSH (числовые), которые вы хотите добавить к серверу. | |
| state - |
| Укажите желаемое состояние целевого объекта. |
| tags - | Список, список имен тегов в виде строк для применения к капле после её создания. Имена тегов могут быть существующими или новыми. | |
| unique_name boolean |
| требуется уникальное имя хоста. По умолчанию DigitalOcean позволяет несколько хостов с одинаковым именем. Установка в "да" разрешает только один хост на имя. Полезно для идемпотентности. |
| user_data - | непрозрачный блок данных, который становится доступным для капли | |
| volumes - | Список, список, содержащий уникальный строковый идентификатор каждого тома блочного хранилища, который нужно подключить к капле. | |
| wait boolean |
| Дождаться, пока капля не станет активной, прежде чем вернуть результат. Если wait = "нет", ip_address может быть не возвращён. |
| wait_timeout - | Значение по умолчанию: 120 | Сколько времени ждать, прежде чем wait прекратит ожидание, в секундах, при создании капли. |
Примеры
- name: create a new droplet
digital_ocean_droplet:
state: present
name: mydroplet
oauth_token: XXX
size: 2gb
region: sfo1
image: ubuntu-16-04-x64
wait_timeout: 500
register: my_droplet
- debug:
msg: "ID is {{ my_droplet.data.droplet.id }}, IP is {{ my_droplet.data.ip_address }}"
- name: ensure a droplet is present
digital_ocean_droplet:
state: present
id: 123
name: mydroplet
oauth_token: XXX
size: 2gb
region: sfo1
image: ubuntu-16-04-x64
wait_timeout: 500
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| data словарь | изменено | капля DigitalOcean Пример: {'ip_address': '104.248.118.172', 'ipv6_address': '2604:a880:400:d1::90a:6001', 'private_ipv4_address': '10.136.122.141', 'droplet': {'id': 3164494, 'name': 'example.com', 'memory': 512, 'vcpus': 1, 'disk': 20, 'locked': True, 'status': 'new', 'kernel': {'id': 2233, 'name': 'Ubuntu 14.04 x64 vmlinuz-3.13.0-37-generic', 'version': '3.13.0-37-generic'}, 'created_at': '2014-11-14T16:36:31Z', 'features': ['virtio'], 'backup_ids': [], 'snapshot_ids': [], 'image': {}, 'volume_ids': [], 'size': {}, 'size_slug': '512mb', 'networks': {}, 'region': {}, 'tags': ['web']}} |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Gurchet Rai (@gurch101)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/digital_ocean_droplet_module.html
