Модуль community.general.cobbler_system — управление системными объектами в Cobbler

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

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

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

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

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

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

Добавляет, изменяет или удаляет системы в Cobbler.

Параметры

Параметр	Комментарии
host string	Имя или IP-адрес системы Cobbler. По умолчанию: `"127.0.0.1"`
interfaces dictionary	Список словарей с параметрами интерфейсов.
name string	Имя системы, которой нужно управлять.
password string	Пароль для входа в Cobbler.
port integer	Номер порта для REST-подключения. Значение по умолчанию зависит от параметра `use_ssl`.
properties dictionary	Словарь со свойствами системы.
state string	Должна ли система присутствовать, отсутствовать или нужно выполнить запрос. Варианты: `"absent"` `"present"` ← (по умолчанию) `"query"`
sync boolean	Синхронизировать при изменениях. Параллельная синхронизация Cobbler неизбежно приводит к ошибкам. Варианты: `false` ← (по умолчанию) `true`
use_ssl boolean	Если `false`, вместо HTTPS-подключения по умолчанию используется HTTP-подключение. Варианты: `false` `true` ← (по умолчанию)
username string	Имя пользователя для входа в Cobbler. По умолчанию: `"cobbler"`
validate_certs boolean	Если `false`, SSL-сертификаты не проверяются. Устанавливайте значение `false` только при использовании на контролируемых вами сайтах с самоподписанными сертификатами. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Модуль может работать в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой объект.
diff_mode	Поддержка: полная	В режиме diff возвращает сведения об изменениях (или возможных изменениях в `check_mode`).

Примечания

Примечание

Параллельная синхронизация Cobbler неизбежно приводит к странным ошибкам.

Примеры

- name: Ensure the system exists in Cobbler
  community.general.cobbler_system:
    host: cobbler01
    username: cobbler
    password: MySuperSecureP4sswOrd
    name: myhost
    properties:
      profile: CentOS6-x86_64
      name_servers: [2.3.4.5, 3.4.5.6]
      name_servers_search: foo.com, bar.com
    interfaces:
      eth0:
        macaddress: 00:01:02:03:04:05
        ipaddress: 1.2.3.4
  delegate_to: localhost

- name: Enable network boot in Cobbler
  community.general.cobbler_system:
    host: bdsol-aci-cobbler-01
    username: cobbler
    password: ins3965!
    name: bdsol-aci51-apic1.cisco.com
    properties:
      netboot_enabled: true
    state: present
  delegate_to: localhost

- name: Query all systems in Cobbler
  community.general.cobbler_system:
    host: cobbler01
    username: cobbler
    password: MySuperSecureP4sswOrd
    state: query
  register: cobbler_systems
  delegate_to: localhost

- name: Query a specific system in Cobbler
  community.general.cobbler_system:
    host: cobbler01
    username: cobbler
    password: MySuperSecureP4sswOrd
    name: '{{ inventory_hostname }}'
    state: query
  register: cobbler_properties
  delegate_to: localhost

- name: Ensure the system does not exist in Cobbler
  community.general.cobbler_system:
    host: cobbler01
    username: cobbler
    password: MySuperSecureP4sswOrd
    name: myhost
    state: absent
  delegate_to: localhost

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

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

Ключ	Описание
system dictionary	Сведения о системе, с которой выполняется работа (результат). Возвращается: если указан `name`
systems list / elements=string	Список систем. Возвращается: `state=query` и `name` не указаны

Авторы

Dag Wieers (@dagwieers)

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

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