Skip to content

openshift-cluster-external-registry-update

A task to update and populate an external registry with required OpenShift container images

External Registry Update Task

This task updates and populates an external registry with required OpenShift container images. It's essential for disconnected installations, ensuring all necessary container images are available locally for cluster operation.

Requirements

Parameters

  • openshift/external-registry: External registry URL
  • openshift/external-registry-update: Boolean flag to enable update
  • openshift/oc-mirror-url: URL for oc-mirror tool
  • openshift/pull-secret: Red Hat registry credentials

Infrastructure

  • Existing external registry service
  • Sufficient storage capacity
  • Network access to Red Hat registries (for initial mirroring)
  • Valid registry certificates

Usage

Basic Update

# Enable registry update
drpcli machines set <machine-uuid> param openshift/external-registry-update to true

# Apply update task
drpcli machines tasks add <machine-uuid> openshift-cluster-external-registry-update

# Verify mirrored images
oc-mirror list --from-registry <registry-url>

Update Process

  1. Installs oc-mirror tool
  2. Configures authentication
  3. Initializes registry metadata
  4. Mirrors required images:
  5. OpenShift release images
  6. UBI base images
  7. Serverless images
  8. Service mesh images

Objects that Reference openshift-cluster-external-registry-update

Not used in current content packs

Objects used by openshift-cluster-external-registry-update