Registre

Procédure

1. Utilisez le catalogue de l'écosystème Red Hat pour rechercher des images de conteneurs spécifiques à partir du référentiel Red Hat et sélectionnez l'image requise.
2. Cliquez sur Get this image pour trouver la commande correspondant à votre image de conteneur.

3. Connectez-vous en exécutant la commande suivante et en saisissant votre nom d'utilisateur et votre mot de passe pour vous authentifier :

   $ podman login registry.redhat.io
    Username:<your_registry_account_username>
    Password:<your_registry_account_password>

4. Téléchargez l'image et enregistrez-la localement en exécutant la commande suivante :

   $ podman pull registry.redhat.io/<repository_name>

Procédure

1. Pour configurer votre registre afin qu'il utilise le stockage, modifiez l'adresse spec.storage.pvc dans la ressource configs.imageregistry/cluster.

   Note

   Lorsque vous utilisez un espace de stockage partagé, vérifiez vos paramètres de sécurité afin d'empêcher tout accès extérieur.

2. Vérifiez que vous n'avez pas de pod de registre :

   $ oc get pod -n openshift-image-registry -l docker-registry=default

   Exemple de sortie

   No resources found in openshift-image-registry namespace

   Note

   Si vous avez un pod de registre dans votre sortie, il n'est pas nécessaire de poursuivre cette procédure.

3. Vérifier la configuration du registre :

   $ oc edit configs.imageregistry.operator.openshift.io

   Exemple de sortie

   storage:
     pvc:
       claim:

   Laissez le champ claim vide pour permettre la création automatique d'un PVC image-registry-storage.

4. Vérifier l'état de clusteroperator:

   $ oc get clusteroperator image-registry

   Exemple de sortie

   NAME             VERSION              AVAILABLE   PROGRESSING   DEGRADED   SINCE   MESSAGE
   image-registry   4.12                 True        False         False      6h50m

5. Veillez à ce que votre registre soit géré pour permettre la création et l'envoi d'images.

   • Exécutez :

     $ oc edit configs.imageregistry/cluster

     Modifiez ensuite la ligne

     managementState: Removed

     à

     managementState: Managed

Procédure

1. Pour définir le stockage du registre d'images comme un type de stockage en bloc, corrigez le registre afin qu'il utilise la stratégie de déploiement Recreate et s'exécute avec une seule réplique (1) :

   $ oc patch config.imageregistry.operator.openshift.io/cluster --type=merge -p '{"spec":{"rolloutStrategy":"Recreate","replicas":1}}'

2. Provisionnez le PV pour le périphérique de stockage en bloc et créez un PVC pour ce volume. Le volume bloc demandé utilise le mode d'accès ReadWriteOnce (RWO).
3. Modifiez la configuration du registre de manière à ce qu'elle fasse référence au PVC correct.

Procédure

1. Créez la demande de seau d'objets à l'aide de la classe de stockage ocs-storagecluster-ceph-rgw. Par exemple :

   cat <<EOF | oc apply -f -
   apiVersion: objectbucket.io/v1alpha1
   kind: ObjectBucketClaim
   metadata:
     name: rgwtest
     namespace: openshift-storage
   spec:
     storageClassName: ocs-storagecluster-ceph-rgw
     generateBucketName: rgwtest
   EOF

2. Obtenez le nom du seau en entrant la commande suivante :

   $ bucket_name=$(oc get obc -n openshift-storage rgwtest -o jsonpath='{.spec.bucketName}')

3. Obtenez les informations d'identification AWS en entrant les commandes suivantes :

   $ AWS_ACCESS_KEY_ID=$(oc get secret -n openshift-storage rgwtest -o yaml | grep -w "AWS_ACCESS_KEY_ID:" | head -n1 | awk '{print $2}' | base64 --decode)

   $ AWS_SECRET_ACCESS_KEY=$(oc get secret -n openshift-storage rgwtest -o yaml | grep -w "AWS_SECRET_ACCESS_KEY:" | head -n1 | awk '{print $2}' | base64 --decode)

4. Créez le secret image-registry-private-configuration-user avec les informations d'identification AWS pour le nouveau seau sous openshift-image-registry project en entrant la commande suivante :

   $ oc create secret generic image-registry-private-configuration-user --from-literal=REGISTRY_STORAGE_S3_ACCESSKEY=${AWS_ACCESS_KEY_ID} --from-literal=REGISTRY_STORAGE_S3_SECRETKEY=${AWS_SECRET_ACCESS_KEY} --namespace openshift-image-registry

5. Créez une route de cryptage pour Ceph RGW en entrant la commande suivante :

   $ oc create route reencrypt <route_name> --service=rook-ceph-rgw-ocs-storagecluster-cephobjectstore --port=https -n openshift-storage

   1. Obtenez l'hôte de la route en entrant la commande suivante :

      route_host=$(oc get route <route_name> -n openshift-storage -o=jsonpath='{.spec.host}')

6. Créez une carte de configuration qui utilise un certificat d'entrée en entrant les commandes suivantes :

   $ oc extract secret/router-certs-default  -n openshift-ingress  --confirm

   $ oc create configmap image-registry-s3-bundle --from-file=ca-bundle.crt=./tls.crt  -n openshift-config

7. Configurez le registre d'images pour utiliser le stockage d'objets Ceph RGW en entrant la commande suivante :

   $ oc patch config.image/cluster -p '{"spec":{"managementState":"Managed","replicas":2,"storage":{"managementState":"Unmanaged","s3":{"bucket":'\"${bucket_name}\"',"region":"us-east-1","regionEndpoint":'\"https://${route_host}\"',"virtualHostedStyle":false,"encrypt":false,"trustedCA":{"name":"image-registry-s3-bundle"}}}}}' --type=merge

Procédure

1. Créez la demande de seau d'objets à l'aide de la classe de stockage openshift-storage.noobaa.io. Par exemple :

   cat <<EOF | oc apply -f -
   apiVersion: objectbucket.io/v1alpha1
   kind: ObjectBucketClaim
   metadata:
     name: noobaatest
     namespace: openshift-storage
   spec:
     storageClassName: openshift-storage.noobaa.io
     generateBucketName: noobaatest
   EOF

2. Obtenez le nom du seau en entrant la commande suivante :

   $ bucket_name=$(oc get obc -n openshift-storage noobaatest -o jsonpath='{.spec.bucketName}')

3. Obtenez les informations d'identification AWS en entrant les commandes suivantes :

   $ AWS_ACCESS_KEY_ID=$(oc get secret -n openshift-storage noobaatest -o yaml | grep -w "AWS_ACCESS_KEY_ID:" | head -n1 | awk '{print $2}' | base64 --decode)

   $ AWS_SECRET_ACCESS_KEY=$(oc get secret -n openshift-storage noobaatest -o yaml | grep -w "AWS_SECRET_ACCESS_KEY:" | head -n1 | awk '{print $2}' | base64 --decode)

4. Créez le secret image-registry-private-configuration-user avec les informations d'identification AWS pour le nouveau seau sous openshift-image-registry project en entrant la commande suivante :

   $ oc create secret generic image-registry-private-configuration-user --from-literal=REGISTRY_STORAGE_S3_ACCESSKEY=${AWS_ACCESS_KEY_ID} --from-literal=REGISTRY_STORAGE_S3_SECRETKEY=${AWS_SECRET_ACCESS_KEY} --namespace openshift-image-registry

5. Obtenez l'hôte de la route en entrant la commande suivante :

   $ route_host=$(oc get route s3 -n openshift-storage -o=jsonpath='{.spec.host}')

6. Créez une carte de configuration qui utilise un certificat d'entrée en entrant les commandes suivantes :

   $ oc extract secret/router-certs-default  -n openshift-ingress  --confirm

   $ oc create configmap image-registry-s3-bundle --from-file=ca-bundle.crt=./tls.crt  -n openshift-config

7. Configurez le registre d'images pour utiliser le stockage d'objets Nooba en entrant la commande suivante :

   $ oc patch config.image/cluster -p '{"spec":{"managementState":"Managed","replicas":2,"storage":{"managementState":"Unmanaged","s3":{"bucket":'\"${bucket_name}\"',"region":"us-east-1","regionEndpoint":'\"https://${route_host}\"',"virtualHostedStyle":false,"encrypt":false,"trustedCA":{"name":"image-registry-s3-bundle"}}}}}' --type=merge

Procédure

1. Pour configurer votre registre afin qu'il utilise le stockage, modifiez l'adresse spec.storage.pvc dans la ressource configs.imageregistry/cluster.

   Note

   Lorsque vous utilisez un espace de stockage partagé, vérifiez vos paramètres de sécurité afin d'empêcher tout accès extérieur.

2. Vérifiez que vous n'avez pas de pod de registre :

   $ oc get pod -n openshift-image-registry -l docker-registry=default

   Exemple de sortie

   No resourses found in openshift-image-registry namespace

   Note

   Si vous avez un pod de registre dans votre sortie, il n'est pas nécessaire de poursuivre cette procédure.

3. Vérifier la configuration du registre :

   $ oc edit configs.imageregistry.operator.openshift.io

   Exemple de sortie

   storage:
     pvc:
       claim: 1

   1

   Laissez le champ claim vide pour permettre la création automatique d'une réclamation de volume persistant (PVC) image-registry-storage. Le PVC est généré en fonction de la classe de stockage par défaut. Cependant, il faut savoir que la classe de stockage par défaut peut fournir des volumes ReadWriteOnce (RWO), tels qu'un RADOS Block Device (RBD), ce qui peut poser des problèmes lors de la réplication sur plusieurs répliques.

4. Vérifier l'état de clusteroperator:

   $ oc get clusteroperator image-registry

   Exemple de sortie

   NAME             VERSION                              AVAILABLE   PROGRESSING   DEGRADED   SINCE   MESSAGE
   image-registry   4.7                                  True        False         False      6h50m

Procédure

1. Pour définir le stockage du registre d'images comme un type de stockage en bloc, corrigez le registre afin qu'il utilise la stratégie de déploiement Recreate et qu'il s'exécute avec la seule réplique 1:

   $ oc patch config.imageregistry.operator.openshift.io/cluster --type=merge -p '{"spec":{"rolloutStrategy":"Recreate","replicas":1}}'

2. Provisionnez le PV pour le périphérique de stockage en bloc et créez un PVC pour ce volume. Le volume bloc demandé utilise le mode d'accès ReadWriteOnce (RWO).

   1. Créez un fichier pvc.yaml avec le contenu suivant pour définir un objet VMware vSphere PersistentVolumeClaim:

      kind: PersistentVolumeClaim
      apiVersion: v1
      metadata:
        name: image-registry-storage 1
        namespace: openshift-image-registry 2
      spec:
        accessModes:
        - ReadWriteOnce 3
        resources:
          requests:
            storage: 100Gi 4

      1

      Un nom unique qui représente l'objet PersistentVolumeClaim.

      2

      L'espace de noms de l'objet PersistentVolumeClaim, qui est openshift-image-registry.

      3

      Le mode d'accès de la demande de volume persistant. Avec ReadWriteOnce, le volume peut être monté avec des autorisations de lecture et d'écriture par un seul nœud.

      4

      Taille de la demande de volume persistant.

   2. Créer l'objet PersistentVolumeClaim à partir du fichier :

      $ oc create -f pvc.yaml -n openshift-image-registry

3. Modifiez la configuration du registre de manière à ce qu'elle fasse référence au PVC correct :

   $ oc edit config.imageregistry.operator.openshift.io -o yaml

   Exemple de sortie

   storage:
     pvc:
       claim: 1

   1

   La création d'un PVC personnalisé vous permet de laisser le champ claim vide pour la création automatique par défaut d'un PVC image-registry-storage.

Procédure

1. Créez la demande de seau d'objets à l'aide de la classe de stockage ocs-storagecluster-ceph-rgw. Par exemple :

   cat <<EOF | oc apply -f -
   apiVersion: objectbucket.io/v1alpha1
   kind: ObjectBucketClaim
   metadata:
     name: rgwtest
     namespace: openshift-storage
   spec:
     storageClassName: ocs-storagecluster-ceph-rgw
     generateBucketName: rgwtest
   EOF

2. Obtenez le nom du seau en entrant la commande suivante :

   $ bucket_name=$(oc get obc -n openshift-storage rgwtest -o jsonpath='{.spec.bucketName}')

3. Obtenez les informations d'identification AWS en entrant les commandes suivantes :

   $ AWS_ACCESS_KEY_ID=$(oc get secret -n openshift-storage rgwtest -o yaml | grep -w "AWS_ACCESS_KEY_ID:" | head -n1 | awk '{print $2}' | base64 --decode)

   $ AWS_SECRET_ACCESS_KEY=$(oc get secret -n openshift-storage rgwtest -o yaml | grep -w "AWS_SECRET_ACCESS_KEY:" | head -n1 | awk '{print $2}' | base64 --decode)

4. Créez le secret image-registry-private-configuration-user avec les informations d'identification AWS pour le nouveau seau sous openshift-image-registry project en entrant la commande suivante :

   $ oc create secret generic image-registry-private-configuration-user --from-literal=REGISTRY_STORAGE_S3_ACCESSKEY=${AWS_ACCESS_KEY_ID} --from-literal=REGISTRY_STORAGE_S3_SECRETKEY=${AWS_SECRET_ACCESS_KEY} --namespace openshift-image-registry

5. Créez une route de cryptage pour Ceph RGW en entrant la commande suivante :

   $ oc create route reencrypt <route_name> --service=rook-ceph-rgw-ocs-storagecluster-cephobjectstore --port=https -n openshift-storage

   1. Obtenez l'hôte de la route en entrant la commande suivante :

      route_host=$(oc get route <route_name> -n openshift-storage -o=jsonpath='{.spec.host}')

6. Créez une carte de configuration qui utilise un certificat d'entrée en entrant les commandes suivantes :

   $ oc extract secret/router-certs-default  -n openshift-ingress  --confirm

   $ oc create configmap image-registry-s3-bundle --from-file=ca-bundle.crt=./tls.crt  -n openshift-config

7. Configurez le registre d'images pour utiliser le stockage d'objets Ceph RGW en entrant la commande suivante :

   $ oc patch config.image/cluster -p '{"spec":{"managementState":"Managed","replicas":2,"storage":{"managementState":"Unmanaged","s3":{"bucket":'\"${bucket_name}\"',"region":"us-east-1","regionEndpoint":'\"https://${route_host}\"',"virtualHostedStyle":false,"encrypt":false,"trustedCA":{"name":"image-registry-s3-bundle"}}}}}' --type=merge

Procédure

1. Créez la demande de seau d'objets à l'aide de la classe de stockage openshift-storage.noobaa.io. Par exemple :

   cat <<EOF | oc apply -f -
   apiVersion: objectbucket.io/v1alpha1
   kind: ObjectBucketClaim
   metadata:
     name: noobaatest
     namespace: openshift-storage
   spec:
     storageClassName: openshift-storage.noobaa.io
     generateBucketName: noobaatest
   EOF

2. Obtenez le nom du seau en entrant la commande suivante :

   $ bucket_name=$(oc get obc -n openshift-storage noobaatest -o jsonpath='{.spec.bucketName}')

3. Obtenez les informations d'identification AWS en entrant les commandes suivantes :

   $ AWS_ACCESS_KEY_ID=$(oc get secret -n openshift-storage noobaatest -o yaml | grep -w "AWS_ACCESS_KEY_ID:" | head -n1 | awk '{print $2}' | base64 --decode)

   $ AWS_SECRET_ACCESS_KEY=$(oc get secret -n openshift-storage noobaatest -o yaml | grep -w "AWS_SECRET_ACCESS_KEY:" | head -n1 | awk '{print $2}' | base64 --decode)

4. Créez le secret image-registry-private-configuration-user avec les informations d'identification AWS pour le nouveau seau sous openshift-image-registry project en entrant la commande suivante :

   $ oc create secret generic image-registry-private-configuration-user --from-literal=REGISTRY_STORAGE_S3_ACCESSKEY=${AWS_ACCESS_KEY_ID} --from-literal=REGISTRY_STORAGE_S3_SECRETKEY=${AWS_SECRET_ACCESS_KEY} --namespace openshift-image-registry

5. Obtenez l'hôte de la route en entrant la commande suivante :

   $ route_host=$(oc get route s3 -n openshift-storage -o=jsonpath='{.spec.host}')

6. Créez une carte de configuration qui utilise un certificat d'entrée en entrant les commandes suivantes :

   $ oc extract secret/router-certs-default  -n openshift-ingress  --confirm

   $ oc create configmap image-registry-s3-bundle --from-file=ca-bundle.crt=./tls.crt  -n openshift-config

7. Configurez le registre d'images pour utiliser le stockage d'objets Nooba en entrant la commande suivante :

   $ oc patch config.image/cluster -p '{"spec":{"managementState":"Managed","replicas":2,"storage":{"managementState":"Unmanaged","s3":{"bucket":'\"${bucket_name}\"',"region":"us-east-1","regionEndpoint":'\"https://${route_host}\"',"virtualHostedStyle":false,"encrypt":false,"trustedCA":{"name":"image-registry-s3-bundle"}}}}}' --type=merge