updated 7d ago
Phase 4 of the MicroShift release process: confirm all artifacts and documentation are publicly available after a GA or z-stream release has shipped.
What can you do with Microshift Release:post Release?
name: microshift-release:post-release argument-hint: [--verbose] [--json] description: Verify all artifacts and docs are publicly available after shipping ā bootc images, RPMs, errata, documentation, and lifecycle page user-invocable: true allowed-tools: Bash
microshift-release:post-release
Synopsis
/microshift-release:post-release <version> [--verbose] [--json]
Description
Phase 4 of the MicroShift release process: confirm all artifacts and documentation are publicly available after a GA or z-stream release has shipped.
Only GA (X.Y.0) and z-stream (X.Y.Z) releases are supported. EC and RC versions are rejected.
Verifies five areas (manual verification links included for reference):
- Errata ā public advisory exists and has reached SHIPPED_LIVE
- Bootc Images ā container images available in the Red Hat Catalog
- microshift-bootc-rhel9
- microshift-bootc-rhel10 (4.22+ only)
- RPMs ā packages accessible on the Red Hat Customer Portal and pushed to CDN repos
- Documentation ā release notes published on docs.redhat.com
- Lifecycle (X.Y.0 only) ā version listed in the Product Life Cycle page with Full Support status
The advisory is auto-discovered via the public Hydra search API ā no advisory ID argument is needed.
Most checks work over the public internet. VPN-gated checks (errata SHIPPED_LIVE status, CDN repo verification) degrade gracefully to WARN when VPN is unavailable.
For versions 4.22.2+, both el9 and el10 bootc images are checked.
Prerequisites
| Requirement | Needed for | Mandatory? |
|---|---|---|
| Internet | All checks | Yes |
| VPN | Errata SHIPPED_LIVE status, CDN repos | No (degrades to WARN) |
Kerberos ticket (kinit) |
Errata Tool API | No (degrades to WARN) |
Arguments
version(required): Full GA or z-stream version string- Z-stream:
4.21.7 - GA:
4.22.0 - EC/RC/nightly versions are rejected
- Z-stream:
--verbose(optional): Show detailed markdown report--json(optional): Output raw JSON
Scripts Directory
SCRIPTS_DIR=plugins/microshift-release/scripts
Implementation
Step 1: Parse Arguments
- Extract
versionfrom$ARGUMENTSā the first non-flag token - Pass through
--verboseand--jsonflags if present
Step 2: Run Checks
bash $SCRIPTS_DIR/post_release.sh <version> [--verbose] [--json]
Display stderr only if the script exits non-zero.
Step 3: Display Output
Paste the complete stdout of the script into the response as a code block. Every check line must be visible to the user. Do not summarize, abbreviate, or replace the output with commentary.
Step 4: Handle Errors
- EC/RC/nightly version: Post-release checks are only for GA and z-stream releases
- VPN unavailable: Errata status and CDN repo checks degrade to WARN ā all other checks still run
- Kerberos auth failed: Run
kinit <username>@REDHAT.COMfor Errata Tool access - Network errors: Individual checks degrade to WARN with the error message
Checks Performed
Errata
| Check | Description |
|---|---|
pr_errata_found |
Public errata advisory exists for this version (Hydra search) |
pr_errata_shipped |
Advisory status is SHIPPED_LIVE (VPN required) |
Bootc Images
| Check | Description |
|---|---|
pr_bootc_catalog_el9 |
microshift-bootc-rhel9 image in prod catalog (catalog.redhat.com) |
pr_bootc_catalog_el10 |
microshift-bootc-rhel10 image in prod catalog (4.22.2+ only) |
RPMs
| Check | Description |
|---|---|
pr_rpms_customer_portal |
Advisory page accessible on Red Hat Customer Portal (access.redhat.com) |
pr_rpms_cdn |
RPMs pushed to rhocp CDN repos (VPN required) |
Documentation
| Check | Description |
|---|---|
pr_docs_published |
Release notes published on docs.redhat.com |
Lifecycle (X.Y.0 only)
| Check | Description |
|---|---|
pr_lifecycle_listed |
Version listed in Product Life Cycle API |
pr_lifecycle_active |
Lifecycle status is Full Support |
Output Format
Short (default):
Post-Release Verification: 4.21.7
āā Errata āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā
pr_errata_found RHBA-2026:12345 (published 2026-07-29)
ā
pr_errata_shipped Status: SHIPPED_LIVE
āā Bootc Images āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā
pr_bootc_catalog_el9 Found in prod catalog (rhel9)
āā RPMs āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā
pr_rpms_customer_portal Advisory page accessible
ā
pr_rpms_cdn 4 CDN repo(s) found
āā Documentation āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā
pr_docs_published Release notes page accessible (4.21)
On failure, details appear below the failing check:
ā pr_bootc_catalog_el9 Not found in prod catalog (rhel9)
No matching image found for version 4.21.7
Verbose (--verbose): Markdown table with full evidence per check.
Examples
/microshift-release:post-release 4.21.7 # z-stream
/microshift-release:post-release 4.22.0 # GA (includes lifecycle checks)
/microshift-release:post-release 4.22.2 # z-stream (el9 + el10)
/microshift-release:post-release 4.21.7 --verbose # detailed report
/microshift-release:post-release 4.21.7 --json # machine-readable output
Notes
- Read-only ā does NOT modify advisories, tickets, or external state. No confirmation required.
- Advisory is auto-discovered via the public Hydra search API ā no advisory ID needed
- EC, RC, and nightly versions are rejected with an error
- VPN is optional ā most checks work over the public internet
- Exit code is non-zero if any check returns FAIL
Install
Add Microshift Release:post Release to your client. Pick the one you use.
npx skills add openshift-eng/edge-toolingInstalls every skill in the repository, then prompts for which to keep.
/plugin marketplace add openshift-eng/edge-toolingAdds the repository as a plugin marketplace; install individual plugins with `/plugin install`.
git clone https://github.com/openshift-eng/edge-tooling
cp -r plugins/microshift-release/skills/post-release ~/.claude/skills/A skill is a plain directory. Copy it into `.claude/skills/` in a project or in your home directory.
Score
69 / 100
Good