Tous les produits
Search
Centre de documentation

Container Registry:Utiliser Helm 3.7 ou une version ultérieure pour pousser et extraire des charts

Dernière mise à jour :Sep 25, 2026

Stockez et gérez les charts Helm en tant qu'artefacts Open Container Initiative (OCI) dans une instance Container Registry Enterprise Edition. La prise en charge des artefacts OCI est stable dans Helm depuis la version 3.7.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

  • Helm 3.7 ou une version ultérieure installé. Exécutez helm version pour vérifier la version.

  • Une instance Container Registry Enterprise Edition.

  • Un compte Alibaba Cloud avec accès à la console Container Registry.

Étape 1 : Configurer votre instance Enterprise Edition

Créer un namespace

  1. Connectez-vous à la console Container Registry.

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

  3. Sur la page Instances, cliquez sur l'instance Enterprise Edition à gérer.

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

  5. Cliquez sur Create Namespace.

  6. Dans la boîte de dialogue Create Namespace, définissez les paramètres Namespace et Automatically Create Repository, puis cliquez sur Confirm.

Créer un dépôt d'images

  1. Dans le volet de navigation de gauche, choisissez Repositories > Repositories.

  2. Cliquez sur Create Repository.

  3. À l'étape Repository Info, configurez les champs Namespace, Repository Name, Repository Type, Tags, Accelerated Image, Summary et Description, puis cliquez sur Next.

  4. À l'étape Code Source, configurez les paramètres Code Source, Build Settings et Build Rules, puis cliquez sur Create Repository. Pour confirmer que le dépôt est lié à un dépôt de code source, cliquez sur le dépôt dans la page Repositories et vérifiez la présence de l'option Build dans le volet de navigation de gauche.

    Parameter

    Description

    Code Source

    Dépôt de code source à lier à ce dépôt d'images

    Automatically Build Images When Code Changes

    Déclenche automatiquement une build lorsque du code est validé dans la branche liée

    Build with Servers Deployed Outside Chinese Mainland

    Construit les images sur des serveurs situés à l'étranger et les pousse vers la région cible. Activez cette option lorsque votre Dockerfile extrait des ressources depuis l'étranger et que la connexion transfrontalière est instable.

    Build Without Cache

    Télécharge l'image de base à chaque build. Désactivez cette option pour accélérer les builds en réutilisant les couches mises en cache

Configurer un identifiant d'accès

Définissez un mot de passe comme identifiant d'accès pour votre instance Enterprise Edition.

  1. Dans le volet de navigation de gauche, choisissez Instances > Access Credentials.

  2. Cliquez sur Password.

  3. Dans la boîte de dialogue Set Password, saisissez et confirmez votre mot de passe, puis cliquez sur Confirm.

Un jeton temporaire peut également servir d'identifiant d'accès.

Configurer les politiques d'accès

Activez l'accès Internet pour permettre le push et le pull des charts vers et depuis l'instance.

  1. Dans le volet de navigation de gauche, choisissez Repositories > Access Control.

  2. Cliquez sur l'onglet Internet.

  3. Activez l'option Enable Access over Internet, puis cliquez sur Add Internet Whitelist.

  4. Dans la boîte de dialogue Add Internet Whitelist, spécifiez le bloc CIDR à autoriser et une description facultative, puis cliquez sur Confirm.

Pour utiliser l'accès VPC au lieu de l'accès Internet, consultez Configurer une liste de contrôle d'accès VPC .

(Facultatif) Activer l'extraction anonyme

Activez l'option Pull from Anonymous Users pour permettre à tout utilisateur d'extraire des charts depuis les dépôts publics de cette instance sans se connecter.

  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. Cliquez sur l'instance Enterprise Edition à gérer.

  5. Sur la page Overview, dans la section Instance Settings, activez l'option Pull from Anonymous Users.

  6. Dans la boîte de dialogue Tips, cliquez sur Confirm.

Étape 2 : Pousser et extraire des charts

Activer la prise en charge OCI

Exécutez la commande suivante pour activer la prise en charge des artefacts OCI dans Helm 3.7 :

export HELM_EXPERIMENTAL_OCI=1

Se connecter à l'instance

Remplacez <registry-logon-name> par le nom de votre compte Alibaba Cloud. Remplacez <instance-name> et <region-id> par les détails de votre instance.

helm3 registry login -u <registry-logon-name> <instance-name>-registry.cn-<region-id>.cr.aliyuncs.com

Lorsque vous y êtes invité, saisissez le mot de passe défini à l'étape précédente.

Exemple :

helm3 registry login -u acr_test_***@test.aliyunid.com ***-registry.cn-hangzhou.cr.aliyuncs.com
Si l'option Pull from Anonymous Users est activée sur la page Overview , les charts des dépôts publics peuvent être extraits sans connexion.

Créer et empaqueter un chart

  1. Créez un exemple de chart HelloWorld :

    helm3 create helloworld
  2. Empaquetez le répertoire du chart dans une archive compressée :

    tar -zcvf test.tgz helloworld

Pousser un chart

L'URI OCI pour le push doit se terminer par le namespace, et non par le nom du dépôt. Le nom du dépôt est lu directement depuis le package du chart.

helm3 push test.tgz oci://<instance-name>-registry.cn-<region-id>.cr.aliyuncs.com/<namespace>

Exemple :

helm3 push test.tgz oci://***-registry.cn-hangzhou.cr.aliyuncs.com/test

Extraire et installer un chart

L'URI OCI pour l'extraction doit se terminer par le nom du dépôt, suivi de --version pour spécifier le tag de l'image.

  1. Extrayez le package du chart :

    helm3 pull oci://<instance-name>-registry.cn-<region-id>.cr.aliyuncs.com/<namespace>/<repository-name> --version <image-tag>

    Exemple :

    helm3 pull oci://***-registry.cn-hangzhou.cr.aliyuncs.com/test/trem --version helloworld
  2. Décompressez le package du chart :

    tar -xzvf helloworld-<image-tag>.tgz
  3. Installez le chart :

    helm install helloworld ./helloworld

Étapes suivantes