Images miroir de bout en bout de IBM Fusion HCI et de ses services dans le registre de l'entreprise

Si vous plantez une installation déconnectée ou hors ligne, vous devez reproduire des images dans votre registre d'entreprise. Vous pouvez utiliser cette procédure pour réaliser une mise en miroir intégrée de IBM Fusion HCI et de ses services Backup & Restore, IBM Data Cataloging, et Content-Aware Storage. Sinon, vous pouvez les mettre en miroir individuellement en fonction de vos besoins.

Avant de commencer

  • Avant de passer au miroir, lisez les conditions préalables. Voir les conditions préalables à la mise en miroir.
  • Configurer les variables d'environnement communes :
    Important : assurez-vous d'avoir pris connaissance des considérations relatives à la mise à niveau hors ligne avant de procéder à la mise en miroir de la mise à niveau.
    Définissez les variables d'environnement suivantes pour le registre de votre conteneur cible. Ces valeurs seront utilisées dans chacune des étapes suivantes pour mettre en miroir tous les composants concernés.
    export LOCAL_ISF_REGISTRY="<Your container registry host>:<port>"
    export LOCAL_ISF_REPOSITORY="<Your image path>"
    export TARGET_PATH="$LOCAL_ISF_REGISTRY/$LOCAL_ISF_REPOSITORY"

    LOCAL_ISF_REGISTRY est le registre du conteneur cible.

    LOCAL_ISF_REPOSITORY est le chemin d'accès à l'image dans lequel vous souhaitez créer un miroir. Vous pouvez choisir vos propres chemins d'accès au dépôt. Par exemple, hci-images/isf ou hci-images. Voir les exemples de valeurs suivants :
    export LOCAL_ISF_REGISTRY="registryhost.com:443"
    export LOCAL_ISF_REPOSITORY="mirror-fusion-services-images"
    export TARGET_PATH="$LOCAL_ISF_REGISTRY/$LOCAL_ISF_REPOSITORY"

A propos de cette tâche

Points à noter sur cette tâche:

Procédure

Miroir IBM Fusion et les services connexes de sauvegarde et de restauration, IBM Data Cataloging et CAS.
  1. Définir les variables d'environnement suivantes relatives à la mise en miroir de IBM Fusion et des services associés.
    export CASE_NAME=ibm-spectrum-fusion
    export CASE_VERSION=2.10.0
    
    Par défaut, Backup & Restore, IBM Data Cataloging et CAS sont mis en miroir avec IBM Fusion dans un seul ensemble de commandes, de sorte que vous n'avez pas besoin de les mettre en miroir séparément.
  2. Important : les packages opérateurs redhat-oadp-operator et amq-streams ne sont nécessaires que pour les services Backup & Restore et IBM Data Cataloging.
    Assurez-vous que les paquets redhat-oadp-operator et amq-streams operator sont présents dans votre cluster.
    Remarque : si vous n'avez pas mis en miroir redhat-oadp-operator et amq-streams à partir des paquets Red Hat précédemment, suivez les étapes fournies dans la section Mise en miroir des images de l'opérateur Red Hat vers le registre d'entreprise.
    Remarque :
    • Exécutez la commande suivante pour obtenir la liste des paquets miroirs disponibles sur votre cluster Red Hat disponibles sur votre cluster.
      oc get packagemanifests | grep -i "Red Hat Operators"
    • Si vous n'obtenez pas les paquets d'opérateurs redhat-oadp-operator et amq-streams à l'étape précédente, vous devez suivre l'étape suivante 1.b.
    • Veillez à ajouter les paquets existants en même temps que les nouveaux dans le fichier ImageSetConfiguration . Sinon, d'anciens paquets peuvent être perdus dans l'image de l'index de l'opérateur Red Hat l'image de l'index de l'opérateur.
  3. Configurer le plugin ibm-pak pour qu'il utilise la commande oc mirror :
    oc ibm-pak config mirror-tools -e oc-mirror
  4. Utilisez la commande ibm-pak get pour télécharger les métadonnées de la mise en miroir à partir du dépôt public CloudPak de IBM :
    oc ibm-pak get --version "${CASE_VERSION}" "${CASE_NAME}"
  5. Exécutez la commande ibm-pak generate pour générer les fichiers de configuration oc mirror spécifiques à votre environnement :
    oc ibm-pak generate mirror-manifests --version "${CASE_VERSION}" "${CASE_NAME}" "${TARGET_PATH}"
    Exemple de sortie lorsque la commande generate se termine avec succès :
    ...
    
    - Pour refléter le catalogue non curatellisé :
    
      oc mirror --config /root/.ibm-pak/data/mirror/ $ {CASE_NAME} /$ {CASE_VERSION}/image-set-config.yaml docker://$ {TARGET_PATH}
    
  6. Note : Utilisez le paramètre --dest-tls-verify=false lorsque vous mettez en miroir des images dans le dépôt de quay.
    Exécutez la commande oc mirror pour le catalogue non curaté fourni dans la sortie de la commande generated précédente.
    Exemple :
     oc mirror --config /root/.ibm-pak/data/mirror/ $ {CASE_NAME} /$ {CASE_VERSION}/image-set-config.yaml docker://$ {TARGET_PATH}
    Exemple de sortie d'une mise en miroir réussie :
    Écriture d'un mappage d'image sur oc-mirror-workspace/results-1747667151/mapping.txt
    Rédiger les manifestes CatalogSource à oc-mirror-workspace/results-1747667151
    Rédiger des manifestes de la PICS pour oc-mirror-workspace/results-1747667151
    En cas d'échec, reportez-vous à la section Dépannage et problèmes connus de la mise en miroir hors ligne pour connaître les étapes de résolution.
  7. Allez dans le répertoire qui contient le fichier image-set-config.yaml référencé dans la commande oc mirror précédente. Ce répertoire contient plusieurs fichiers générés automatiquement par l'outil ibm-pak et applique les fichiers image-digest-mirror-set.yamlet catalog-sources-linux-amd64.yaml générés à votre cluster :
    cd /root/.ibm-pak/data/mirror/${CASE_NAME}/${CASE_VERSION}/
    oc apply -f image-digest-mirror-set.yaml
    oc apply -f catalog-sources-linux-amd64.yaml