theforeman.foreman.host_collection – Управление коллекциями хостов
Примечание
Этот плагин является частью коллекции theforeman.foreman (версия 1.5.1).
Для его установки используйте: ansible-galaxy collection install theforeman.foreman.
Для использования в плейбуке укажите: theforeman.foreman.host_collection.
Новое в версии 1.0.0: из theforeman.foreman
Обзор
- Создание и управление коллекциями хостов
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- requests
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| description строка | Описание коллекции хостов | |
| name строка / обязательно | Имя коллекции хостов | |
| organization строка / обязательно | Организация, к которой принадлежит сущность | |
| password строка / обязательно | Пароль пользователя, имеющего доступ к серверу Foreman. Если значение не указано в задаче, будет использовано значение переменной окружения FOREMAN_PASSWORD. | |
| server_url строка / обязательно | URL-адрес сервера Foreman. Если значение не указано в задаче, будет использовано значение переменной окружения FOREMAN_SERVER_URL. | |
| state строка |
| Состояние сущности |
| updated_name строка | Новое имя коллекции хостов. При установке этого параметра модуль не будет идемпотентным. | |
| username строка / обязательно | Имя пользователя, имеющего доступ к серверу Foreman. Если значение не указано в задаче, будет использовано значение переменной окружения FOREMAN_USERNAME. | |
| validate_certs булево |
| Требуется ли проверка сертификатов TLS сервера Foreman. Если значение не указано в задаче, будет использовано значение переменной окружения FOREMAN_VALIDATE_CERTS. |
Примеры
- name: "Create Foo host collection"
theforeman.foreman.host_collection:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
name: "Foo"
description: "Foo host collection for Foo servers"
organization: "My Cool new Organization"
state: present
Возвращаемые значения
Общие возвращаемые значения описаны в этом документе, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| entity словарь | успех | Конечное состояние затронутых сущностей, сгруппированных по их типу. | |
| host_collections список / элементы=словарь | успех | Список коллекций хостов. | |
Авторы
- Максим Бургауту (@wzzrd)
- Кристофер Рейер (@ephracis)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/theforeman/foreman/host_collection_module.html
