theforeman.foreman.operatingsystem – Управление операционными системами

Примечание

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

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

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

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

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

Обзор

Управление операционными системами

Требования

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

requests

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
architectures список / элементы=строка			архитектуры, на которых можно установить операционную систему
description строка			Описание операционной системы
major строка			главная версия операционной системы
media список / элементы=строка			список установочных носителей
minor строка			второстепенная версия операционной системы
name строка / обязательно			Имя операционной системы
os_family строка		Варианты: AIX Altlinux Archlinux Coreos Debian Freebsd Gentoo Junos NXOS Rancheros Redhat Solaris Suse Windows Xenserver	Семейство дистрибутива операционной системы псевдонимы: family
parameters список / элементы=словарь			Параметры хоста, специфичные для операционной системы
	name строка / обязательно		Имя параметра
	parameter_type строка	Варианты: строка ← boolean integer real array hash yaml json	Тип параметра
	value raw / обязательно		Значение параметра
password строка / обязательно			Пароль пользователя, имеющего доступ к серверу Foreman. Если значение не указано в задаче, будет использовано значение переменной окружения `FOREMAN_PASSWORD`
password_hash строка		Варианты: MD5 SHA256 SHA512 Base64 Base64-Windows	алгоритм хеширования для passwd
provisioning_templates список / элементы=строка			Список шаблонов настройки, связанных с операционной системой. Укажите полный список имен шаблонов, которые вы хотите связать с вашей ОС. Например ["Kickstart default", "Kickstart default finish", "Kickstart default iPXE", "custom"]. После указания ассоциаций шаблонов вы можете установить стандартную ассоциацию в модуле theforeman.foreman.os_default_template.
ptables список / элементы=строка			список таблиц разбиения
release_name строка			Имя релиза операционной системы (рекомендуется для debian)
server_url строка / обязательно			URL сервера Foreman. Если значение не указано в задаче, будет использовано значение переменной окружения `FOREMAN_SERVER_URL`
state строка		Варианты: present ← present_with_defaults absent	Состояние сущности `present_with_defaults` гарантирует существование сущности, но не будет обновлять существующие
updated_name строка			Новое имя операционной системы. При установке этого параметра модуль не будет идемпотентным.
username строка / обязательно			Имя пользователя, имеющего доступ к серверу Foreman. Если значение не указано в задаче, будет использовано значение переменной окружения `FOREMAN_USERNAME`
validate_certs boolean		Варианты: no yes ←	Нужно ли проверять сертификаты TLS сервера Foreman. Если значение не указано в задаче, будет использовано значение переменной окружения `FOREMAN_VALIDATE_CERTS`

Примеры

- name: "Create an Operating System"
  theforeman.foreman.operatingsystem:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: Debian
    release_name: stretch
    family: Debian
    major: 9
    parameters:
      - name: additional-packages
        value: python vim
    state: present

- name: "Ensure existence of an Operating System (provide default values)"
  theforeman.foreman.operatingsystem:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: Centos
    family: Redhat
    major: 7
    password_hash: SHA256
    state: present_with_defaults

- name: "Delete an Operating System"
  theforeman.foreman.operatingsystem:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: Debian
    family: Debian
    major: 9
    state: absent

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

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

Ключ		Возвращаемое значение	Описание
entity словарь		успешно	Конечное состояние затронутых сущностей, сгруппированных по их типу.
	operatinsystems список / элементы=словарь	успешно	Список operatinsystems.

Авторы

Matthias M Dellweg (@mdellweg) ATIX AG
Bernhard Hopfenmüller (@Fobhep) ATIX AG

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