community.general.swupd (8.5.0) — module

Manages updates and bundles in ClearLinux systems

Authors: Alberto Murillo (@albertomurillo)

Install collection

Install with ansible-galaxy collection install community.general:==8.5.0


Add to requirements.yml

  collections:
    - name: community.general
      version: 8.5.0

Description

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

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Update the OS to the latest version
  community.general.swupd:
    update: true
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Installs the "foo" bundle
  community.general.swupd:
    name: foo
    state: present
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Removes the "foo" bundle
  community.general.swupd:
    name: foo
    state: absent
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Check integrity of filesystem
  community.general.swupd:
    verify: true
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Downgrade OS to release 12920
  community.general.swupd:
    verify: true
    manifest: 12920

Inputs

    
url:
    description:
    - Overrides both O(contenturl) and O(versionurl).
    type: str

name:
    aliases:
    - bundle
    description:
    - Name of the (I)bundle to install or remove.
    type: str

state:
    choices:
    - present
    - absent
    default: present
    description:
    - Indicates the desired (I)bundle state. V(present) ensures the bundle is installed
      while V(absent) ensures the (I)bundle is not installed.
    type: str

format:
    description:
    - The format suffix for version file downloads. For example [1,2,3,staging,etc]. If
      not specified, the default format is used.
    type: str

update:
    default: false
    description:
    - Updates the OS to the latest version.
    type: bool

verify:
    default: false
    description:
    - Verify content for OS version.
    type: bool

manifest:
    aliases:
    - release
    - version
    description:
    - 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.
    type: int

contenturl:
    description:
    - URL pointing to the contents of available bundles. If not specified, the contents
      are retrieved from clearlinux.org.
    type: str

versionurl:
    description:
    - URL for version string download.
    type: str

Outputs

stderr:
  description: stderr of swupd
  returned: always
  type: str
stdout:
  description: stdout of swupd
  returned: always
  type: str