Модуль theforeman.foreman.discovery_rule – Управление правилами обнаружения узлов

Примечание

Этот модуль является частью коллекции theforeman.foreman (версия 4.2.0).

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

Для установки используйте: ansible-galaxy collection install theforeman.foreman. Для использования этого модуля требуются дополнительные компоненты, см. Требования для получения подробной информации.

Для использования в playbook, укажите: theforeman.foreman.discovery_rule.

Новое в theforeman.foreman 3.5.0

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

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

Управление правилами обнаружения узлов

Требования

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

requests

Параметры

Параметр	Комментарии
enabled boolean	Включить или отключить правило Варианты: `false` `true`
hostgroup string	Группа узлов для назначения узлов Обязательно, если state=present
hostname string	Имя узла для назначения обнаруженным узлам При сопоставлении нескольких узлов необходимо указать уникальные имена узлов для каждого из обнаруженных узлов
locations list / elements=string	Список местоположений, которым должен быть назначен объект
max_count integer	Максимальное количество узлов, которые можно подготовить с помощью правила 0 означает неограниченное количество
name string / required	Имя правила обнаружения
organizations list / elements=string	Список организаций, которым должен быть назначен объект
password string / required	Пароль пользователя, обращающегося к серверу Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `FOREMAN_PASSWORD`.
priority integer	Приоритет правила
search string	Выражение для сопоставления с вновь обнаруженными узлами Обязательно, если state=present
server_url string / required	URL сервера Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `FOREMAN_SERVER_URL`.
state string	Состояние объекта Варианты: `"present"` ← (по умолчанию) `"absent"`
username string / required	Имя пользователя, обращающегося к серверу Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `FOREMAN_USERNAME`.
validate_certs boolean	Проверять ли TLS-сертификаты сервера Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `FOREMAN_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

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

Примеры

- name: 'Ensure Discovery Rule'
  theforeman.foreman.discovery_rule:
    username: 'admin'
    password: 'secret_password'
    server_url: 'https://foreman.example.com'
    name: 'my-first-disco'
    search: 'mac = bb:bb:bb:bb:bb:bb'
    hostgroup: 'RedHat7-Base'
    hostname: 'servera'
    max_count: 1
    organizations:
      - 'MyOrg'
    locations:
      - 'DC1'

- name: 'Remove Discovery Rule'
  theforeman.foreman.discovery_rule:
    username: 'admin'
    password: 'secret_password'
    server_url: 'https://foreman.example.com'
    name: 'my-first-disco'
    state: 'absent'

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

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

Ключ	Описание
entity dictionary	Конечное состояние затронутых сущностей, сгруппированных по типу. Возвращено: success
discovery_rules list / elements=dictionary	Список правил обнаружения. Возвращено: success

Авторы

Jeffrey van Pelt (@Thulium-Drake)

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

© 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/theforeman/foreman/discovery_rule_module.html