Модуль community.digitalocean.digital_ocean_domain — Создание/удаление домена DNS в DigitalOcean
Примечание
Этот модуль является частью коллекции community.digitalocean (версия 1.27.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.digitalocean. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробностей.
Чтобы использовать его в playbook, укажите: community.digitalocean.digital_ocean_domain.
Описание
- Создание/удаление домена DNS в DigitalOcean.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
Параметры
Параметр | Комментарии |
|---|---|
baseurl строка | Базовый URL API DigitalOcean. По умолчанию: |
id псевдонимы: droplet_id целое число | Идентификатор виртуальной машины (droplet), с которым нужно работать. |
ip псевдонимы: ip4, ipv4 строка | Запись типа 'A' для '@' ($ORIGIN) будет создана со значением 'ip'. 'ip' — адрес IPv4. |
ip6 псевдонимы: ipv6 строка | Запись типа 'AAAA' для '@' ($ORIGIN) будет создана со значением 'ip6'. 'ip6' — адрес IPv6. |
name строка | Имя виртуальной машины — должно соответствовать правилам именования хостов или имени SSH-ключа или домена. |
oauth_token псевдонимы: api_token строка | Токен OAuth DigitalOcean. Можно использовать несколько других переменных среды для задания этого значения. Например, - |
project_name псевдонимы: project строка | Проект, которому нужно назначить ресурс (имя проекта, а не UUID). По умолчанию используется проект по умолчанию для аккаунта (пустая строка). В настоящее время поддерживается только при создании доменов. По умолчанию: |
state строка | Указывает желаемое состояние целевого объекта. Варианты:
|
timeout целое число | Таймаут в секундах для опроса API DigitalOcean. По умолчанию: |
validate_certs логическое значение | Если установлено в Это следует установить только в Варианты:
|
Примечания
Примечание
- Переменные среды DO_OAUTH_TOKEN можно использовать для oauth_token.
- Начиная с Ansible 1.9.5 и 2.0, используется версия 2 API DigitalOcean. Это убирает опции
client_idиapi_keyв пользуoauth_token. - Если вы используете Ansible 1.9.4 или более раннюю версию, возможно, вы не сможете использовать включенную версию этого модуля, так как используемая версия API была прекращена.
Примеры
- name: Create a domain
community.digitalocean.digital_ocean_domain:
state: present
name: my.digitalocean.domain
ip: 127.0.0.1
- name: Create a domain (and associate to Project "test")
community.digitalocean.digital_ocean_domain:
state: present
name: my.digitalocean.domain
ip: 127.0.0.1
project: test
# Create a droplet and corresponding domain
- name: Create a droplet
community.digitalocean.digital_ocean:
state: present
name: test_droplet
size_id: 1gb
region_id: sgp1
image_id: ubuntu-14-04-x64
register: test_droplet
- name: Create a corresponding domain
community.digitalocean.digital_ocean_domain:
state: present
name: "{{ test_droplet.droplet.name }}.my.domain"
ip: "{{ test_droplet.droplet.ip_address }}"
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/digitalocean/digital_ocean_domain_module.html