Tous les produits
Search

Ce produit

    Container Registry:Pousser et extraire des charts avec Helm 2

    Centre de documentation

    Container Registry:Pousser et extraire des charts avec Helm 2

    Dernière mise à jour :Aug 18, 2026

    Helm est un gestionnaire de packages pour Kubernetes qui permet d'empaqueter, de gérer et de déployer des applications. Une fois un chart créé ou mis à jour, poussez-le vers un référentiel Helm pour le mettre à la disposition d'autres utilisateurs.

    Étape 1 : Configurer l'instance Enterprise Edition

    1. Créez 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. Sur la page de gestion de l'instance Enterprise Edition, choisissez Helm Chart > Namespace dans le volet de navigation de gauche.

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

      6. Dans la boîte de dialogue Create Namespace, saisissez un nom de Namespace, spécifiez les options Automatically Create Repository et Default Configurations for Automatically Created Repositories, puis cliquez sur Confirm.

    2. Créez un référentiel de charts.

      Remarque

      Si vous activez l'option Automatically Create Repository pour le namespace, vous pouvez ignorer la création d'un référentiel de charts dans la console et pousser directement les charts depuis votre client.

      Dans une instance Enterprise Edition, l'adresse d'un référentiel de charts suit le format <instance-name>-chart.<region-id>.cr.aliyuncs.com/<namespace>/<repository-name>. Une version de chart utilise le format <chart-name>-<version-number>. Pour accéder au référentiel via un VPC, le format d'adresse est <instance-name>-chart-vpc.<region-id>.cr.aliyuncs.com/<namespace>/<repository-name>.

      1. Sur la page Overview de l'instance Enterprise Edition, dans la section Component Settings, activez l'interrupteur Charts.

      2. Sur la page de gestion de l'instance Enterprise Edition, choisissez Helm Chart > Chart Repositories dans le volet de navigation de gauche.

      3. Sur la page Chart Repository, cliquez sur Create Chart Repository.

      4. Dans la boîte de dialogue Create Helm Chart, sélectionnez un Namespace, définissez le Chart Repository Name et le Type, puis cliquez sur Confirm.

    3. Configurez un identifiant d'accès.

      Vous pouvez utiliser un mot de passe fixe ou un jeton temporaire comme identifiant d'accès pour vos charts Helm. Cet exemple utilise un mot de passe fixe.

      1. Sur la page de gestion de l'instance Enterprise Edition, choisissez Instances > Access Credentials dans le volet de navigation de gauche.

      2. Sur la page Access Credentials, cliquez sur Set Password.

      3. Dans la boîte de dialogue Set Password, saisissez un Password et une Confirm Password, puis cliquez sur Confirm.

    4. Configurez une politique de contrôle d'accès.

      Activez l'accès via Internet ou depuis un VPC spécifique pour télécharger des charts Helm. Cet exemple montre comment configurer l'accès Internet. Pour plus d'informations sur la configuration du contrôle d'accès pour un VPC, consultez la rubrique Configurer le contrôle d'accès VPC.

      1. Sur la page de gestion de l'instance Enterprise Edition, choisissez Helm Chart > Access Control dans le volet de navigation de gauche.

      2. Sur la page Access Control, cliquez sur l'onglet Internet.

      3. Sur l'onglet Internet, activez l'interrupteur Enable Access over Internet et cliquez sur Add Internet Whitelist.

      4. Dans la boîte de dialogue Add Internet Whitelist, saisissez les plages CIDR autorisées et leurs descriptions, puis cliquez sur Confirm.

    5. (Facultatif) Activez l'option Pull from Anonymous Users.

      Une fois l'option Pull from Anonymous Users activée, vous pouvez extraire des charts publics sans vous 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. Sur la page Instances, cliquez sur l'instance Enterprise Edition à gérer.

      5. Dans la section Instance Settings située à droite de la page Overview, activez l'interrupteur Pull from Anonymous Users.

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

    Étape 2 : Installer et configurer le client

    1. Téléchargez une version de Helm depuis le site officiel.

      Remarque

      Assurez-vous que votre client Helm est une version v2. Exécutez la commande helm version -c pour vérifier la version du client. Ces étapes utilisent la version 2.14.2 à titre d'exemple.

    2. Exécutez les commandes suivantes pour décompresser le package Helm et le déplacer vers un répertoire spécifié.

      # Decompress the package.
tar -zxvf helm-v2.14.2-linux-amd64.tgz
# Move the package to a specified directory.
mv linux-amd64/helm /usr/local/bin/helm

    3. Installez le plug-in Helm.

      Remarque

      Vous devez installer Git avant d'installer le plug-in Helm.

      Si vous vous trouvez en dehors de la Chine continentale ou si vous disposez d'une connexion stable à GitHub, exécutez la commande suivante pour installer le plug-in Helm.

      helm plugin install https://github.com/AliyunContainerService/helm-acr

    4. Initialisez l'environnement Helm.

      • Si vous êtes sur un nœud d'un cluster Container Service for Kubernetes (ACK), Tiller est initialisé par défaut ; il vous suffit donc d'initialiser le client. Pour éviter d'accéder aux sources de charts Google, exécutez la commande suivante :

        helm init --client-only --skip-refresh

      • Sur un nœud d'un cluster Kubernetes autogéré, exécutez la commande suivante pour éviter d'accéder aux sources de charts Google :

        helm init --skip-refresh

    Étape 3 : Pousser et extraire des charts

    1. Exécutez les commandes suivantes pour configurer un mappage de référentiel local.

      Vous devez spécifier un nom de référentiel local et le mapper à un référentiel de charts dans un namespace spécifique.

      export HELM_REPO_USERNAME='<username-of-your-access-credential>';
export HELM_REPO_PASSWORD='<password-of-your-access-credential>';
helm repo add <local-repository-name> acr://<instance-name>-chart.<region-id>.cr.aliyuncs.com/<namespace>/<repository-name> --username ${HELM_REPO_USERNAME} --password ${HELM_REPO_PASSWORD}

    2. Poussez un chart.

      1. Exécutez les commandes suivantes pour pousser un chart.

        # Create a chart locally.
helm create <chart-name>
# Push the chart directory.
helm cm-push <chart-name> <local-repository-name>
# Or, push a compressed chart package.
helm cm-push <chart-name>-<chart-version>.tgz <local-repository-name>            
        xxx# helm create chartname
Creating chartname
xxx# helm push chartname localChart
Pushing chartname-0.1.0.tgz to localChart...
Done.
xxx#

      Sur la page Chart Repository, cliquez sur le nom du référentiel de charts, puis cliquez sur Versions. Sur la page Versions, vous pouvez consulter le nouveau chart.

    3. Exécutez les commandes suivantes pour extraire un chart.

      # Update the local chart index.
helm repo update
# Pull the chart.
helm fetch <local-repository-name>/<chart-name> --version <chart-version>
# Or, install the chart directly.
helm install -f values.yaml <local-repository-name>/<chart-name> --version <chart-version>