community.general.bootc_manage module – Bootc Switch and Upgrade

Note

This module is part of the community.general collection (version 14.0.0).

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.bootc_manage.

New in community.general 9.3.0

Synopsis

  • This module manages the switching and upgrading of bootc.

Parameters

Parameter

Comments

image

string

The image to switch to.

This is required when state=switch.

state

string / required

Control whether to apply the latest image or switch the image.

Note: This does not reboot the system.

Please use ansible.builtin.reboot to reboot the system.

Choices:

  • "switch"

  • "latest"

Attributes

Attribute

Support

Description

check_mode

Support: none

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: none

Returns details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Examples

# Switch to a different image
- name: Provide image to switch to a different image and retain the current running image
  community.general.bootc_manage:
    state: switch
    image: "example.com/image:latest"

# Apply updates of the current running image
- name: Apply updates of the current running image
  community.general.bootc_manage:
    state: latest

Authors

  • Ryan Cook (@cooktheryan)