community.general.swupd module – Manages updates and bundles in ClearLinux systems
Note
This module is part of the community.general collection (version 8.6.4).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.swupd
.
Synopsis
Manages updates and bundles with the swupd bundle manager, which is used by the Clear Linux Project for Intel Architecture.
Aliases: packaging.os.swupd
Parameters
Parameter |
Comments |
---|---|
URL pointing to the contents of available bundles. If not specified, the contents are retrieved from clearlinux.org. |
|
The format suffix for version file downloads. For example [1,2,3,staging,etc]. If not specified, the default format is used. |
|
The manifest contains information about the bundles at certain version of the OS. Specify a Manifest version to verify against that version or leave unspecified to verify against the current version. |
|
Name of the (I)bundle to install or remove. |
|
Indicates the desired (I)bundle state. Choices:
|
|
Updates the OS to the latest version. Choices:
|
|
Overrides both |
|
Verify content for OS version. Choices:
|
|
URL for version string download. |
Attributes
Attribute |
Support |
Description |
---|---|---|
Support: full |
Can run in |
|
Support: none |
Will return details on what has changed (or possibly needs changing in |
Examples
- 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
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
stderr of swupd Returned: always |
|
stdout of swupd Returned: always |