You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.

swupd - Manages updates and bundles in ClearLinux systems.¶

New in version 2.3.

Synopsis
Options
Examples
Return Values
- Status

Synopsis ¶

Manages updates and bundles with the swupd bundle manager, which is used by the Clear Linux Project for Intel Architecture.

Options ¶

parameter	required	default	choices	comments
contenturl	no			URL pointing to the contents of available bundles. If not specified, the contents are retrieved from clearlinux.org.
format	no			The format suffix for version file downloads. For example [1,2,3,staging,etc]. If not specified, the default format is used.
manifest	no			The manifest contains information about the bundles at certaion version of the OS. Specify a Manifest version to verify against that version or leave unspecified to verify against the current version. aliases: release, version
name	no			Name of the (I)bundle to install or remove. aliases: bundle
state	no	present	present absent	Indicates the desired (I)bundle state. `present` ensures the bundle is installed while `absent` ensures the (I)bundle is not installed.
update	no			Updates the OS to the latest version.
url	no			Overrides both contenturl and versionurl.
verify	no			Verify content for OS version.
versionurl	no			URL for version string download.

Examples ¶

- name: Update the OS to the latest version
  swupd:
    update: yes

- name: Installs the "foo" bundle
  swupd:
    name: foo
    state: present

- name: Removes the "foo" bundle
  swupd:
    name: foo
    state: absent

- name: Check integrity of filesystem
  swupd:
    verify: yes

- name: Downgrade OS to release 12920
  swupd:
    verify: yes
    manifest: 12920

Return Values ¶

Common return values are documented here Return Values, the following are the fields unique to this module:

name	description	returned	type	sample
stderr	stderr of swupd	always	string
stdout	stdout of swupd	always	string

Status ¶

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.