community.general.atomic_image модуль — Управление образами контейнеров на платформе atomic хоста

Примечание

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

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

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

Для использования в книге задач укажите: community.general.atomic_image.

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

Описание

Управление образами контейнеров на платформе хоста atomic.
Позволяет выполнить команды, заданные меткой RUN в образе контейнера, если она присутствует.

Требования

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

atomic

Параметры

Параметр	Комментарии
backend строка	Определение бэкэнда, где происходит загрузка образа. Варианты: `"docker"` `"ostree"`
name строка / обязательный	Имя образа контейнера.
started логическое значение	Запуск или остановка контейнера. Варианты: `false` `true` ← (по умолчанию)
state строка	Состояние образа контейнера. Состояние `latest` обеспечит обновление образа контейнера до последней версии и принудительный перезапуск контейнера, если он запущен. Варианты: `"absent"` `"latest"` ← (по умолчанию) `"present"`

Атрибуты

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

Примечания

Примечание

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

Примеры

- name: Execute the run command on rsyslog container image (atomic run rhel7/rsyslog)
  community.general.atomic_image:
    name: rhel7/rsyslog
    state: latest

- name: Pull busybox to the OSTree backend
  community.general.atomic_image:
    name: busybox
    state: latest
    backend: ostree

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

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

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

Авторы

Saravanan KR (@krsacme)

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

© 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_image_module.html