Модуль community.general.ipa_dnszone — управление зонами DNS FreeIPA

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать коллекцию в плейбуке, укажите: community.general.ipa_dnszone.

Краткое описание
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

Краткое описание

Добавление и удаление зон DNS IPA с помощью API IPA.

Параметры

Параметр	Комментарии
allowsyncptr логическое значение добавлено в community.general 4.3.0	Разрешить синхронизацию прямых и обратных записей в зоне. Варианты: `false` ← (по умолчанию) `true`
dynamicupdate логическое значение	Применить динамическое обновление к зоне. Варианты: `false` ← (по умолчанию) `true`
ipa_host строка	IP-адрес или имя хоста сервера IPA. Если значение не указано в задаче, вместо него используется значение переменной окружения `IPA_HOST`. Если переменная окружения `IPA_HOST` и значение не указаны в задаче, для обнаружения сервера FreeIPA выполняется поиск через DNS. Необходимая запись в FreeIPA — это запись `ipa-ca`. Если запись DNS, переменная окружения `IPA_HOST` и значение недоступны в задаче, используется значение по умолчанию. По умолчанию: `"ipa.example.com"`
ipa_pass строка	Пароль пользователя с правами администратора. Если значение не указано в задаче, вместо него используется значение переменной окружения `IPA_PASS`. Обратите внимание: если доступна библиотека `urllib_gssapi`, для аутентификации в FreeIPA можно использовать GSSAPI. Если доступна переменная окружения `KRB5CCNAME`, модуль использует указанный в ней кэш учётных данных Kerberos для аутентификации на сервере FreeIPA. Если доступна переменная окружения `KRB5_CLIENT_KTNAME`, а `KRB5CCNAME` — нет, модуль использует указанный в ней keytab Kerberos для аутентификации. Если GSSAPI недоступен, необходимо использовать `ipa_pass`.
ipa_port целое число	Порт сервера FreeIPA / IPA. Если значение не указано в задаче, вместо него используется значение переменной окружения `IPA_PORT`. Если переменная окружения `IPA_PORT` и значение не указаны в задаче, устанавливается значение по умолчанию. По умолчанию: `443`
ipa_prot строка	Протокол, используемый сервером IPA. Если значение не указано в задаче, вместо него используется значение переменной окружения `IPA_PROT`. Если переменная окружения `IPA_PROT` и значение не указаны в задаче, устанавливается значение по умолчанию. Варианты: `"http"` `"https"` ← (по умолчанию)
ipa_timeout целое число	Задает время ожидания простоя соединения (в секундах). Для массовых операций может потребоваться увеличить это значение, чтобы избежать тайм-аута со стороны сервера IPA. Если значение не указано в задаче, вместо него используется значение переменной окружения `IPA_TIMEOUT`. Если переменная окружения `IPA_TIMEOUT` и значение не указаны в задаче, устанавливается значение по умолчанию. По умолчанию: `10`
ipa_user строка	Учётная запись администратора, используемая на сервере IPA. Если значение не указано в задаче, вместо него используется значение переменной окружения `IPA_USER`. Если переменная окружения `IPA_USER` и значение не указаны в задаче, устанавливается значение по умолчанию. По умолчанию: `"admin"`
state строка	Требуемое состояние. Варианты: `"absent"` `"present"` ← (по умолчанию)
validate_certs логическое значение	Применяется только если `ipa_prot` равно `https`. Если установлено значение `false`, сертификаты SSL не проверяются. Устанавливайте значение `false` только для сайтов под личным контролем, использующих самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)
zone_name строка / обязательный	Имя зоны DNS, которой необходимо управлять.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой объект.
diff_mode	Поддержка: отсутствует	В режиме diff возвращает сведения об изменениях (или о том, что, возможно, нужно изменить в `check_mode`).

Примечания

Примечание

Этот модуль использует JSON-RPC поверх HTTP(S) для связи с сервером FreeIPA. Если необходимо включить управляемый узел в область FreeIPA, рассмотрите возможность использования коллекции freeipa.ansible_freeipa, однако для управления развертыванием требуется доступ к оболочке одного из узлов области.

Примеры

- name: Ensure dns zone is present
  community.general.ipa_dnszone:
    ipa_host: spider.example.com
    ipa_pass: Passw0rd!
    state: present
    zone_name: example.com

- name: Ensure dns zone is present and is dynamic update
  community.general.ipa_dnszone:
    ipa_host: spider.example.com
    ipa_pass: Passw0rd!
    state: present
    zone_name: example.com
    dynamicupdate: true

- name: Ensure that dns zone is removed
  community.general.ipa_dnszone:
    zone_name: example.com
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: topsecret
    state: absent

- name: Ensure dns zone is present and is allowing sync
  community.general.ipa_dnszone:
    ipa_host: spider.example.com
    ipa_pass: Passw0rd!
    state: present
    zone_name: example.com
    allowsyncptr: true

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ	Описание
zone словарь	Зона DNS в виде, возвращаемом API IPA. Возвращается: всегда

Авторы

Fran Fitzpatrick (@fxfitz)

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

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/ipa_dnszone_module.html