community.general.imgadm – Управление образами SmartOS

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

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

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

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

Описание

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

Требования

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

python >= 2.6

Параметры

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

Примеры

- 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/imgadm_module.html