Spec-Zone.ru › Ansible

Модуль 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.

По умолчанию: "https://api.digitalocean.com/v2"

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.

Можно использовать несколько других переменных среды для задания этого значения.

Например, - DO_API_TOKEN, DO_API_KEY, DO_OAUTH_TOKEN и OAUTH_TOKEN.

project_name

псевдонимы: project

строка

Проект, которому нужно назначить ресурс (имя проекта, а не UUID).

По умолчанию используется проект по умолчанию для аккаунта (пустая строка).

В настоящее время поддерживается только при создании доменов.

По умолчанию: ""

state

строка

Указывает желаемое состояние целевого объекта.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

timeout

целое число

Таймаут в секундах для опроса API DigitalOcean.

По умолчанию: 30

validate_certs

логическое значение

Если установлено в no, сертификаты SSL не будут проверены.

Это следует установить только в no при работе с самоподписанными сертификатами на сайтах, контролируемых лично.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Переменные среды 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 }}"

Авторы

  • Michael Gregson (@mgregson)

Ссылки на коллекцию

  • Система отслеживания задач
  • Репозиторий (исходные коды)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API