Модуль theforeman.foreman.image – Управление образами

Примечание

Этот модуль является частью коллекции theforeman.foreman (версия 4.2.0).

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

Для установки используйте: ansible-galaxy collection install theforeman.foreman. Вам потребуются дополнительные требования для использования этого модуля, см. Требования для подробностей.

Для использования в playbook, укажите: theforeman.foreman.image.

Новое в theforeman.foreman 1.0.0

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

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

Создание, обновление и удаление образов

Псевдонимы: foreman_image

Требования

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

requests

Параметры

Параметр	Комментарии
architecture string / required	Архитектура образа
compute_resource string / required	Вычислительный ресурс, которому назначен образ
image_password string	Пароль, используемый для входа в операционную систему
image_username string / required	Имя пользователя, используемое для входа в операционную систему
name string / required	Имя образа
operatingsystem string / required	Операционные системы находятся по их названию, которое составлено как “<name> <major>.<minor>”. Вы можете опустить часть с версией, если у вас есть только одна операционная система с таким именем.
password string / required	Пароль пользователя, обращающегося к серверу Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `FOREMAN_PASSWORD`.
server_url string / required	URL сервера Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `FOREMAN_SERVER_URL`.
state string	Состояние объекта Варианты: `"present"` ← (по умолчанию) `"absent"`
user_data boolean	Образ поддерживает user_data Варианты: `false` `true`
username string / required	Имя пользователя, обращающегося к серверу Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `FOREMAN_USERNAME`.
uuid aliases: image_uuid string / required	UUID или Marketplace URN образа операционной системы
validate_certs boolean	Проверять ли TLS-сертификаты сервера Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `FOREMAN_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

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

Примеры

- name: create Image for EC2
  theforeman.foreman.image:
     name: CentOS
     image_uuid: "ami-0ff760d16d9497662"
     image_username: "centos"
     operatingsystem: "CentOS 7"
     compute_resource: "AWS"
     architecture: "x86_64"

Значения возврата

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

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

Авторы

Mark Hlawatschek (@hlawatschek) ATIX AG

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

© 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/theforeman/foreman/image_module.html