Container Registry:Pousser et extraire des images

Prérequis

• Vous disposez d'un compte Alibaba Cloud. Inscrivez-vous pour un compte Alibaba Cloud.

• Docker Engine est installé. Installez et utilisez Docker Engine et Docker Compose.

• OSS est activé. Container Registry Enterprise Edition dépend d'OSS. Activez OSS.

• Container Registry ne permet pas de télécharger directement des images depuis la console. Vous devez utiliser la ligne de commande Docker : exécutez docker login pour vous connecter à l'instance, docker tag pour étiqueter l'image, puis docker push pour pousser l'image vers le référentiel.

Étape 1 : Créer une instance Enterprise Edition

1. Connectez-vous à la console Container Registry.

2. Dans la barre de navigation supérieure, sélectionnez une région.

3. Dans le volet de navigation de gauche, cliquez sur Instances.

4. Sur la page Instances, cliquez sur Create ACR EE.

5. Sur la page Create ACR EE, configurez les informations de base et cliquez sur Buy Now.

   Paramètre	Description
   Region	Sélectionnez la région de déploiement de l'instance.
   Specification	Sélectionnez un type d'instance. Les types disponibles sont décrits dans Qu'est-ce qu'Alibaba Cloud Container Registry (ACR) ?.
   Name	Saisissez un nom d'instance.
   Instance Storage	Valeurs valides : Default et Custom. Default : Un bucket OSS est automatiquement créé dans votre compte pour stocker les images. Custom : Sélectionnez un bucket OSS existant pour stocker les images.
   Select Bucket	Sélectionnez un bucket OSS existant pour stocker les images. Remarque Ce paramètre est requis uniquement lorsque vous définissez Instance Storage sur Custom.
   Security Scan	Sélectionnez un moteur d'analyse : Trivy Scan Engine : Moteur open source. Détecte les vulnérabilités système et applicatives. Ne prend pas en charge les correctifs en un clic pour les vulnérabilités système. Security Center Scan Engine : Moteur Alibaba Cloud. Détecte les vulnérabilités système, les vulnérabilités applicatives, les risques liés aux lignes de base et les échantillons malveillants. Prend en charge les correctifs en un clic pour les vulnérabilités système.
   Quota de référentiels	Par défaut : 1 000 (Basic), 3 000 (Standard), 5 000 (Advanced). Vous pouvez augmenter le quota selon vos besoins.
   Quota de namespaces	Par défaut : 15 (Basic), 25 (Standard), 50 (Advanced). Vous pouvez augmenter le quota selon vos besoins.
   Quota de contrôle d'accès VPC	Achetez ce quota si votre service extrait des images via un VPC. Facturation.
   Subscription Duration	Vous pouvez sélectionner 1, 2, 3 ou 6 mois, ou de 1 à 5 ans. Remarque Le renouvellement automatique est également disponible.
   Resource Groups	Sélectionnez un groupe de ressources existant. Vous pouvez également cliquer sur Create Resource Group et, dans la boîte de dialogue qui s'affiche, saisir l'identifiant du groupe de ressources et le Resource Group Name, puis cliquez sur Confirm.

6. Sur la page Confirm Order, vérifiez les Parameters, consultez les Conditions de service et l'accord de niveau de service (SLA), puis cliquez sur Payment.

7. Sur la page Pay, vérifiez le coût total et effectuez le paiement.

   Sur la page Instances, la nouvelle instance affiche l'état Starting. Après 2 à 3 minutes, l'état passe à Running.

Étape 2 : Obtenir le nom d'utilisateur du référentiel

• Si vous utilisez un compte Alibaba Cloud, le nom du compte correspond à votre nom d'utilisateur pour le référentiel d'images.

• Si vous utilisez un utilisateur RAM, votre nom d'utilisateur correspond à la partie de l'UPN située avant .onaliyun.com. Par exemple, si l'UPN de votre utilisateur RAM est 123@123456781011**.onaliyun.com, votre nom d'utilisateur est 123@123456781011**.

Étape 3 : Définir le mot de passe du référentiel

Pour pousser et extraire des images, vous avez besoin d'identifiants fixes. Configurez les identifiants d'accès.

Étape 4 : Créer un namespace

1. Connectez-vous à la console Container Registry.

2. Dans la barre de navigation supérieure, sélectionnez une région.

3. Dans le volet de navigation de gauche, cliquez sur Instances.

4. Sur la page Instances, cliquez sur l'instance Enterprise Edition cible.

5. Dans le volet de navigation de gauche de la page des détails de l'instance, choisissez Repository > Namespace.

6. Sur la page Namespace, cliquez sur Create Namespace.

7. Dans le volet latéral Create Namespace, définissez le nom du Namespace, activez On ou désactivez Off l'option Automatically Create Repository, puis cliquez sur Confirm.

   Si vous sélectionnez On pour Automatically Create Repository, suivez les étapes ci-dessous :

   Élément d'interface utilisateur	Description
   Repository Type	Public : Par défaut, les utilisateurs doivent se connecter à l'instance Enterprise Edition pour extraire des images publiques. Pour autoriser les extractions anonymes, vous devez activer l'accès anonyme pour l'instance. Nous vous recommandons de définir le type de référentiel sur Private afin de garantir la sécurité des données. Private : Pour extraire des images privées, les utilisateurs doivent se connecter à l'instance Enterprise Edition et disposer des autorisations d'extraction requises.
   Immutable Image Tags	Flexible. Si vous sélectionnez cette option, les tags d'image de ce référentiel autres que latest ne peuvent pas être écrasés, ce qui garantit la cohérence des tags d'image de conteneur.
   Accelerated Image	Indique si la fonctionnalité est Off. Si vous cochez la case, un tag d'image accélérée avec le suffixe _accelerated est automatiquement généré dans le référentiel.

Étape 5 : Créer un référentiel d'images

1. Connectez-vous à la console Container Registry.

2. Dans la barre de navigation supérieure, sélectionnez une région.

3. Dans le volet de navigation de gauche, cliquez sur Instances.

4. Sur la page Instances, cliquez sur l'instance Enterprise Edition cible.

5. Dans le volet de navigation de gauche de la page des détails de l'instance, choisissez Repository > Repositories.

6. Sur la page Repositories, cliquez sur Create Repository.

7. Dans l'assistant Repository Info, configurez le Namespace, le Repository Name, le Repository Type, la Image Version, l'Accelerated Image, le Summary et la Description. Cliquez ensuite sur Next.

8. Dans l'assistant Code Source, configurez la Code Source, les Build Settings et les Build Rules. Cliquez ensuite sur Create Repository.

   Paramètre	Description
   Code Source	Sélectionnez une source de code.
   Build Settings	Automatically Build Images When Code Changes : Déclenche une build à chaque commit de code. Build With Servers Deployed Outside Chinese mainland : Construit les images en dehors de la Chine continentale et les pousse vers la région que vous avez spécifiée. Build Without Cache : Extrait toujours une image de base fraîche. Cela peut augmenter le temps de build.
   Build Rules	Après avoir créé le référentiel, configurez les règles de build sur la page de build. Construire des référentiels et des images.

Étape 6 : Configurer le contrôle d'accès

• Si votre client Docker se trouve dans un VPC, configurez le contrôle d'accès VPC pour lui permettre de se connecter. Configurer une liste de contrôle d'accès VPC.

• Si votre client Docker se connecte via Internet, configurez le contrôle d'accès Internet pour l'instance.

1. Connectez-vous à la console Container Registry.

2. Dans la barre de navigation supérieure, sélectionnez une région.

3. Dans le volet de navigation de gauche, cliquez sur Instances.

4. Sur la page Instances, cliquez sur l'instance Enterprise Edition que vous souhaitez gérer.

5. Dans le volet de navigation de gauche de la page des détails de l'instance, choisissez Repository > Access Control.

6. Sur la page Access Control, cliquez sur l'onglet Internet, activez l'interrupteur Enable Access over Internet, puis cliquez sur Add Internet Whitelist.

7. Dans la boîte de dialogue Add Internet Whitelist, saisissez le bloc CIDR de l'hôte de votre client Docker ainsi qu'une description, puis cliquez sur Confirm.

   Les clients Docker provenant du bloc CIDR spécifié peuvent alors accéder à l'instance.

   Important

   Si vous souhaitez autoriser tous les clients Docker sur Internet à accéder à l'instance, vous devez activer l'accès Internet et supprimer toutes les entrées de la liste blanche Internet. Remarque : L'exposition d'une instance à l'Internet public crée un risque de sécurité. Procédez avec prudence.

Étape 7 : Pousser et extraire une image

Exécutez les commandes suivantes depuis votre client Docker.

1. Connectez-vous au référentiel d'images :

   Remarque

   Si vous poussez vers ou extrayez depuis un référentiel d'images public, vous pouvez activer l'option Pull from Anonymous Users sur la page Overview de la console Container Registry. Cela vous permet d'extraire des images de manière anonyme sans vous connecter.

   docker login --username=<username> <instance_name>-registry.<region>.cr.aliyuncs.com

   Exemple :

   docker login --username=123@1234567810111213 m**-registry.cn-hangzhou.cr.aliyuncs.com

   Lorsque vous y êtes invité, saisissez le mot de passe obtenu à l'étape Étape 3 : Définir le mot de passe du référentiel. Le message login succeeded confirme la réussite de l'opération.

2. Poussez une image.

   1. Étiquetez l'image :

      docker tag <image_id> <instance_name>-registry.<region>.cr.aliyuncs.com/<namespace>/<repository_name>:<image_tag>

      Exemple :

      docker tag Digest m**-registry.cn-hangzhou.cr.aliyuncs.com/m**/test:latest

   2. Poussez l'image :

      docker push <instance_name>-registry.<region>.cr.aliyuncs.com/<namespace>/<repository_name>:<image_tag>

      Exemple :

      docker push m**-registry.cn-hangzhou.cr.aliyuncs.com/m**/test:latest

      Sur la page Repositories, cliquez sur le nom du référentiel cible et choisissez Image Version. Vérifiez que l'image poussée apparaît sur la page Image Version.

3. Extrayez l'image :

   docker pull <instance_name>-registry.<region>.cr.aliyuncs.com/<namespace>/<repository_name>:<image_tag>

   Exemple :

   docker pull m**-registry.cn-hangzhou.cr.aliyuncs.com/m**/test:latest

   Exécutez docker images pour vérifier que l'image apparaît dans la sortie.