community.general.atomic_container 模块 – 管理 Atomic 主机平台上的容器

注意

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

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

要安装它，请使用：ansible-galaxy collection install community.general。要使用此模块，您需要其他要求，有关详细信息，请参阅 要求。

要在剧本中使用它，请指定：community.general.atomic_container。

概要

  • 管理 Atomic 主机平台上的容器。

  • 允许管理 Atomic 主机平台上容器的生命周期。

要求

执行此模块的主机需要以下要求。

  • atomic

参数

参数

注释

backend

字符串 / 必需

定义要用于容器的后端。

选项

  • "docker"

  • "ostree"

image

字符串 / 必需

用于安装容器的镜像。

mode

字符串

定义是用户容器还是系统容器。

选项

  • "user"

  • "system"

name

字符串 / 必需

容器名称。

rootfs

字符串

定义镜像的 rootfs。

state

字符串

容器状态。

选项

  • "absent"

  • "latest" ← (默认)

  • "present"

  • "rollback"

values

列表 / 元素=字符串

容器安装的值。

此选项仅在模式为“user”或“system”时才允许。

此处指定的值将在安装时用作 atomic install 的 –set 参数。

默认值： []

属性

属性

支持

描述

check_mode

支持：不支持

可以在 check_mode 下运行并返回更改状态预测，而无需修改目标。

diff_mode

支持：不支持

在差异模式下，将返回有关已更改内容（或可能需要在 check_mode 中更改的内容）的详细信息。

备注

注意

  • 主机应支持 atomic 命令

示例

- name: Install the etcd system container
  community.general.atomic_container:
    name: etcd
    image: rhel/etcd
    backend: ostree
    state: latest
    mode: system
    values:
        - ETCD_NAME=etcd.server

- name: Uninstall the etcd system container
  community.general.atomic_container:
    name: etcd
    image: rhel/etcd
    backend: ostree
    state: absent
    mode: system

返回值

常见的返回值已记录在 此处，以下是此模块独有的字段

键

描述

msg

字符串

命令标准输出

返回： 始终

示例： "Using default tag: latest ..."

作者

  • Giuseppe Scrivano (@giuseppe)