lvms:setup-prereq

Configure CatalogSource and ImageDigestMirrorSet prerequisites for OpenShift clusters.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up prerequisites for testing unreleased LVMS operator builds is difficult to do reliably across both connected and disconnected OpenShift environments, especially when you must configure CatalogSource, mirrored operator images, and ImageDigestMirrorSets correctly.

Core Features & Use Cases

  • Connected cluster setup: Cleans up existing marketplace catalog/ICSP configuration, then configures a CatalogSource pointing at the provided catalog image and an ImageDigestMirrorSet for deterministic image resolution.
  • Disconnected cluster setup: Uses oc-mirror to mirror the operator catalog, applies generated CatalogSource resources, optionally mirrors additional images, and then creates an ImageDigestMirrorSet targeting the mirror registry.
  • Cluster-safe verification workflow: Validates kubeconfig access and required tooling, waits for MCP state transitions caused by IDMS changes, and confirms CatalogSource/package readiness so an engineer can proceed with installing the unreleased LVMS operator.

Quick Start

Run /lvms:setup-prereq connected to configure CatalogSource and ImageDigestMirrorSet prerequisites for an online OpenShift cluster.

Frequently Asked Questions about lvms:setup-prereq

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

FAQPage Schema
How do I configure CatalogSource and ImageDigestMirrorSet for unreleased LVMS operator builds?

To configure CatalogSource and ImageDigestMirrorSet for unreleased LVMS operator builds, clean up existing marketplace configurations, apply the new catalog source, and set the IDMS for deterministic image resolution on connected OpenShift clusters.

What is the best way to mirror an operator catalog for disconnected OpenShift environments?

Mirroring an operator catalog for disconnected OpenShift environments uses oc-mirror to pull the catalog and related images, then applies generated CatalogSource resources and an ImageDigestMirrorSet targeting the local mirror registry.

Do I need oc-mirror and kubeconfig validation to test LVMS operators offline?

Yes, testing LVMS operators offline requires kubeconfig validation for cluster access and oc-mirror availability checks to successfully mirror operator catalogs and create ImageDigestMirrorSets in disconnected environments.

Why does ImageDigestMirrorSet creation require MCP-aware waiting in OpenShift?

ImageDigestMirrorSet creation requires MCP-aware waiting because IDMS changes trigger MachineConfigPool state transitions, and waiting ensures nodes reconcile before you proceed with installing the unreleased LVMS operator.

Can I clean up existing marketplace catalog configuration before applying a new CatalogSource?

Yes, connected cluster setup cleans up existing marketplace catalog and ICSP configuration before configuring a new CatalogSource and an ImageDigestMirrorSet to ensure deterministic image pulls for the LVMS operator.