Questo contenuto non è disponibile nella lingua selezionata.

Chapter 9. Configuring your cluster to use an external registry


If your cluster was installed without an external registry, you can configure the cluster to use an external registry as a postinstallation task in order to use a mirroring workflow for your image management.

Important

This configuration is applicable only to clusters installed using the method described in "Installing a cluster without an external registry".

When you install a cluster using the method described in "Installing a cluster without an external registry", the cluster relies on images contained in the downloaded ISO for its lifecycle management. However, you might want to configure your cluster to use an external image registry and mirror images to the registry instead. To do this, you must set up an external registry, successfully complete an update using images from the external registry, and finally delete InternalReleaseImage custom resource, which maintains an internal image registry in the cluster.

9.1. Pre-configuration tasks

Before you can configure your cluster to use an external registry, you must prepare your environment with an image registry and perform an update using images on the registry.

To prevent the accidental deletion of the cluster’s internal image registry, you cannot delete the InternalReleaseImage custom resource without first having completed the following tasks:

  • You have created a mirror registry in your environment. For more information, see "Creating a mirror registry with mirror registry for Red Hat OpenShift".
  • You have mirrored images to the mirror registry. For more information, see "Mirroring images for a disconnected installation by using the oc-mirror plugin v2".
  • You have updated your cluster using the images you mirrored to your registry. For more information, see "Updating a cluster in a disconnected environment using the OpenShift Update Service".

9.2. Deleting the internal image registry

You can complete configuring your cluster to use an external image registry by deleting the resource responsible for maintaining the internal image registry that was installed on your cluster.

Prerequisites

  • You installed your cluster using the method described in "Installing a cluster without an external registry".
  • You have successfully performed a cluster update using images mirrored to your external image registry. You can ensure that your cluster has been updated to this new version by running the oc get clusterversion command.

    Important

    The version you updated your cluster to must not be listed in the status.releases field of the InternalReleaseImage custom resource (CR). You can check the contents of the CR by running the oc get InternalReleaseImage -o yaml command.

Procedure

  • Delete the singleton InternalReleaseImage CR by running the following command:

    $ oc delete internalreleaseimages cluster
Red Hat logoGithubRedditYoutubeTwitter

Formazione

Prova, acquista e vendi

Community

Informazioni su Red Hat

Forniamo soluzioni consolidate che rendono più semplice per le aziende lavorare su piattaforme e ambienti diversi, dal datacenter centrale all'edge della rete.

Rendiamo l’open source più inclusivo

Red Hat si impegna a sostituire il linguaggio problematico nel codice, nella documentazione e nelle proprietà web. Per maggiori dettagli, visita il Blog di Red Hat.

Informazioni sulla documentazione di Red Hat

Legal Notice

Theme

© 2026 Red Hat
Torna in cima