Тест community.general.fqdn_valid — проверяет полные доменные имена на соответствие RFC 1123

Примечание

Этот тестовый плагин входит в коллекцию community.general (версия 12.6.1).

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

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого тестового плагина могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

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

Добавлено в community.general 8.1.0

Краткое описание
Требования
Входные данные
Параметры-ключевые слова
Примеры
Возвращаемое значение

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

Этот тест проверяет полные доменные имена (FQDN) на соответствие спецификациям RFC 1123 и RFC 952, разработанным Инженерным советом Интернета (IETF).
Цель теста — проверить, будет ли строка традиционно считаться допустимым общедоступным интернет-именем хоста программным обеспечением, соответствующим RFC. Это лишь подмножество логики современных веб-браузеров, таких как Mozilla Firefox и Chromium, определяющей, следует ли выполнять поиск в DNS.
Центры сертификации, такие как Let’s Encrypt, используют более узкий набор правил проверки строк, чтобы определить, можно ли выдать сертификат. Этот тест не предназначен для полного соответствия процессу выдачи сертификатов ЦС.
По умолчанию разрешены имена из одной метки (min_labels=1).

Требования

Следующие требования необходимы на локальном управляющем узле, на котором выполняется этот тест.

fqdn>=1.5.1 (PyPI)

Входные данные

Здесь описаны входные данные теста — значение перед is community.general.fqdn_valid или is not community.general.fqdn_valid.

Параметр	Комментарии
Входные данные строка / обязательный	Имя хоста.

Параметры-ключевые слова

Здесь описаны параметры-ключевые слова теста. В следующих примерах это значения key1=value1, key2=value2 и т. д.: input is community.general.fqdn_valid(key1=value1, key2=value2, ...) и input is not community.general.fqdn_valid(key1=value1, key2=value2, ...)

Параметр	Комментарии
allow_underscores логическое значение	Разрешить символы подчёркивания. Варианты: `false` ← (по умолчанию) `true`
min_labels целое число	Минимальное требуемое количество меток, разделённых точками. По умолчанию: `1`

Примеры

- name: Make sure that hostname is valid
  ansible.builtin.assert:
    that: hostname is community.general.fqdn_valid

- name: Make sure that hostname is at least 3 labels long (a.b.c)
  ansible.builtin.assert:
    that: hostname is community.general.fqdn_valid(min_labels=3)

- name: Make sure that hostname is at least 2 labels long (a.b). Allow '_'
  ansible.builtin.assert:
    that: hostname is community.general.fqdn_valid(min_labels=2, allow_underscores=True)

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

Ключ	Описание
Возвращаемое значение логическое значение	Указывает, является ли имя допустимым. Возвращается: при успешном выполнении

Авторы

Vladimir Botka (@vbotka)

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

© 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/fqdn_valid_test.html