Container Registry:Générer des images sur une instance Container Registry Enterprise Edition

Prérequis

Avant de commencer, assurez-vous que :

• Vous avez créé une instance Container Registry Enterprise Edition. Pour plus d'informations, consultez la section « Étape 1 : Créer une instance Container Registry Enterprise Edition » de la rubrique Pousser une image vers une instance Container Registry Enterprise Edition et extraire une image depuis l'instance.

• Votre dépôt source contient un fichier Dockerfile pour la génération d'images.

Informations générales

Étape 1 : Lier votre instance à une plateforme d'hébergement de code

Étape 2 : Créer un namespace

Créez un namespace pour organiser vos dépôts d'images. L'activation de la création automatique de dépôt vous permet de configurer des paramètres par défaut appliqués à tous les dépôts sous ce 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 pour laquelle vous souhaitez créer un namespace.

5. Dans le volet de navigation de gauche, choisissez Repository > Namespace.

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

7. Dans la boîte de dialogue Create Namespace, configurez le paramètre Namespace et définissez le paramètre Automatically Create Repository sur On ou Off. Cliquez ensuite sur Confirm.

   Si vous définissez le paramètre Automatically Create Repository sur On, configurez les paramètres suivants :

   Paramètre	Description
   Repository Type	Sélectionnez Public ou Private. Public : Par défaut, les images publiques nécessitent que les utilisateurs se connectent à l'instance avant de pouvoir les extraire. Pour autoriser les extractions anonymes, activez le paramètre d'extraction publique anonyme de l'instance. Étant donné que les dépôts publics peuvent être extraits par des utilisateurs non autorisés, définissez les dépôts sur Private pour protéger vos données. Private : Les utilisateurs doivent se connecter à l'instance et disposer d'une autorisation d'extraction (Pull) avant de pouvoir extraire des images privées.
   Immutable Image Tags	Sélectionnez Flexible ou Immutable. Lorsque ce paramètre est défini sur Immutable, toutes les balises d'image, à l'exception de latest, ne peuvent pas être écrasées.
   Accelerated Image	Lorsque cette option est activée, une version accélérée de chaque image est automatiquement générée après le push de l'image. La balise de l'image accélérée comporte le suffixe _accelerated.

Étape 3 : Créer un dépôt d'images

Créez un dépôt d'images et liez-le à un dépôt de code source. Toutes les images générées à partir de ce dépôt de code source seront poussées vers ce dépôt 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 que vous souhaitez gérer.

5. Dans le volet de navigation de gauche, choisissez Repository > Repositories.

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

7. Dans l'assistant Repository Info, configurez les paramètres Namespace, Repository Name, Repository Type, Image Version, Accelerated Image, Summary et Description. Cliquez ensuite sur Next.

8. À l'étape Code Source, configurez les paramètres Code Source, Build Settings et Build Rules, puis cliquez sur Create Repository.

9. Le tableau suivant décrit les paramètres de Build Settings :

   Paramètre	Description
   Automatically Build Images When Code Changes	Lorsque cette option est activée, la règle de génération est automatiquement déclenchée lorsque du code est validé dans une branche.
   Build With Servers Deployed Outside Chinese Mainland	Activez cette option si votre source de code se trouve sur GitHub ou Bitbucket, ou si votre Dockerfile télécharge des dépendances depuis l'étranger et que la connexion réseau transfrontalière est instable. ACR utilise un lien accéléré pour extraire les sources de données externes pendant la génération. Cette option n'est disponible que dans certaines régions. Si l'option n'apparaît pas lors de la création d'un dépôt d'images, la région actuelle ne prend pas en charge cette fonctionnalité.
   Build Without Cache	Lorsque cette option est activée, ACR extrait l'image de base depuis la source à chaque fois, en ignorant les couches mises en cache. Cela peut ralentir les générations. Désactivez cette option pour utiliser les couches mises en cache et accélérer les builds.

   Sur la page Repositories, cliquez sur le dépôt d'images créé. Si l'option Build apparaît dans le volet de navigation de gauche de la page de gestion du dépôt, le dépôt d'images est lié au dépôt de code source.

Étape 4 : Générer une image

Configurez des règles de génération pour définir comment et quand ACR génère des images à partir de votre dépôt, puis déclenchez une génération et vérifiez le résultat.

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 > Repositories.

6. Sur la page Repositories, recherchez le dépôt d'images que vous avez créé et cliquez sur Manage dans la colonne Actions.

7. Dans le volet de navigation de gauche, cliquez sur Build. Dans la section Build Rules, cliquez sur Add Build Rule. À l'étape Build Information, configurez les paramètres suivants, puis cliquez sur Next.

   Paramètre	Description
   Type	Le type du dépôt de code source. Valeurs possibles : Branch et Tag.
   Branch/Tag	Sélectionnez ou saisissez une branche ou une balise. Les expressions régulières sont prises en charge. Par exemple, si vous saisissez release-(?<imageTag>\w*) , ACR génère automatiquement une image lorsque le code source de la branche release-v1 est mis à jour. Pour plus d'informations sur les groupes de capture nommés, consultez la rubrique Utiliser des expressions régulières dans les groupes de capture nommés . Remarque Lorsque vous utilisez une expression régulière, seul ACR peut déclencher des générations. Les générations manuelles ne sont pas prises en charge.
   Build Context Directory	Le répertoire contenant le Dockerfile, relatif à la racine de la branche ou de la balise. Par exemple, si la branche est master et que le Dockerfile se trouve à la racine de la branche, définissez ce paramètre sur /.
   Dockerfile Filename	Le nom du fichier Dockerfile. Le nom par défaut est Dockerfile.

8. À l'étape Tag, configurez les paramètres suivants, cliquez sur Save, puis sur Next.

   Remarque

   Cliquez sur Add Configuration pour ajouter des balises d'image. Vous pouvez ajouter jusqu'à trois balises d'image.

   Paramètre	Description
   Image Tag	La balise de l'image générée, par exemple latest. Les groupes de capture nommés sont pris en charge. Si vous avez défini un groupe de capture nommé dans Branch/Tag, référencez la valeur capturée ici.
   Build Time	(Facultatif) L'heure (UTC+8) à laquelle le code source est poussé. Formats acceptés : 20201015 ou 202010151613 . Remarque Si vous définissez ce paramètre, seul ACR peut déclencher des générations. Les générations manuelles ne sont pas prises en charge.
   Commit ID	(Facultatif) Le nombre de caractères à utiliser à partir de l'ID de validation (commit) du code poussé le plus récemment. Par défaut, les six premiers caractères sont utilisés. Ajustez le curseur pour modifier le nombre. Remarque Si vous définissez ce paramètre, seul ACR peut déclencher des générations. Les générations manuelles ne sont pas prises en charge.

9. À l'étape Build Configurations, configurez les paramètres suivants, puis cliquez sur Next.

   Paramètre	Description
   Build Architecture	Sélectionnez une ou plusieurs architectures cibles. Si vous sélectionnez plusieurs architectures, ACR génère une image distincte pour chaque architecture sous la même balise.
   Build Parameters	Paires clé-valeur transmises au processus de génération. Les noms de paramètres sont sensibles à la casse. Configurez jusqu'à 20 paramètres de génération en cliquant sur Add Configuration.

10. Déclenchez une génération en utilisant l'une des méthodes suivantes :

    • Dans la section Build Rules de la page Build, recherchez la règle de génération et cliquez sur Build dans la colonne Actions.

    • Poussez une validation de code vers la branche configurée du dépôt de code source pour déclencher automatiquement la règle de génération.

11. Surveillez la génération : Dans la section Build Log, recherchez la tâche de génération d'image et cliquez sur Log dans la colonne Actions pour afficher le journal de génération. Pour arrêter une génération en cours, cliquez sur Cancel dans la colonne Actions.

12. Vérifiez le résultat : Dans le volet de navigation de gauche, cliquez sur Image Tag. Si l'image que vous avez générée figure dans la liste, la génération a réussi.

    Dans le volet de navigation de gauche, cliquez sur Image Tag. Si l'image que vous avez créée s'affiche, cela signifie que l'image a été générée.

Exemples

Les deux exemples suivants illustrent des configurations courantes de règles de génération. L'exemple 1 présente une configuration simple prenant en charge les générations manuelles et automatiques. L'exemple 2 utilise une expression régulière pour créer des balises d'image versionnées à partir des noms de branches de publication (release) et ne prend en charge que les générations automatiques.

Étapes suivantes