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

Примечание

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

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

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

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

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

Описание

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

Параметры

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

Атрибуты

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

Примечания

Примечание

Одновременная синхронизация Cobbler неизбежно приведет к ошибкам.
В Python 2.7.8 и более ранних версиях (например, в RHEL7) может потребоваться настроить поведение Python для отключения проверки сертификатов. Дополнительная информация на Странице о проверке сертификатов в стандартных клиентах HTTP Python.

Примеры

- 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 словарь	(Результирующая) информация о системе, с которой мы работаем Возвращается: когда `name` предоставляется
systems список / элементы=строка	Список систем Возвращается: `state=query` и `name` не предоставлены

Авторы

Dag Wieers (@dagwieers)

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

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