community.digitalocean.digital_ocean_droplet – Создание и удаление виртуальной машины DigitalOcean

Примечание

Этот плагин входит в коллекцию community.digitalocean (версия 1.0.0).

Для его установки используйте: ansible-galaxy collection install community.digitalocean.

Для использования в плейбуке укажите: community.digitalocean.digital_ocean_droplet.

Обзор
Требования
Параметры
Примеры
Возвращаемые значения

Обзор

Создание и удаление виртуальной машины в DigitalOcean, а также опциональная ожидание её активации.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется данный модуль.

python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
backups boolean	Варианты: нет ← да	указывает, нужно ли включить автоматические резервные копии.
id string		Числовое значение, идентификатор виртуальной машины, с которым нужно взаимодействовать. псевдонимы: droplet_id
image string		Это имя образа, с которым будет создана виртуальная машина. псевдонимы: image_id
ipv6 boolean	Варианты: нет ← да	включить IPv6 для виртуальной машины.
monitoring boolean	Варианты: нет ← да	указывает, нужно ли установить агент DigitalOcean для мониторинга.
name string		Строка, имя виртуальной машины - должно соответствовать правилам для имен хостов.
oauth_token string / обязательно		Токен DigitalOcean OAuth. Может быть указан в `DO_API_KEY`, `DO_API_TOKEN`, или `DO_OAUTH_TOKEN` переменных среды псевдонимы: API_TOKEN
private_networking boolean	Варианты: нет ← да	добавить дополнительный частный сетевой интерфейс в виртуальную машину для межсетевого взаимодействия.
region string		Это имя региона, в котором вы хотите создать сервер. псевдонимы: region_id
size string		Это имя размера виртуальной машины, с которым будет создана виртуальная машина. псевдонимы: size_id
ssh_keys string		массив отпечатков ключей SSH, которые вы хотите добавить к серверу.
state string	Варианты: present ← absent	Указывает желаемое состояние цели.
tags string		Список, список имен тегов в виде строк для применения к виртуальной машине после ее создания. Имена тегов могут быть существующими или новыми тегами.
unique_name boolean	Варианты: нет ← да	требует уникальных имен хостов. По умолчанию DigitalOcean позволяет несколько хостов с одинаковым именем. Установка в "да" позволяет только одному хосту на имя. Полезно для идемпотентности.
user_data string		неструктурированные данные, которые доступны виртуальной машине.
volumes string		Список, список уникальных строковых идентификаторов каждого тома хранения данных, которые нужно прикрепить к виртуальной машине.
vpc_uuid string добавлен в 0.1.0 community.digitalocean		Строка, определяющая UUID VPC, к которому будет назначена виртуальная машина. Если исключить, виртуальная машина будет назначена на стандартный VPC для указанного региона.
wait boolean	Варианты: нет да ←	Подождать, пока виртуальная машина не станет активной перед возвратом. Если wait = "нет", ip-адрес может не быть возвращён.
wait_timeout string	Значение по умолчанию: 120	Сколько времени ожидать, прежде чем ожидание будет прервано, в секундах, при создании виртуальной машины.

Примеры

- name: Create a new droplet
  community.digitalocean.digital_ocean_droplet:
    state: present
    name: mydroplet
    oauth_token: XXX
    size: 2gb
    region: sfo1
    image: ubuntu-16-04-x64
    wait_timeout: 500
    ssh_keys: [ .... ]
  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
  community.digitalocean.digital_ocean_droplet:
    state: present
    id: 123
    name: mydroplet
    oauth_token: XXX
    size: 2gb
    region: sfo1
    image: ubuntu-16-04-x64
    wait_timeout: 500

- name: Ensure a droplet is present with SSH keys installed
  community.digitalocean.digital_ocean_droplet:
    state: present
    id: 123
    name: mydroplet
    oauth_token: XXX
    size: 2gb
    region: sfo1
    ssh_keys: ['1534404', '1784768']
    image: ubuntu-16-04-x64
    wait_timeout: 500

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
data словарь	changed	Виртуальная машина DigitalOcean Пример: {'droplet': {'backup_ids': [], 'created_at': '2014-11-14T16:36:31Z', 'disk': 20, 'features': ['virtio'], 'id': 3164494, 'image': {}, 'kernel': {'id': 2233, 'name': 'Ubuntu 14.04 x64 vmlinuz-3.13.0-37-generic', 'version': '3.13.0-37-generic'}, 'locked': True, 'memory': 512, 'name': 'example.com', 'networks': {}, 'region': {}, 'size': {}, 'size_slug': '512mb', 'snapshot_ids': [], 'status': 'new', 'tags': ['web'], 'vcpus': 1, 'volume_ids': []}, 'ip_address': '104.248.118.172', 'ipv6_address': '2604:a880:400:d1::90a:6001', 'private_ipv4_address': '10.136.122.141'}

Авторы

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.10/collections/community/digitalocean/digital_ocean_droplet_module.html