rax_dns_record - Управление записями DNS в Rackspace Cloud DNS

Новое в версии 1.5.

Описание
- Требования
Параметры
Примечания
Примеры
Статус
Техническое обслуживание
- Автор

Описание

Управление записями DNS в Rackspace Cloud DNS

Требования

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

pyrax
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key		Ключ API Rackspace, переопределяет credentials. псевдонимы: password
auth_endpoint (добавлен в 1.5)	По умолчанию: "https://identity.api.rackspacecloud.com/v2.0/"	URI службы аутентификации.
comment		Краткое описание домена. Максимальная длина 160 символов
credentials		Файл, в котором содержатся учетные данные Rackspace. Игнорируется, если указаны api_key и username. псевдонимы: creds_file
data обязательно		IP-адрес для записей A/AAAA, FQDN для CNAME/MX/NS или текстовые данные для SRV/TXT
domain		Имя домена, в котором нужно создать запись. Этот параметр недопустим, когда type=PTR
env (добавлен в 1.5)		Среда, как настроено в ~/.pyrax.cfg, см. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration.
identity_type (добавлен в 1.5)	По умолчанию: "rackspace"	Механизм аутентификации, например, rackspace или keystone.
loadbalancer (добавлен в 1.7)		ID балансировщика нагрузки для создания записи PTR. Используется только с type=PTR
name обязательно		FQDN имени записи для создания
overwrite (добавлен в 2.1)	По умолчанию: "yes"	Добавить новые записи, если данные не совпадают, вместо обновления существующей записи с совпадающим именем. Если уже есть несколько записей с совпадающим именем и overwrite=true, этот модуль завершится ошибкой.
priority		Необходим для записей MX и SRV, но запрещен для других типов записей. Если указан, должен быть целым числом от 0 до 65535.
region	По умолчанию: "DFW"	Регион для создания экземпляра.
server (добавлен в 1.7)		ID сервера для создания записи PTR. Используется только с type=PTR
state	Варианты: present ← absent	Укажите желаемое состояние ресурса
tenant_id (добавлен в 1.5)		Идентификатор клиента, используемый для аутентификации.
tenant_name (добавлен в 1.5)		Имя клиента, используемое для аутентификации.
ttl	По умолчанию: 3600	Время жизни записи в секундах
type обязательно	Варианты: A AAAA CNAME MX NS SRV TXT PTR	Тип записи DNS
username		Имя пользователя Rackspace, переопределяет credentials.
verify_ssl (добавлен в 1.5)		Требовать ли проверку SSL API-точек доступа.

Примечания

Примечание

Рекомендуется запускать игры, использующие этот модуль, с serial: 1 для предотвращения превышения лимита запросов API, накладываемого API Rackspace CloudDNS
Для управления записью PTR необходимо предоставить loadbalancer или server
Начиная с версии 1.7, поле type является обязательным и больше не имеет значения по умолчанию A записи.
Поддержка PTR записей была добавлена в версии 1.7
Можно использовать следующие переменные среды: RAX_USERNAME, RAX_API_KEY, RAX_CREDS_FILE, RAX_CREDENTIALS, RAX_REGION.
RAX_CREDENTIALS и RAX_CREDS_FILE указывают на файл учетных данных, соответствующий pyrax. См. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating
RAX_USERNAME и RAX_API_KEY исключают использование файла учетных данных
RAX_REGION определяет регион Rackspace Public Cloud (DFW, ORD, LON, …)
Можно использовать следующие переменные среды: RAX_USERNAME, RAX_API_KEY, RAX_CREDS_FILE, RAX_CREDENTIALS, RAX_REGION.
RAX_CREDENTIALS и RAX_CREDS_FILE указывают на файл учетных данных, соответствующий pyrax. См. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating
RAX_USERNAME и RAX_API_KEY исключают использование файла учетных данных
RAX_REGION определяет регион Rackspace Public Cloud (DFW, ORD, LON, …)

Примеры

- name: Create DNS Records
  hosts: all
  gather_facts: False
  tasks:
    - name: Create A record
      local_action:
        module: rax_dns_record
        credentials: ~/.raxpub
        domain: example.org
        name: www.example.org
        data: "{{ rax_accessipv4 }}"
        type: A
      register: a_record

    - name: Create PTR record
      local_action:
        module: rax_dns_record
        credentials: ~/.raxpub
        server: "{{ rax_id }}"
        name: "{{ inventory_hostname }}"
        region: DFW
      register: ptr_record

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Подробнее см. Поддержка и обслуживание модулей.

Список других модулей, которые также поддерживает сообщество Ansible, см. здесь.

Автор

Matt Martz (@sivel)

Подсказка

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/rax_dns_record_module.html