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 -		массив идентификаторов SSH-ключей (числовых), которые вы хотите добавить к серверу.
state -	Варианты: present ← absent	Указывает желаемое состояние целевого объекта.
tags -		Список, список имен тегов в виде строк, которые нужно применить к дроплету после его создания. Имена тегов могут быть существующими или новыми тегами.
unique_name boolean	Варианты: нет ← да	требуются уникальные имена хостов. По умолчанию DigitalOcean разрешает несколько хостов с одинаковыми именами. Установка в "да" позволяет иметь только один хост на имя. Полезно для идемпотентности.
user_data -		неструктурированные данные, которые доступны дроплету
volumes -		Список, список уникальных строковых идентификаторов для каждого тома блочного хранения, которые нужно подключить к дроплету.
wait boolean	Варианты: нет да ←	Дождаться активации дроплеты перед возвратом. Если wait = "нет", адрес ip может не быть возвращён.
wait_timeout -	По умолчанию: 120	Время ожидания, в секундах, прежде чем ожидание завершится при создании дроплеты.

Примеры

- 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': 'новый', '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.8/modules/digital_ocean_droplet_module.html