agent-install-configuring-for-disconnected-registry.adoc

Configuring the Agent-based Installer to use mirrored images

You must use the output of either the oc adm release mirror command or the oc-mirror plugin to configure the Agent-based Installer to use mirrored images.

Procedure

1. If you used the oc-mirror plugin to mirror your release images:

   1. Open the imageContentSourcePolicy.yaml located in the results directory, for example oc-mirror-workspace/results-1682697932/.

   2. Copy the text in the repositoryDigestMirrors section of the yaml file.

2. If you used the oc adm release mirror command to mirror your release images:

   • Copy the text in the imageContentSources section of the command output.

3. Paste the copied text into the imageContentSources field of the install-config.yaml file.

4. Add the certificate file used for the mirror registry to the additionalTrustBundle field of the yaml file.

   Important

   The value must be the contents of the certificate file that you used for your mirror registry. The certificate file can be an existing, trusted certificate authority, or the self-signed certificate that you generated for the mirror registry.

   Example install-config.yaml file

     additionalTrustBundle: |
       -----BEGIN CERTIFICATE-----
       ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
       -----END CERTIFICATE-----

5. If you are using {ztp} manifests: add the registries.conf and ca-bundle.crt files to the mirror path to add the mirror configuration in the agent ISO image.

   Note	You can create the registries.conf file from the output of either the oc adm release mirror command or the oc mirror plugin. The format of the /etc/containers/registries.conf file has changed. It is now version 2 and in TOML format.

   Example registries.conf file

   [[registry]]
   location = "registry.ci.openshift.org/ocp/release" mirror-by-digest-only = true
   
   [[registry.mirror]] location = "virthost.ostest.test.metalkube.org:5000/localimages/local-release-image"
   
   [[registry]]
   location = "quay.io/openshift-release-dev/ocp-v4.0-art-dev" mirror-by-digest-only = true
   
   [[registry.mirror]] location = "virthost.ostest.test.metalkube.org:5000/localimages/local-release-image"