community.general.fqdn_valid test – Проверка полных доменных имён на соответствие RFC 1123

Примечание

Этот плагин для тестов входит в сборку community.general (версия 9.5.0).

Возможно, эта сборка уже установлена, если вы используете пакет 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 рабочей группы по инжинирингу Интернета.
Целью проектирования является проверка того, что строка традиционно приемлема в качестве общедоступного имени хоста в Интернете для программного обеспечения, соответствующего RFC, что является строгим подмножеством логики в современных веб-браузерах, таких как Mozilla Firefox и Chromium, которые определяют, следует ли выполнять поиск DNS.
Центры сертификации, такие как Let’s Encrypt, используют более узкий набор логики проверки строк для определения допустимости выпуска. Этот тест не призван обеспечить функциональное соответствие выпуску сертификатов CA.
Имена с одной меткой разрешены по умолчанию (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)

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

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

Авторы

Владимир Ботка (@vbotka)

Подсказка

Вхождения конфигурации для каждого типа записи имеют порядок приоритетов от низкого к высокому. Например, переменная, которая расположена ниже в списке, переопределит переменную, которая расположена выше.

Ссылки на сборку

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