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

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

Обзор
Требования (к хосту, на котором выполняется модуль)
Параметры
Примеры
Примечания
- Статус

Обзор

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

Требования (к хосту, на котором выполняется модуль)

python >= 2.6
pyrax

Параметры

параметр	обязательно	по умолчанию	возможные значения	комментарии
api_key	нет			Ключ API Rackspace, переопределяет credentials. псевдонимы: password
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.
loadbalancer (добавлен в 1.7)	нет			ID балансировщика нагрузки для создания записи PTR. Используется только с type=PTR
name	да			FQDN имени записи для создания
overwrite (добавлен в 2.1)	нет	True		Добавить новые записи, если данные не совпадают, вместо обновления существующей записи с совпадающим именем. Если уже существует несколько записей с совпадающим именем и overwrite=true, этот модуль завершится ошибкой.
priority	нет			Требуется для записей MX и SRV, но запрещено для других типов записей. Если указано, должно быть целым числом от 0 до 65535.
region	нет	DFW		Регион для создания экземпляра.
server (добавлен в 1.7)	нет			ID сервера для создания записи PTR. Используется только с type=PTR
state	нет	present	present absent	Укажите желаемое состояние ресурса
ttl	нет	3600		Время жизни записи в секундах
type	да		A AAAA CNAME MX NS SRV TXT PTR	Тип записи DNS
username	нет			Имя пользователя Rackspace, переопределяет credentials.
verify_ssl (добавлен в 1.5)	нет			Требовать или нет проверку SSL API-точек доступа.

Примеры

- 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

Примечания

Примечание

Рекомендуется, чтобы игры, использующие этот модуль, выполнялись с 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, ...)

Статус

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

Для получения помощи в разработке модулей, если вы захотите, пожалуйста, ознакомьтесь с Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.

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