microshift-release:validate-artifacts

Validate MicroShift release artifacts for RPM provenance, bootc shipment, and mirror availability.

7|15|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/openshift-eng/edge-tooling --skill microshift-release-validate-artifacts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: microshift-release:validate-artifacts
Source: https://github.com/openshift-eng/edge-tooling/tree/main/plugins/microshift-release/skills/validate-artifacts
Command: npx skills add https://github.com/openshift-eng/edge-tooling --skill microshift-release-validate-artifacts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents late-stage release failures by validating that MicroShift ART produced correct RPMs and bootc images for a specific release version.

Core Features & Use Cases

  • Checks RPM provenance and readiness: Verifies expected Brew packages are present, validates NVR/filename formatting, confirms the commit belongs to the correct release branch, ensures required RHEL variants exist, and performs mirror availability checks for RC/EC flows.
  • Validates bootc shipment and catalog publication: Confirms shipment MR content and structure, checks X/Y.0-specific metadata rules, verifies advisory URLs and stage/prod catalog presence, and ensures SHA/pullspec consistency for RC/EC.
  • Use case: Before proceeding in the release pipeline, validate a candidate version to ensure artifacts align with expected release rules, mirrors, and provenance evidence.

Quick Start

Run /microshift-release:validate-artifacts 4.22.0-rc.2 --verbose to generate a detailed evidence report for that release candidate.

Frequently Asked Questions about microshift-release:validate-artifacts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate MicroShift release artifacts before publishing?▼

To validate MicroShift release artifacts, run the validation command with a target version like 4.22.0-rc.2. It checks Brew-built RPM package lists, NVR/commit provenance, bootc shipment MR metadata, and catalog publication to ensure release readiness.

What does RPM provenance verification check during a MicroShift release?▼

RPM provenance verification confirms expected Brew packages are present, validates NVR/filename formatting, ensures the commit belongs to the correct release branch, and checks that required RHEL variants exist for the target MicroShift release.

Do I need a VPN to verify MicroShift RPM and bootc artifacts?▼

Yes, you need a VPN for Brew and internal git provenance checks. Network mirror access is required for RC/EC mirror validations, and an optional GITLAB_API_TOKEN can be supplied for bootc shipment MR verification.

When are bootc shipment checks enforced for MicroShift releases?▼

Bootc shipment checks are enforced for MicroShift versions 4.18 and above. The validation confirms shipment MR content, checks X/Y.0-specific metadata rules, verifies advisory URLs, and ensures SHA/pullspec consistency for RC/EC flows.

Does MicroShift artifact validation work for nightly and Z-stream releases?▼

Yes, MicroShift artifact validation applies to RC, EC, GA (X/Y.0), Z-stream, and nightly workflows. Mirror and SHA consistency rules are specifically applied to the relevant release types during the validation process.

Why do MicroShift release validations fail with mirror availability errors?▼

Mirror availability errors occur during RC/EC flows when network mirror access is unavailable. Ensure your connection allows reaching the required mirrors, as RC/EC mirror validations explicitly depend on this external network access.