dnsmadeeasy - Взаимодействие с dnsmadeeasy.com (услуга хостинга DNS).
Новая версия с 1.3.
Обзор
- Управляет записями DNS через REST API v2 сервиса DNS Made Easy. Обрабатывает только записи; манипуляции с доменами или поддержкой мониторинга/аккаунта пока отсутствуют. См.: https://www.dnsmadeeasy.com/integration/restapi/
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- hashlib
- hmac
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| account_key обязательно | По умолчанию: Нет | Ключ API учетной записи. |
| account_secret обязательно | По умолчанию: Нет | Секретный ключ учетной записи. |
| autoFailover обязательно (добавлен в 2.4) |
| Если true, отключение к первичному IP-адресу выполняется вручную после сбоя. Если false, отключение к первичному IP-адресу выполняется автоматически после сбоя. |
| contactList обязательно (добавлен в 2.4) | По умолчанию: | Имя или идентификатор списка контактов, которым будет отправляться уведомление о мониторинге. Значение по умолчанию '' означает владельца учетной записи. |
| domain обязательно | По умолчанию: Нет | Домен для работы. Может быть именем домена (например, "mydomain.com") или числовым идентификатором домена в DNS Made Easy (например, "839989") для более быстрого разрешения. |
| failover обязательно (добавлен в 2.4) |
| Если yes, добавить или изменить резервирование. Это применимо только для записей A. |
| httpFile (добавлен в 2.4) | Файл по Fqdn, который монитор запрашивает для HTTP или HTTPS. | |
| httpFqdn (добавлен в 2.4) | Полное доменное имя, используемое монитором. | |
| httpQueryString (добавлен в 2.4) | Строка в httpFile, которую монитор запрашивает для HTTP или HTTPS. | |
| ip1 (добавлен в 2.4) | Основной IP-адрес для резервирования. Требуется при добавлении или изменении монитора или резервирования. | |
| ip2 (добавлен в 2.4) | Дополнительный IP-адрес для резервирования. Требуется при добавлении или изменении резервирования. | |
| ip3 (добавлен в 2.4) | Третичный IP-адрес для резервирования. | |
| ip4 (добавлен в 2.4) | Четвертичный IP-адрес для резервирования. | |
| ip5 (добавлен в 2.4) | Пятеричный IP-адрес для резервирования. | |
| maxEmails обязательно (добавлен в 2.4) | По умолчанию: 1 | Количество электронных писем, отправляемых списку контактов монитором. |
| monitor обязательно (добавлен в 2.4) |
| Если yes, добавить или изменить монитор. Это применимо только для записей A. |
| port обязательно (добавлен в 2.4) | По умолчанию: 80 | Порт, используемый монитором. |
| protocol обязательно (добавлен в 2.4) |
| Протокол, используемый монитором. |
| record_name | По умолчанию: Нет | Имя записи для получения/создания/удаления/обновления. Если record_name не указан, все записи для домена будут возвращены в "результате" независимо от аргумента состояния. |
| record_ttl | По умолчанию: 1800 | Время жизни записи. Количество секунд, в течение которого запись хранится в кэше DNS-серверов. |
| Тип_записи |
Нет | Тип записи. |
| Значение_записи | По умолчанию: Нет | Значение записи. HTTPRED: <URL перенаправления>, MX: <приоритет> <имя назначения>, NS: <сервер имен>, PTR: <имя назначения>, SRV: <приоритет> <вес> <порт> <имя назначения>, TXT: <текстовое значение>" Если значение_записи не указано, изменения не будут внесены, и запись будет возвращена в «результат» (другими словами, этот модуль может использоваться для получения текущего идентификатора, типа и TTL записи). |
| Чувствительность обязательно (добавлен в 2.4) |
| Количество проверок, выполняемых монитором, прежде чем произойдет переход на резервное копирование, где Низкая = 8, Средняя = 5, и Высокая = 3. |
| Состояние обязательно |
Нет | указывает, должно ли существовать запись или нет |
| Описание_системы обязательно (добавлен в 2.4) | По умолчанию: | Описание, используемое монитором. |
| проверить_сертификаты (добавлен в 1.5.1) |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, использующих самозаверяемые сертификаты. |
Примечания
Примечание
- Сервис DNS Made Easy требует, чтобы машины, взаимодействующие с API, имели правильно установленное время и часовой пояс. Убедитесь, что вы находитесь в пределах нескольких секунд от фактического времени, используя NTP.
- Этот модуль возвращает запись(и) и монитор(ы) в элементе «результат», когда «состояние» установлено в «наличие». Эти значения могут быть зарегистрированы и использованы в ваших сценариях.
- Только записи типа A могут иметь монитор или резервное копирование.
- Для добавления резервного копирования требуются параметры «резервное_копирование», «автоматическое_резервное_копирование», «порт», «протокол», «ip1» и «ip2».
- Для добавления монитора требуются параметры «монитор», «порт», «протокол», «макс_почта», «описание_системы» и «ip1».
- Монитор и резервное копирование будут совместно использовать параметры «порт», «протокол» и «ip1».
Примеры
# fetch my.com domain records
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
register: response
# create / ensure the presence of a record
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
# update the previously created record
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_value: 192.0.2.23
# fetch a specific record
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
register: response
# delete a record / ensure it is absent
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: absent
record_name: test
# Add a failover
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
failover: True
ip1: 127.0.0.2
ip2: 127.0.0.3
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
failover: True
ip1: 127.0.0.2
ip2: 127.0.0.3
ip3: 127.0.0.4
ip4: 127.0.0.5
ip5: 127.0.0.6
# Add a monitor
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
monitor: yes
ip1: 127.0.0.2
protocol: HTTP # default
port: 80 # default
maxEmails: 1
systemDescription: Monitor Test A record
contactList: my contact list
# Add a monitor with http options
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
monitor: yes
ip1: 127.0.0.2
protocol: HTTP # default
port: 80 # default
maxEmails: 1
systemDescription: Monitor Test A record
contactList: 1174 # contact list id
httpFqdn: http://my.com
httpFile: example
httpQueryString: some string
# Add a monitor and a failover
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
failover: True
ip1: 127.0.0.2
ip2: 127.0.0.3
monitor: yes
protocol: HTTPS
port: 443
maxEmails: 1
systemDescription: monitoring my.com status
contactList: emergencycontacts
# Remove a failover
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
failover: no
# Remove a monitor
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
monitor: no
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- Брис Берджесс (@briceburg)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/dnsmadeeasy_module.html