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.