theforeman.foreman.hostgroup – Управление группами хостов

Примечание

Этот плагин входит в состав коллекции theforeman.foreman (версия 1.5.1).

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

Для использования в книге задач укажите: theforeman.foreman.hostgroup.

Новое в версии 1.0.0: of theforeman.foreman

Обзор
Требования
Параметры
Примеры
Возвращаемые значения

Обзор

Создание, обновление и удаление групп хостов

Требования

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

requests

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
architecture string			Имя архитектуры
compute_profile string			Имя профиля вычислений
compute_resource string			Имя вычислительного ресурса
config_groups list / elements=string			Список групп конфигурации
content_source string			Источник контента. Доступен только для установок Katello.
content_view string			Представление контента. Доступен только для установок Katello.
description string			Описание группы хостов
domain string			Имя домена
environment string			Имя среды Puppet
kickstart_repository string			Имя репозитория Kickstart. Необходимо для использования функции «Синхронизированный контент». Взаимоисключающее с параметром medium. Доступен только для установок Katello.
lifecycle_environment string			Среда жизненного цикла. Доступен только для установок Katello.
locations list / elements=string			Список расположений, к которым должна быть назначена сущность
medium string			Имя носителя Взаимоисключающее с параметром kickstart_repository. псевдонимы: media
name string / required			Имя группы хостов
openscap_proxy string			Имя прокси OpenSCAP. Доступно при установке плагина OpenSCAP.
operatingsystem string			Операционные системы ищутся по их названию, которое состоит из <имя> <главная>.<дополнительная>. Можно опустить часть версии, если у вас только одна операционная система с таким именем.
organization string			Организация для ресурсов с ограниченным доступом, прикрепленных к группе хостов. Используется только для установок Katello. Эта организация будет неявно добавлена к параметру organizations, если это необходимо.
organizations list / elements=string			Список организаций, к которым должна быть назначена сущность
parameters list / elements=dictionary			Параметры хоста, специфичные для группы хостов
	name string / required		Имя параметра
	parameter_type string	Варианты: string ← boolean integer real array hash yaml json	Тип параметра
	value raw / required		Значение параметра
parent string			Имя родительской группы хостов
password string / required			Пароль пользователя, который получает доступ к серверу Foreman. Если значение не указано в задаче, используется значение переменной среды `FOREMAN_PASSWORD`.
ptable string			Имя таблицы разделов
puppet_ca_proxy string			Имя прокси Puppet CA
puppet_proxy string			Имя прокси-сервера Puppet
puppetclasses list / elements=string			Список классов Puppet, которые следует включить в эту группу хостов. Должен существовать для среды Puppet группы хостов.
pxe_loader string		Варианты: PXELinux BIOS PXELinux UEFI Grub UEFI Grub2 BIOS Grub2 ELF Grub2 UEFI Grub2 UEFI SecureBoot Grub2 UEFI HTTP Grub2 UEFI HTTPS Grub2 UEFI HTTPS SecureBoot iPXE Embedded iPXE UEFI HTTP iPXE Chain BIOS iPXE Chain UEFI None	Загрузчик PXE
realm string			Имя домена
root_pass string			Пароль root. Приведет к обновлению сущности всегда, так как текущий пароль получить нельзя.
server_url string / required			URL сервера Foreman. Если значение не указано в задаче, используется значение переменной среды `FOREMAN_SERVER_URL`.
state string		Варианты: present ← absent	Состояние сущности
subnet string			Имя подсети IPv4
subnet6 string			Имя подсети IPv6
updated_name string			Новое имя группы хостов. При установке этого параметра модуль не будет идемпотентным.
username string / required			Имя пользователя, который получает доступ к серверу Foreman. Если значение не указано в задаче, используется значение переменной среды `FOREMAN_USERNAME`.
validate_certs boolean		Варианты: no yes ←	Подтверждать ли сертификаты TLS сервера Foreman. Если значение не указано в задаче, используется значение переменной среды `FOREMAN_VALIDATE_CERTS`.

Примеры

- name: "Create a Hostgroup"
  theforeman.foreman.hostgroup:
    name: "new_hostgroup"
    architecture: "architecture_name"
    operatingsystem: "operatingsystem_name"
    medium: "media_name"
    ptable: "Partition_table_name"
    server_url: "https://foreman.example.com"
    username: "admin"
    password: "changeme"
    state: present

- name: "Update a Hostgroup"
  theforeman.foreman.hostgroup:
    name: "new_hostgroup"
    architecture: "updated_architecture_name"
    operatingsystem: "updated_operatingsystem_name"
    organizations:
      - Org One
      - Org Two
    locations:
      - Loc One
      - Loc Two
      - Loc One/Nested loc
    medium: "updated_media_name"
    ptable: "updated_Partition_table_name"
    root_pass: "password"
    server_url: "https://foreman.example.com"
    username: "admin"
    password: "changeme"
    state: present

- name: "My nested hostgroup"
  theforeman.foreman.hostgroup:
    parent: "new_hostgroup"
    name: "my nested hostgroup"

- name: "My hostgroup with some proxies"
  theforeman.foreman.hostgroup:
    name: "my hostgroup"
    environment: production
    puppet_proxy: puppet-proxy.example.com
    puppet_ca_proxy: puppet-proxy.example.com
    openscap_proxy: openscap-proxy.example.com

- name: "My katello related hostgroup"
  theforeman.foreman.hostgroup:
    organization: "My Org"
    name: "kt hostgroup"
    content_source: capsule.example.com
    lifecycle_environment: "Production"
    content_view: "My content view"
    parameters:
      - name: "kt_activation_keys"
        value: "my_prod_ak"

- name: "Delete a Hostgroup"
  theforeman.foreman.hostgroup:
    name: "new_hostgroup"
    server_url: "https://foreman.example.com"
    username: "admin"
    password: "changeme"
    state: absent

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

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

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

Авторы

Manisha Singhal (@Manisha15) ATIX AG
Baptiste Agasse (@bagasse)

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