digital_ocean – Создание/удаление капли/ключа SSH в DigitalOcean

УСТЕРЕКШЕЕ
Описание
Требования
Параметры
Примечания
Примеры
Статус

УСТЕРЕКШЕЕ

Удалено в Ansible:
	версия: 2.12
Почему:	Модуль обновлён для удаления внешней зависимости с увеличенной функциональностью.
Альтернатива:	Используйте digital_ocean_droplet вместо этого.

Описание

Создание/удаление капли в DigitalOcean и, необязательно, ожидание её перехода в состояние ‘running’, или развертывание ключа SSH.

Требования

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

python >= 2.6
dopy

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_token -		Токен API DigitalOcean.
backups_enabled boolean	Варианты: нет ← да	Необязательный, булевый, включает резервное копирование для вашей капли.
command -	Варианты: droplet ← ssh	Какой объект вы хотите обработать.
id -		Числовое значение, идентификатор капли, которую вы хотите обработать. псевдонимы: droplet_id
image_id -		Это тег изображения, которое вы хотите использовать для создания капли.
ipv6 boolean добавлено в 2.2	Варианты: нет ← да	Необязательный, булевый, включить IPv6 для вашей капли.
name -		Строка, это имя капли — должно быть отформатировано согласно правилам для имени хоста или именем ключа SSH.
private_networking boolean	Варианты: нет ← да	Булево, добавить дополнительный, частный сетевой интерфейс к капле для межсетевого взаимодействия.
region_id -		Это тег региона, в котором вы хотите создать сервер.
size_id -		Это тег размера, который вы хотите использовать для создания капли.
ssh_key_ids -		Необязательный, массив идентификаторов ключей SSH (числовые), которые вы хотите добавить к серверу.
ssh_pub_key -		Открытый ключ SSH, который вы хотите добавить к своей учётной записи.
state -	Варианты: present ← активный отсутствует удалён	Указывает желаемое состояние объекта.
unique_name boolean	Варианты: нет ← да	Булево, требование уникальных имён хостов. По умолчанию DigitalOcean позволяет несколько хостов с одинаковым именем. Установка этого параметра в "да" позволяет только одному хосту на имя. Полезно для идемпотентности.
user_data - добавлено в 2.0		непонятный фрагмент данных, доступный капле
virtio boolean	Варианты: нет да ←	Булево, включить драйвер virtio в капле для улучшения сетевого и дискового ввода-вывода.
wait boolean	Варианты: нет да ←	Ожидание, пока капля перейдёт в состояние 'running' перед возвратом. Если wait = "нет", адрес IP может не быть возвращён.
wait_timeout -	Значение по умолчанию: 300	Сколько времени ожидания истечёт, в секундах.

Примечания

Примечание

Можно использовать две переменные окружения: DO_API_KEY и DO_API_TOKEN. Обе они относятся к токену v2.
Начиная с Ansible 1.9.5 и 2.0, используется версия 2 API DigitalOcean, это убирает client_id и api_key варианты в пользу api_token.
Если вы используете Ansible 1.9.4 или более раннюю версию, у вас может возникнуть проблема с использованием включённой версии этого модуля, так как используемая версия API была удалена. Обновите Ansible или, если не можете, попробуйте загрузить последнюю версию этого модуля с github и поместите его в каталог ‘library’.

Примеры

# Ensure a SSH key is present
# If a key matches this name, will return the ssh key id and changed = False
# If no existing key matches this name, a new key is created, the ssh key id is returned and changed = False

- digital_ocean:
    state: present
    command: ssh
    name: my_ssh_key
    ssh_pub_key: 'ssh-rsa AAAA...'
    api_token: XXX

# Create a new Droplet
# Will return the droplet details including the droplet id (used for idempotence)

- digital_ocean:
    state: present
    command: droplet
    name: mydroplet
    api_token: XXX
    size_id: 2gb
    region_id: ams2
    image_id: fedora-19-x64
    wait_timeout: 500
  register: my_droplet

- debug:
    msg: "ID is {{ my_droplet.droplet.id }}"

- debug:
    msg: "IP is {{ my_droplet.droplet.ip_address }}"

# Ensure a droplet is present
# If droplet id already exist, will return the droplet details and changed = False
# If no droplet matches the id, a new droplet will be created and the droplet details (including the new id) are returned, changed = True.

- digital_ocean:
    state: present
    command: droplet
    id: 123
    name: mydroplet
    api_token: XXX
    size_id: 2gb
    region_id: ams2
    image_id: fedora-19-x64
    wait_timeout: 500

# Create a droplet with ssh key
# The ssh key id can be passed as argument at the creation of a droplet (see ssh_key_ids).
# Several keys can be added to ssh_key_ids as id1,id2,id3
# The keys are used to connect as root to the droplet.

- digital_ocean:
    state: present
    ssh_key_ids: 123,456
    name: mydroplet
    api_token: XXX
    size_id: 2gb
    region_id: ams2
    image_id: fedora-19-x64

Статус

Этот модуль будет удалён в версии 2.12. [устаревший]
Дополнительную информацию можно найти в УСТЕРЕКШЕЕ.

Авторы

Vincent Viallet (@zbal)

Подсказка

Если вы заметили какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 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_module.html