community.general.imgadm – Управление образами SmartOS
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general
Для использования в плейбуке укажите: community.general.imgadm
Обзор
- Управление виртуальными образами SmartOS через imgadm(1M)
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| force boolean |
| Принудительное выполнение операции (если поддерживается imgadm(1M)). |
| pool string | Значение по умолчанию: "zones" | zpool для импорта или удаления образов. |
| source string | URI для источника образа. | |
| state string / обязательно |
| Состояние, в котором должен находиться объект. imported является псевдонимом для present, а deleted — для absent. При установке в vacuumed и uuid на *, будут удалены все неиспользуемые образы. |
| type string |
| Тип источника образа. |
| uuid string | 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 string | При управлении не изображением. | Управляемый источник. Пример: https://datasets.project-fifo.net |
| state string | success | Состояние целевого объекта после выполнения. Пример: present |
| uuid string | При управлении не источником изображения. | UUID обработанного изображения. Пример: 70e3ae72-96b6-11e6-9056-9737fd4d0764 |
Авторы
- Jasper Lievisse Adriaanse (@jasperla)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/imgadm_module.html