community.general.imgadm 模块 – 管理 SmartOS 镜像

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在 playbook 中使用它，请指定：community.general.imgadm。

概要 

通过 imgadm(1M) 管理 SmartOS 虚拟机镜像

参数 

参数	注释
force 布尔值	强制执行给定的操作（在 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	支持：无	当处于 diff 模式时，将返回有关已更改的内容（或可能需要在 `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 字符串	执行后，目标的状态。返回：成功示例： `"present"`
uuid 字符串	操作的镜像的 UUID。返回：当不管理镜像源时。示例： `"70e3ae72-96b6-11e6-9056-9737fd4d0764"`

作者

Jasper Lievisse Adriaanse (@jasperla)