community.general.swupd 模块 – 管理 ClearLinux 系统中的更新和软件包

注意

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

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

要安装它,请使用:ansible-galaxy collection install community.general

要在 playbook 中使用它,请指定:community.general.swupd

概要

  • 使用 Clear Linux Project 用于 Intel 架构的 swupd 软件包管理器管理更新和软件包。

参数

参数

注释

contenturl

字符串

指向可用软件包内容的 URL。如果未指定,则内容将从 clearlinux.org 获取。

format

字符串

版本文件下载的格式后缀。例如 [1,2,3,staging,etc]。如果未指定,则使用默认格式。

manifest

别名:release, version

整数

清单包含关于操作系统特定版本软件包的信息。指定清单版本以针对该版本进行验证,或不指定以针对当前版本进行验证。

name

别名:bundle

字符串

要安装或删除的 (I)bundle 的名称。

state

字符串

指示所需的 (I)bundle 状态。present 确保软件包已安装,而 absent 确保 (I)bundle 未安装。

选项

  • "present" ← (默认)

  • "absent"

update

布尔值

将操作系统更新到最新版本。

选项

  • false ← (默认)

  • true

url

字符串

覆盖 contenturlversionurl

verify

布尔值

验证操作系统版本的內容。

选项

  • false ← (默认)

  • true

versionurl

字符串

版本字符串下载的 URL。

属性

属性

支持

描述

check_mode

支持:完全支持

可以在 check_mode 下运行,并在不修改目标的情况下返回更改状态预测。

diff_mode

支持:不支持

处于差异模式时,将返回有关更改内容(或可能需要在 check_mode 中更改的内容)的详细信息。

示例

- name: Update the OS to the latest version
  community.general.swupd:
    update: true

- name: Installs the "foo" bundle
  community.general.swupd:
    name: foo
    state: present

- name: Removes the "foo" bundle
  community.general.swupd:
    name: foo
    state: absent

- name: Check integrity of filesystem
  community.general.swupd:
    verify: true

- name: Downgrade OS to release 12920
  community.general.swupd:
    verify: true
    manifest: 12920

返回值

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

描述

stderr

字符串

swupd 的标准错误输出

返回:始终返回

stdout

字符串

swupd 的标准输出

返回:始终返回

作者

  • Alberto Murillo (@albertomurillo)