Skip to content

halo rollback

Point a ring (and its experiment channels) back at an earlier signed release (version or manifest digest)

–to <version> resolves tag v<version> and refuses the release unless its signed manifest carries that version (a retagged v-tag is refused); –to sha256:<manifest digest> is content-addressed.

Terminal window
halo rollback [flags]
Flag Shorthand Type Default Description
--adopt-existing bool false trust pointers the registry already serves that the state file has no record of (first run, or an evicted CI cache); without it such a pointer is refused unless –expect-digest names it
--cosign-key string cosign key reference (file or KMS URI); co-signs alongside –key
--cosign-keyless bool false cosign keyless (Fulcio+Rekor): uploads the release digest to the public transparency log
--expect-digest string refuse unless –to names this release digest (sha256:…)
--key string ed25519 private key PEM (create one with: halo keys generate)
--plain-http bool false use HTTP instead of HTTPS (local registries)
--policy-dir string policy repo directory (default “.”)
--registry string registry repo, e.g. ghcr.io/acme/halos
--ring string ring to roll back (required)
--state-file string signer state file recording the last pointer written per registry repo and ring; a registry serving an older pointer (replay) is refused. Default $XDG_STATE_HOME/halos/pointers.json (~/.local/state/halos/pointers.json). CI: cache this file between runs
--to string release version or sha256 manifest digest (required)
Flag Shorthand Type Default Description
--output string text output format: text|json

halo