Модуль community.general.imgadm – Управление изображениями SmartOS

Примечание

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

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

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

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

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

Обзор

Управление изображениями виртуальных машин SmartOS через imgadm(1M)

Параметры

Параметр	Комментарии
force boolean	Принудительное выполнение операции (если поддерживается imgadm(1M)). Варианты: `false` `true`
pool строка	zpool для импорта или удаления изображений. По умолчанию: `"zones"`
source строка	URI источника изображения.
state строка / обязательно	Указывает состояние объекта, над которым выполняется операция. `imported` — псевдоним для `present` и `deleted` для `absent`. При установке на `vacuumed` и `uuid=`, будут удалены все неиспользуемые изображения. Варианты:* `"present"` `"absent"` `"deleted"` `"imported"` `"updated"` `"vacuumed"`
type строка	Тип источника изображения. Варианты: `"imgapi"` ← (по умолчанию) `"docker"` `"dsapi"`
uuid строка	UUID изображения. Может быть полным UUID или `*` для всех изображений.

Атрибуты

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

Примеры

- name: Import an image
  community.general.imgadm:
    uuid: '70e3ae72-96b6-11e6-9056-9737fd4d0764'
    state: imported

- name: Delete an image
  community.general.imgadm:
    uuid: '70e3ae72-96b6-11e6-9056-9737fd4d0764'
    state: deleted

- name: Update all images
  community.general.imgadm:
    uuid: '*'
    state: updated

- name: Update a single image
  community.general.imgadm:
    uuid: '70e3ae72-96b6-11e6-9056-9737fd4d0764'
    state: updated

- name: Add a source
  community.general.imgadm:
    source: 'https://datasets.project-fifo.net'
    state: present

- name: Add a Docker source
  community.general.imgadm:
    source: 'https://docker.io'
    type: docker
    state: present

- name: Remove a source
  community.general.imgadm:
    source: 'https://docker.io'
    state: absent

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

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

Ключ	Описание
source строка	Управляемый источник. Возвращается: Когда не управляется изображением. Пример: `"https://datasets.project-fifo.net"`
state строка	Состояние целевого объекта после выполнения. Возвращается: success Пример: `"present"`
uuid строка	UUID обработанного изображения. Возвращается: Когда не управляется источником изображения. Пример: `"70e3ae72-96b6-11e6-9056-9737fd4d0764"`

Авторы

Jasper Lievisse Adriaanse (@jasperla)

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

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