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

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.imgadm.

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

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

Управление образами виртуальных машин SmartOS с помощью imgadm(8).

Параметры

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

Атрибуты

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

См. также

imgadm(8): Полная страница руководства по команде imgadm.

Примеры

- 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 string	Управляемый источник. Возвращается: если управление образом не выполняется. Пример: `"https://datasets.project-fifo.net"`
state string	Состояние целевого объекта после выполнения. Возвращается: при успешном выполнении Пример: `"present"`
uuid string	UUID образа, с которым выполнялась операция. Возвращается: если управление источником образа не выполняется. Пример: `"70e3ae72-96b6-11e6-9056-9737fd4d0764"`

Авторы

Jasper Lievisse Adriaanse (@jasperla)

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

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/imgadm_module.html