Sponsor:

Your company here — click to reach over 10,000 unique daily visitors

bootc-switch - Man Page

Target a new container image reference to boot

Synopsis

bootc switch [--quiet] [--transport] [--enforce-container-sigpolicy] [--ostree-remote] [--retain] [-h|--help] <TARGET>

Description

Target a new container image reference to boot.

This is almost exactly the same operation as `upgrade`, but additionally changes the container image reference instead.

## Usage

A common pattern is to have a management agent control operating system updates via container image tags; for example, `quay.io/exampleos/someuser:v1.0` and `quay.io/exampleos/someuser:v1.1` where some machines are tracking `:v1.0`, and as a rollout progresses, machines can be switched to `v:1.1`.

Options

--quiet

Don't display progress

--transport=TRANSPORT [default: registry]

The transport; e.g. oci, oci-archive, containers-storage.  Defaults to `registry`

--enforce-container-sigpolicy

This is the inverse of the previous `--target-no-signature-verification` (which is now a no-op).

Enabling this option enforces that `/etc/containers/policy.json` includes a default policy which requires signatures.

--ostree-remote=OSTREE_REMOTE

Enable verification via an ostree remote

--retain

Retain reference to currently booted image

-h,  --help

Print help (see a summary with '-h')

<TARGET>

Target image to use for the next boot

Version

v0.1.13

Referenced By

bootc(8).

bootc 0.1.13