Модуль community.general.atomic_container — Управление контейнерами на платформе atomic host

Примечание

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

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

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

Для использования в playbook укажите: community.general.atomic_container.

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

Описание

Управление контейнерами на платформе atomic host.
Позволяет управлять жизненным циклом контейнера на платформе atomic host.

Требования

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

atomic

Параметры

Параметр	Комментарии
backend строка / обязательно	Определяет бэкэнд для использования контейнера. Варианты: `"docker"` `"ostree"`
image строка / обязательно	Используемый образ для установки контейнера.
mode строка	Определяет, является ли контейнер пользовательским или системным. Варианты: `"user"` `"system"`
name строка / обязательно	Имя контейнера.
rootfs строка	Определяет rootfs образа.
state строка	Состояние контейнера. Варианты: `"absent"` `"latest"` ← (по умолчанию) `"present"` `"rollback"`
values список / элементы=строка	Значения для установки контейнера. Этот параметр разрешён только для режимов 'user' или 'system'. Указанные здесь значения будут использоваться при установке в качестве аргументов –set для atomic install. По умолчанию: `[]`

Атрибуты

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

Примечания

Примечание

Хост должен поддерживать команду atomic

Примеры

- name: Install the etcd system container
  community.general.atomic_container:
    name: etcd
    image: rhel/etcd
    backend: ostree
    state: latest
    mode: system
    values:
        - ETCD_NAME=etcd.server

- name: Uninstall the etcd system container
  community.general.atomic_container:
    name: etcd
    image: rhel/etcd
    backend: ostree
    state: absent
    mode: system

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

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

Ключ	Описание
msg строка	Стандартный вывод команды Возвращается: всегда Пример: `"Using default tag: latest ..."`

Авторы

Giuseppe Scrivano (@giuseppe)

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

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