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	По умолчанию: "да"	Добавить новые записи, если данные не совпадают, вместо обновления существующей записи с совпадающим именем. Если уже существует несколько записей с совпадающим именем и 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. [сообщество]

Авторы

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.7/modules/rax_dns_record_module.html