3.3. En miroir du service Red Hat OpenShift sur le référentiel d’images AWS
Faites correspondre le service OpenShift de Red Hat sur le référentiel d’images AWS à votre registre à utiliser lors de l’installation ou de la mise à niveau du cluster.
Conditions préalables
- L’hôte miroir a accès à Internet.
- Configuration d’un registre miroir à utiliser.
- Il a téléchargé le pull secret de Red Hat OpenShift Cluster Manager et l’a modifié pour inclure l’authentification dans votre référentiel miroir.
- Lorsque vous utilisez des certificats autosignés, vous avez spécifié un nom alternatif de sujet dans les certificats.
Procédure
Complétez les étapes suivantes sur l’hôte miroir:
- Consultez la page de téléchargements Red Hat OpenShift sur AWS pour déterminer la version de Red Hat OpenShift Service sur AWS que vous souhaitez installer et déterminer la balise correspondante sur la page Tags de dépôt.
Définissez les variables d’environnement requises:
Exporter la version de version:
OCP_RELEASE=<release_version>
$ OCP_RELEASE=<release_version>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Dans < Release_version>, spécifiez la balise qui correspond à la version de Red Hat OpenShift Service sur AWS à installer, telle que 4.5.4.
Exporter le nom du registre local et le port hôte:
LOCAL_REGISTRY='<local_registry_host_name>:<local_registry_host_port>'
$ LOCAL_REGISTRY='<local_registry_host_name>:<local_registry_host_port>'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Dans <local_registry_host_name>, spécifiez le nom de domaine du registre pour votre référentiel miroir, et pour <local_registry_host_port>, spécifiez le port sur lequel il sert le contenu.
Exporter le nom du référentiel local:
LOCAL_REPOSITORY='<local_repository_name>'
$ LOCAL_REPOSITORY='<local_repository_name>'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Dans <local_repository_name>, spécifiez le nom du référentiel à créer dans votre registre, tel que ocp4/openshift4.
Exporter le nom du référentiel en miroir:
PRODUCT_REPO='openshift-release-dev'
$ PRODUCT_REPO='openshift-release-dev'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Dans le cas d’une sortie de production, vous devez spécifier openshift- release-dev.
Exporter le chemin vers votre registre pull secret:
LOCAL_SECRET_JSON='<path_to_pull_secret>'
$ LOCAL_SECRET_JSON='<path_to_pull_secret>'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Dans <path_to_pull_secret>, spécifiez le chemin absolu vers et le nom de fichier du pull secret pour votre registre miroir que vous avez créé.
Exporter le miroir de libération:
RELEASE_NAME="ocp-release"
$ RELEASE_NAME="ocp-release"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Dans le cas d’une sortie de production, vous devez spécifier la version ocp.
Exportez le type d’architecture pour votre cluster:
ARCHITECTURE=<cluster_architecture>
$ ARCHITECTURE=<cluster_architecture>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- Indiquez l’architecture du cluster, comme x86_64, aarch64, s390x ou ppc64le.
Exporter le chemin vers le répertoire pour héberger les images en miroir:
REMOVABLE_MEDIA_PATH=<path>
$ REMOVABLE_MEDIA_PATH=<path>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- Indiquez le chemin complet, y compris le caractère initial de la barre oblique vers l’avant (/).
Affichez les images de la version dans le registre miroir:
Appuyez directement sur les images de libération vers le registre local en utilisant la commande suivante:
oc adm release mirror -a ${LOCAL_SECRET_JSON} \ --from=quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} \ --to=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} \ --to-release-image=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}
$ oc adm release mirror -a ${LOCAL_SECRET_JSON} \ --from=quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} \ --to=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} \ --to-release-image=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Cette commande tire les informations de libération comme un digest, et sa sortie inclut les données imageContentSources dont vous avez besoin lorsque vous installez votre cluster.
Enregistrez l’ensemble de la section imageContentSources à partir de la sortie de la commande précédente. Les informations sur vos miroirs sont uniques à votre référentiel miroir, et vous devez ajouter la section imageContentSources au fichier install-config.yaml pendant l’installation.
NoteLe nom de l’image est corrigé sur Quay.io pendant le processus de mise en miroir, et les images podman afficheront Quay.io dans le registre sur la machine virtuelle bootstrap.
Créer le programme d’installation qui est basé sur le contenu que vous avez reflété, l’extraire et l’épingler à la version en exécutant la commande suivante:
oc adm release extract -a ${LOCAL_SECRET_JSON} --command=openshift-install "${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}"
$ oc adm release extract -a ${LOCAL_SECRET_JSON} --command=openshift-install "${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow ImportantAfin de vous assurer que vous utilisez les images correctes pour la version de Red Hat OpenShift Service sur AWS que vous avez sélectionnée, vous devez extraire le programme d’installation du contenu en miroir.
Il faut effectuer cette étape sur une machine avec une connexion Internet active.
Dans le cas des clusters utilisant l’infrastructure fournie par l’installateur, exécutez la commande suivante:
openshift-install
$ openshift-install
Copy to Clipboard Copied! Toggle word wrap Toggle overflow