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

注意

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

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

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

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

概要

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

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

要求

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

  • atomic

参数

参数

注释

后端

字符串 / 必需

定义用于容器的后端。

选择

  • "docker"

  • "ostree"

镜像

字符串 / 必需

用于安装容器的镜像。

模式

字符串

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

选择

  • "user"

  • "system"

名称

字符串 / 必需

容器的名称。

rootfs

字符串

定义镜像的 rootfs。

状态

字符串

容器的状态。

选择

  • "absent"

  • "latest" ←（默认）

  • "present"

  • "rollback"

值

列表 / 元素=字符串

用于安装容器的值。

此选项仅允许使用模式 'user' 或 'system'。

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

默认值： []

属性

属性

支持

描述

check_mode

支持：无

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

diff_mode

支持：无

当处于 diff 模式时，将返回有关已更改的内容（或可能需要在 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

字符串

命令标准输出

返回： 始终

示例： "使用 默认 标签： 最新 ..."

作者

  • Giuseppe Scrivano (@giuseppe)