Cette rubrique explique comment créer un dépôt d'images, configurer des règles de build et générer des images à l'aide d'une instance Personal Edition.
Notes d'utilisation
Le délai d'expiration du build d'image pour une instance Personal Edition est de 30 minutes. Si vous avez besoin de fonctionnalités avancées, telles que des configurations de build flexibles, des paramètres de build personnalisés et des builds multi-architectures, nous vous recommandons d'utiliser une instance Enterprise Edition pour générer vos images. Pour plus d'informations, consultez la section Générer des images à l'aide d'une instance Enterprise Edition.
Avant de générer des images avec une instance Personal Edition, assurez-vous que l'image de base définie dans votre Dockerfile respecte les exigences suivantes :
Vous pouvez utiliser n'importe quelle image publique ne nécessitant pas d'autorisation.
Vous pouvez utiliser des images privées appartenant au même compte et situées dans la même région que l'instance Personal Edition.
L'utilisation d'images privées provenant d'une autre région n'est pas autorisée.
L'utilisation d'images VPC, quelle que soit la région, n'est pas autorisée.
L'utilisation d'images sous licence tierce n'est pas autorisée.
Par exemple, l'image de base de votre Dockerfile peut être une image publique, mais elle ne doit pas être une image sous licence tierce.
Fonctionnalités
Pour utiliser la fonctionnalité de build, vous devez lier un dépôt de code source à votre instance Personal Edition. Vous pouvez effectuer cette opération après la création de l'instance.
-
Builds automatisés lors des modifications du code
Lorsque vous activez l'option Automatically Build Images When Code Changes, Container Registry génère automatiquement une image à chaque commit de code. Cela élimine le besoin de builds manuels.
Connectez-vous à la console Container Registry.
Dans la barre de navigation supérieure, sélectionnez une région.
Dans le volet de navigation de gauche, cliquez sur Instances.
Sur la page Instances, cliquez sur l'instance Personal Edition que vous souhaitez gérer.
Dans le volet de navigation de gauche, accédez à .
Sur la page Repositories, localisez le dépôt cible et cliquez sur Manage dans la colonne Actions.
-
Dans le volet de navigation de gauche, cliquez sur Build, puis activez l'interrupteur Automatically Build Images When Code Changes.
Les paramètres de build incluent également les interrupteurs Overseas build et Build without cache, qui sont tous deux désactivés par défaut.
-
Overseas build
Pendant le processus de build, votre code peut dépendre de sources situées en dehors de la Chine continentale. Pour ce scénario, Container Registry propose la fonctionnalité Build with Servers Deployed Outside Chinese Mainland. Une fois le build terminé sur une machine située à l'étranger, l'image est poussée vers le dépôt dans la région que vous avez spécifiée.
RemarqueDes connexions réseau instables depuis l'étranger vers la Chine continentale peuvent entraîner un dépassement du délai d'attente et l'échec du push de l'image.
-
Build without cache
Si vous activez l'option Build Without Cache, le processus de build récupère l'image de base à chaque fois, en ignorant les couches mises en cache. Cela peut augmenter les temps de build ; nous vous recommandons donc de laisser cette option désactivée.
-
Multi-stage build
Container Registry prend également en charge les builds multi-étapes.
Connectez-vous à la console Container Registry.
Dans la barre de navigation supérieure, sélectionnez une région.
Dans le volet de navigation de gauche, cliquez sur Instances.
Sur la page Instances, cliquez sur l'instance Personal Edition que vous souhaitez gérer.
Dans le volet de navigation de gauche, accédez à .
Sur la page Code Source, localisez GitHub et cliquez sur Bind Account dans la colonne Actions.
Dans la boîte de dialogue GitHub, cliquez sur Go to the source code repository to bind account.
-
Sur la page GitHub, saisissez votre nom d'utilisateur et votre mot de passe, puis cliquez sur Sign in.
Vous êtes redirigé vers la console Container Registry et le message You have successfully bound the GitHub account s'affiche.
Connectez-vous à la console Container Registry.
Dans la barre de navigation supérieure, sélectionnez une région.
Dans le volet de navigation de gauche, cliquez sur Instances.
Sur la page Instances, cliquez sur l'instance Personal Edition que vous souhaitez gérer.
Dans le volet de navigation de gauche, accédez à .
Sur la page Repositories, cliquez sur Create Repository.
-
À l'étape Repository Info de l'assistant, configurez les champs Namespace, Repository Name, Summary et Repository Type. Dans cet exemple, sélectionnez Private comme type de dépôt. Cliquez ensuite sur Next.
RemarqueLa fonctionnalité de build d'image n'est pas prise en charge pour les dépôts locaux.
-
À l'étape Code Source de l'assistant, configurez les champs Code Source, Build Settings et Build Rules, puis cliquez sur Create Repository.
Paramètre
Description
Code Source
Sélectionnez une source de code. Cet exemple utilise GitHub. Cliquez sur GitHub, puis sélectionnez un namespace et un dépôt.
Build Settings
-
Génération automatique d'images lors des modifications du code : déclenche la règle de build lorsque vous validez du code sur une branche.
-
Overseas build : génère des images dans un centre de données situé à l'étranger et les pousse vers la région spécifiée. Si votre tâche de build implique des ressources situées en Chine continentale, telles que le dépôt de code source et le dépôt d'images, nous vous recommandons de désactiver l'option Build with Servers Deployed Outside Chinese Mainland et d'utiliser un serveur de build en Chine continentale.
-
Build without cache : force la récupération des images de dépendance de base à chaque build, ce qui peut augmenter le temps de build. La désactivation de l'option Build Without Cache accélère la génération des images.
-
Connectez-vous à la console Container Registry.
Dans la barre de navigation supérieure, sélectionnez une région.
Dans le volet de navigation de gauche, cliquez sur Instances.
Sur la page Instances, cliquez sur l'instance Personal Edition que vous souhaitez gérer.
Dans le volet de navigation de gauche, accédez à .
Sur la page Repositories, localisez le dépôt cible et cliquez sur Manage dans la colonne Actions.
-
Dans le volet de navigation de gauche, cliquez sur Build. Dans la section Build Rules, cliquez sur Add Build Rule.
RemarquePour modifier une règle de build, localisez la règle cible et cliquez sur Modify dans la colonne Actions.
-
Dans la boîte de dialogue Add Build Rule, définissez les paramètres de la règle de build, puis cliquez sur Confirm.
Paramètre
Description
Type
Type de source à partir de laquelle effectuer le build. Valeurs valides : Branch et Tag.
Branch/Tag
Branche ou tag de code à utiliser pour le build.
Build Context Directory
Chemin d'accès au répertoire contenant le Dockerfile, relatif à la racine de la branche ou du tag spécifié. Par exemple, si votre Dockerfile se trouve dans le répertoire racine de la branche master, définissez ce paramètre sur
./.Dockerfile Filename
Nom du fichier Dockerfile. La valeur par défaut est
Dockerfile.Image Version
Tag de l'image générée, par exemple
latest. Connectez-vous à la console Container Registry.
Dans la barre de navigation supérieure, sélectionnez une région.
Dans le volet de navigation de gauche, cliquez sur Instances.
Sur la page Instances, cliquez sur l'instance Personal Edition que vous souhaitez gérer.
Dans le volet de navigation de gauche, accédez à .
Sur la page Repositories, localisez le dépôt cible et cliquez sur Manage dans la colonne Actions.
Dans le volet de navigation de gauche, cliquez sur Build.
-
Dans la section Build Rules, localisez la règle cible et cliquez sur Build dans la colonne Actions.
Une fois le build terminé, un nouvel enregistrement de build est généré.
RemarquePour afficher les journaux de build, cliquez sur Log dans la colonne Actions de l'enregistrement de build.
Une fois le build terminé, cliquez sur Image Version dans le volet de navigation de gauche pour afficher les images générées.
Pour afficher toutes les images, cliquez sur Build dans le volet de navigation de gauche. Dans la section Build Settings, activez les options Build with Servers Deployed Outside Chinese Mainland et Build Without Cache. L'option Automatically Build Images When Code Changes est activée par défaut. Cliquez ensuite sur Image Version dans le volet de navigation de gauche pour afficher tous les tags d'image.
Étape 1 : Lier une source de code
Cette section utilise GitHub comme exemple pour illustrer la liaison d'une source de code. Pour savoir comment lier d'autres sources de code, consultez la section Se connecter à une plateforme d'hébergement de code source.
ImportantPour accéder à une instance GitLab privée dans un VPC, consultez la section Générer des images de conteneur avec le mode de build sécurisé VPC.
Étape 2 : Créer un dépôt d'images
Avant de créer un dépôt d'images, vous devez disposer d'un namespace dans la région souhaitée. Pour plus d'informations, consultez la section Gérer les namespaces.
Étape 3 : Définir des règles de build
RemarqueSi l'option Build n'apparaît pas sur la page de gestion de votre dépôt d'images, cela signifie que la source de code n'est pas correctement liée. Consultez la section Étape 1 pour la lier à nouveau.
Étape 4 : Générer une image
Étapes suivantes