Envoyer (push) et tirer (pull) des graphiques Helm vers un registre de conteneurs AzurePush and pull Helm charts to an Azure container registry

Pour gérer et déployer rapidement des applications pour Kubernetes, vous pouvez utiliser le Gestionnaire de package Helm open source.To quickly manage and deploy applications for Kubernetes, you can use the open-source Helm package manager. Avec Helm, les packages d’applications sont définis en tant que graphiques, lesquels sont collectés et stockés dans un référentiel de graphiques Helm.With Helm, application packages are defined as charts, which are collected and stored in a Helm chart repository.

Cet article explique comment stocker des dépôts de graphiques Helm dans un registre de conteneurs Azure en utilisant Helm 3 ou Helm 2.This article shows you how to host Helm charts repositories in an Azure container registry, using either a Helm 3 or Helm 2 installation. Dans beaucoup de scénarios, vous devez générer et charger vos propres graphiques pour les applications que vous développez.In many scenarios, you would build and upload your own charts for the applications you develop. Pour plus d’informations sur la génération de vos propres graphiques Helm, consultez le Guide pour les développeurs de graphiques Helm.For more information on how to build your own Helm charts, see the Chart Template Developer's Guide. Vous pouvez également stocker un graphique Helm existant à partir d’un autre dépôt Helm.You can also store an existing Helm chart from another Helm repo.

Important

La prise en charge des graphiques Helm dans Azure Container Registry est actuellement disponible en préversion.Support for Helm charts in Azure Container Registry is currently in preview. Les préversions sont mises à votre disposition après votre accord explicite des conditions d’utilisation supplémentaires.Previews are made available to you on the condition that you agree to the supplemental terms of use. Certains aspects de cette fonctionnalité sont susceptibles d’être modifiés avant la mise à disposition générale.Some aspects of this feature may change prior to general availability (GA).

Helm 3 ou Helm 2 ?Helm 3 or Helm 2?

Pour stocker, gérer et installer des graphiques Helm, vous utilisez un client Helm et la CLI Helm.To store, manage, and install Helm charts, you use a Helm client and the Helm CLI. Les versions majeures du client Helm incluent Helm 3 et Helm 2.Major releases of the Helm client include Helm 3 and Helm 2. Helm 3 prend en charge un nouveau format de graphique et n’installe plus le composant côté serveur Tiller.Helm 3 supports a new chart format and no longer installs the Tiller server-side component. Pour plus d’informations sur les différences entre les versions, consultez la FAQ sur les versions.For details on the version differences, see the version FAQ. Si vous avez déjà déployé des graphiques Helm 2, consultez cette page sur la migration de Helm 2 vers Helm 3.If you've previously deployed Helm 2 charts, see Migrating Helm v2 to v3.

Vous pouvez utiliser Helm 3 ou Helm 2 pour stocker des graphiques Helm dans Azure Container Registry, en suivant le workflow propre à chaque version :You can use either Helm 3 or Helm 2 to host Helm charts in Azure Container Registry, with workflows specific to each version:

  • Client Helm 3 : utilisez les commandes helm chart dans l’interface CLI Helm pour gérer les graphiques dans votre registre en tant qu’artefacts OCIHelm 3 client - use helm chart commands in the Helm CLI to manage charts in your registry as OCI artifacts
  • Client Helm 2 : utilisez les commandes az acr helm dans Azure CLI pour ajouter et gérer votre registre de conteneurs comme un référentiel de graphiques HelmHelm 2 client - use az acr helm commands in the Azure CLI to add and manage your container registry as a Helm chart repository

Informations supplémentairesAdditional information

  • Pour la plupart des scénarios, nous vous recommandons d’utiliser le workflow Helm 3 avec les commandes helm chart natives pour gérer les graphiques en tant qu’artefacts OCI.For most scenarios, we recommend using the Helm 3 workflow with native helm chart commands to manage charts as OCI artifacts.
  • À compter de Helm 3, les commandes az acr helm sont prises en charge dans le but d’assurer la compatibilité avec le client Helm 2 et son format de graphiques.As of Helm 3, az acr helm commands are supported for compatibility with the Helm 2 client and chart format. Le développement ultérieur de ces commandes n’est pas prévu pour le moment.Future development of these commands isn't currently planned. Consultez la feuille de route du produit.See the product roadmap.
  • Les graphiques Helm 2 ne peuvent pas être affichés ou gérés à l’aide du Portail Azure.Helm 2 charts cannot be viewed or managed using the Azure portal.

Utiliser le client Helm 3Use the Helm 3 client

PrérequisPrerequisites

  • Un registre de conteneurs Azure dans votre abonnement Azure.An Azure container registry in your Azure subscription. Si nécessaire, créez un registre en utilisant le portail Azure ou Azure CLI.If needed, create a registry using the Azure portal or the Azure CLI.
  • Client Helm version 3.1.0 ou ultérieure : exécutez helm version pour connaître votre version actuelle.Helm client version 3.1.0 or later - Run helm version to find your current version. Pour plus d’informations sur l’installation et la mise à niveau de Helm, consultez Installation de Helm.For more information on how to install and upgrade Helm, see Installing Helm.
  • Un cluster Kubernetes où vous allez installer un graphique Helm.A Kubernetes cluster where you will install a Helm chart. Si nécessaire, créez un cluster Azure Kubernetes Service.If needed, create an Azure Kubernetes Service cluster.
  • Azure CLI version 2.0.71 ou ultérieure : exécutez az --version pour connaître la version.Azure CLI version 2.0.71 or later - Run az --version to find the version. Si vous devez installer ou mettre à niveau, voir Installer Azure CLI.If you need to install or upgrade, see Install Azure CLI.

Workflow généralHigh level workflow

Avec Helm 3, vous pouvez :With Helm 3 you:

  • Créer un ou plusieurs référentiels Helm dans un registre de conteneurs Azure.Can create one or more Helm repositories in an Azure container registry
  • Stocker les graphiques Helm 3 dans un registre en tant qu’artefacts OCI.Store Helm 3 charts in a registry as OCI artifacts. La prise en charge de Helm 3 pour OCI est expérimentale.Currently, Helm 3 support for OCI is experimental.
  • Authentifiez-vous auprès du registre à l’aide de la commande helm registry login.Authenticate with your registry using the helm registry login command.
  • Utilisez les commandes helm chart dans la CLI Helm pour envoyer (push), tirer (pull) et gérer des graphiques Helm dans un registre.Use helm chart commands in the Helm CLI to push, pull, and manage Helm charts in a registry
  • Utiliser helm install pour installer des graphiques sur un cluster Kubernetes à partir d’un cache de référentiel local.Use helm install to install charts to a Kubernetes cluster from a local repository cache.

Pour obtenir des exemples, consultez les sections suivantes.See the following sections for examples.

Activer la prise en charge d’OCIEnable OCI support

Définissez la variable d’environnement suivante pour activer la prise en charge d’OCI dans le client Helm 3.Set the following environment variable to enable OCI support in the Helm 3 client. Actuellement, cette prise en charge est expérimentale.Currently, this support is experimental.

export HELM_EXPERIMENTAL_OCI=1

Créer un exemple de graphiqueCreate a sample chart

Créez un graphique de test à l’aide des commandes suivantes :Create a test chart using the following commands:

mkdir helmtest

cd helmtest
helm create hello-world

En guise d’exemple de base, accédez au dossier templates et supprimez son contenu :As a basic example, change directory to the templates folder and first delete the contents there:

cd hello-world/templates
rm -rf *

Dans le dossier templates, créez un fichier nommé configmap.yaml avec le contenu suivant :In the templates folder, create a file called configmap.yaml with the following contents:

cat <<EOF > configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: hello-world-configmap
data:
  myvalue: "Hello World"
EOF

Pour plus d’informations sur la création et l’exécution de cet exemple, consultez Getting Started dans la documentation Helm.For more about creating and running this example, see Getting Started in the Helm Docs.

Enregistrer le graphique dans le cache de registre localSave chart to local registry cache

Accédez au sous-répertoire hello-world.Change directory to the hello-world subdirectory. Ensuite, exécutez helm chart save pour enregistrer une copie du graphique localement et pour créer un alias composé du nom complet du registre (tout en minuscules), du dépôt cible et de l’étiquette cible.Then, run helm chart save to save a copy of the chart locally and also create an alias with the fully qualified name of the registry (all lowercase) and the target repository and tag.

Dans l’exemple suivant, le nom du registre est mycontainerregistry, le dépôt cible est hello-world et l’étiquette du graphique cible est v1. Remplacez ces valeurs par les valeurs appropriées à votre environnement :In the following example, the registry name is mycontainerregistry, the target repo is hello-world, and the target chart tag is v1, but substitute values for your environment:

cd ..
helm chart save . hello-world:v1
helm chart save . mycontainerregistry.azurecr.io/helm/hello-world:v1

Exécutez helm chart list pour vérifier que les graphiques ont bien été enregistrés dans le cache de registre local.Run helm chart list to confirm you saved the charts in the local registry cache. Le résultat se présente ainsi :Output is similar to:

REF                                                      NAME            VERSION DIGEST  SIZE            CREATED
hello-world:v1                                           hello-world       0.1.0   5899db0 3.2 KiB        2 minutes 
mycontainerregistry.azurecr.io/helm/hello-world:v1       hello-world       0.1.0   5899db0 3.2 KiB        2 minutes

S’authentifier auprès du registreAuthenticate with the registry

Exécutez la commande helm registry login dans l’interface CLI Helm 3 pour vous authentifier auprès du registre à l’aide des informations d’identification appropriées pour votre scénario.Run the helm registry login command in the Helm 3 CLI to authenticate with the registry using credentials appropriate for your scenario.

Par exemple, créez un principal de service Azure Active Directory avec des autorisations d’extraction et de transmission (rôle AcrPush) dans le registre.For example, create an Azure Active Directory service principal with pull and push permissions (AcrPush role) to the registry. Fournissez ensuite les informations d’identification du principal de service à helm registry login.Then supply the service principal credentials to helm registry login. L’exemple suivant fournit le mot de passe à l’aide d’une variable d’environnement :The following example supplies the password using an environment variable:

echo $spPassword | helm registry login mycontainerregistry.azurecr.io \
  --username <service-principal-id> \
  --password-stdin

Envoyer (push) le graphique vers Azure Container RegistryPush chart to Azure Container Registry

Exécutez la commande helm chart push dans l’interface CLI Helm 3 pour envoyer (push) le graphique vers le dépôt cible (spécifié avec son nom complet) :Run the helm chart push command in the Helm 3 CLI to push the chart to the fully qualified target repository:

helm chart push mycontainerregistry.azurecr.io/helm/hello-world:v1

Après une opération push réussie, la sortie ressemble à ceci :After a successful push, output is similar to:

The push refers to repository [mycontainerregistry.azurecr.io/helm/hello-world]
ref:     mycontainerregistry.azurecr.io/helm/hello-world:v1
digest:  5899db028dcf96aeaabdadfa5899db025899db025899db025899db025899db02
size:    3.2 KiB
name:    hello-world
version: 0.1.0

Répertorier les graphiques dans le référentielList charts in the repository

Comme avec les images stockées dans un registre de conteneurs Azure, vous pouvez utiliser les commandes az acr repository pour lister les référentiels hébergeant vos graphiques ainsi que les étiquettes et les manifestes des graphiques.As with images stored in an Azure container registry, you can use az acr repository commands to show the repositories hosting your charts, and chart tags and manifests.

Par exemple, exécutez az acr repository show pour voir les propriétés du référentiel que vous avez créé à l’étape précédente :For example, run az acr repository show to see the properties of the repo you created in the previous step:

az acr repository show \
  --name mycontainerregistry \
  --repository helm/hello-world

Le résultat se présente ainsi :Output is similar to:

{
  "changeableAttributes": {
    "deleteEnabled": true,
    "listEnabled": true,
    "readEnabled": true,
    "writeEnabled": true
  },
  "createdTime": "2020-03-20T18:11:37.6701689Z",
  "imageName": "helm/hello-world",
  "lastUpdateTime": "2020-03-20T18:11:37.7637082Z",
  "manifestCount": 1,
  "registry": "mycontainerregistry.azurecr.io",
  "tagCount": 1
}

Exécutez la commande az acr repository show-manifests pour voir les détails du graphique stocké dans le référentiel.Run the az acr repository show-manifests command to see details of the chart stored in the repository. Par exemple :For example:

az acr repository show-manifests \
  --name mycontainerregistry \
  --repository helm/hello-world --detail

La sortie, abrégée dans cet exemple, montre le paramètre configMediaType défini à application/vnd.cncf.helm.config.v1+json :Output, abbreviated in this example, shows a configMediaType of application/vnd.cncf.helm.config.v1+json:

[
  {
    [...]
    "configMediaType": "application/vnd.cncf.helm.config.v1+json",
    "createdTime": "2020-03-20T18:11:37.7167893Z",
    "digest": "sha256:0c03b71c225c3ddff53660258ea16ca7412b53b1f6811bf769d8c85a1f0663ee",
    "imageSize": 3301,
    "lastUpdateTime": "2020-03-20T18:11:37.7167893Z",
    "mediaType": "application/vnd.oci.image.manifest.v1+json",
    "tags": [
      "v1"
    ]

Tirer (pull) le graphique vers le cache localPull chart to local cache

Pour installer un graphique Helm sur Kubernetes, le graphique doit se trouver dans le cache local.To install a Helm chart to Kubernetes, the chart must be in the local cache. Dans cet exemple, commencez par exécuter helm chart remove pour supprimer le graphique local existant nommé mycontainerregistry.azurecr.io/helm/hello-world:v1 :In this example, first run helm chart remove to remove the existing local chart named mycontainerregistry.azurecr.io/helm/hello-world:v1:

helm chart remove mycontainerregistry.azurecr.io/helm/hello-world:v1

Exécutez helm chart pull pour télécharger le graphique du registre de conteneurs Azure dans votre cache local :Run helm chart pull to download the chart from the Azure container registry to your local cache:

helm chart pull mycontainerregistry.azurecr.io/helm/hello-world:v1

Exporter le graphique HelmExport Helm chart

Pour pouvoir travailler plus en détail sur le graphique, exportez-le dans un répertoire local à l’aide de la commande helm chart export.To work further with the chart, export it to a local directory using helm chart export. Par exemple, exportez le graphique que vous avez tiré dans le répertoire install :For example, export the chart you pulled to the install directory:

helm chart export mycontainerregistry.azurecr.io/helm/hello-world:v1 \
  --destination ./install

Pour afficher les informations relatives au graphique exporté dans le référentiel, exécutez la commande helm show chart dans le répertoire de l’exportation.To view information for the exported chart in the repo, run the helm show chart command in the directory where you exported the chart.

cd install
helm show chart hello-world

Helm retourne des informations détaillées sur la dernière version de votre graphique, comme indiqué dans l’exemple de sortie suivant :Helm returns detailed information about the latest version of your chart, as shown in the following sample output:

apiVersion: v2
appVersion: 1.16.0
description: A Helm chart for Kubernetes
name: hello-world
type: application
version: 0.1.0    

Installer le graphique HelmInstall Helm chart

Exécutez helm install pour installer le graphique Helm que vous avez tiré dans le cache local, puis exporté.Run helm install to install the Helm chart you pulled to the local cache and exported. Spécifiez un nom de version, par exemple myhelmtest, ou passez le paramètre --generate-name.Specify a release name such as myhelmtest, or pass the --generate-name parameter. Par exemple :For example:

helm install myhelmtest ./hello-world

La sortie après l’installation réussie du graphique est semblable à celle-ci :Output after successful chart installation is similar to:

NAME: myhelmtest
LAST DEPLOYED: Fri Mar 20 14:14:42 2020
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None

Pour vérifier l’installation, exécutez la commande helm get manifest.To verify the installation, run the helm get manifest command. La commande retourne les données YAML dans votre fichier de modèle configmap.yaml.The command returns the YAML data in your configmap.yaml template file.

Exécutez helm uninstall pour désinstaller la version du graphique sur votre cluster :Run helm uninstall to uninstall the chart release on your cluster:

helm uninstall myhelmtest

Supprimer un graphique Helm du référentielDelete a Helm chart from the repository

Pour supprimer un graphique du référentiel, utilisez la commande az acr repository delete.To delete a chart from the repository, use the az acr repository delete command. Exécutez la commande suivante, puis confirmez l’opération lorsque vous y êtes invité :Run the following command and confirm the operation when prompted:

az acr repository delete --name mycontainerregistry --image helm/hello-world:v1

Utiliser le client Helm 2Use the Helm 2 client

PrérequisPrerequisites

  • Un registre de conteneurs Azure dans votre abonnement Azure.An Azure container registry in your Azure subscription. Si nécessaire, créez un registre en utilisant le portail Azure ou Azure CLI.If needed, create a registry using the Azure portal or the Azure CLI.
  • Client Helm version 2.11.0 (pas une version RC) ou ultérieure : exécutez helm version pour trouver votre version actuelle.Helm client version 2.11.0 (not an RC version) or later - Run helm version to find your current version. Vous avez également besoin d’un serveur Helm (Tiller) initialisé dans un cluster Kubernetes.You also need a Helm server (Tiller) initialized within a Kubernetes cluster. Si nécessaire, créez un cluster Azure Kubernetes Service.If needed, create an Azure Kubernetes Service cluster. Pour plus d’informations sur l’installation et la mise à niveau de Helm, consultez Installation de Helm.For more information on how to install and upgrade Helm, see Installing Helm.
  • Azure CLI version 2.0.46 ou ultérieure : exécutez az --version pour trouver la version.Azure CLI version 2.0.46 or later - Run az --version to find the version. Si vous devez installer ou mettre à niveau, voir Installer Azure CLI.If you need to install or upgrade, see Install Azure CLI.

Workflow généralHigh level workflow

Avec Helm 2, vous pouvez :With Helm 2 you:

  • Configurer votre registre de conteneurs Azure comme référentiel de graphiques Helm unique.Configure your Azure container registry as a single Helm chart repository. Azure Container Registry gère la définition d’index quand vous ajoutez et supprimez des graphiques dans le référentiel.Azure Container Registry manages the index definition as you add and remove charts to the repository.
  • Vous authentifier auprès de votre registre de conteneurs Azure par le biais d’Azure CLI, qui met ensuite à jour automatiquement votre client Helm avec l’URI et les informations d’identification du registre.Authenticate with your Azure container registry via the Azure CLI, which then updates your Helm client automatically with the registry URI and credentials. Comme vous n’avez pas besoin de spécifier manuellement les détails de ce registre, les informations d’identification ne sont pas exposées dans l’historique des commandes.You don't need to manually specify this registry information, so the credentials aren't exposed in the command history.
  • Utiliser les commandes az acr helm dans Azure CLI pour ajouter votre registre de conteneurs Azure comme référentiel de graphiques Helm, et pour envoyer (push) et gérer les graphiques.Use the az acr helm commands in the Azure CLI to add your Azure container registry as a Helm chart repository, and to push and manage charts. Ces commandes d’Azure CLI wrappent les commandes du client Helm 2.These Azure CLI commands wrap Helm 2 client commands.
  • Ajouter le dépôt des graphiques de votre registre de conteneurs Azure à votre index de dépôt Helm local, avec prise en charge de la recherche dans les graphiques.Add the chart repository in your Azure container registry to your local Helm repo index, supporting chart search.
  • Utiliser helm install pour installer des graphiques sur un cluster Kubernetes à partir d’un cache de référentiel local.Use helm install to install charts to a Kubernetes cluster from a local repository cache.

Pour obtenir des exemples, consultez les sections suivantes.See the following sections for examples.

Ajouter le référentiel au client HelmAdd repository to Helm client

Ajoutez le référentiel de graphiques Helm de votre registre Azure Container Registry à votre client Helm à l’aide de la commande az acr helm repo add.Add your Azure Container Registry Helm chart repository to your Helm client using the az acr helm repo add command. Cette commande obtient un jeton d’authentification pour votre registre Azure Container Registry qui est utilisé par le client Helm.This command gets an authentication token for your Azure container registry that is used by the Helm client. Le jeton d’authentification reste valide pendant 3 heures.The authentication token is valid for 3 hours. Comme pour docker login, vous pouvez exécuter cette commande dans les futures sessions CLI pour authentifier votre client Helm auprès de votre référentiel de graphiques Helm Azure Container Registry :Similar to docker login, you can run this command in future CLI sessions to authenticate your Helm client with your Azure Container Registry Helm chart repository:

az acr helm repo add --name mycontainerregistry

Ajouter un exemple de graphique au dépôtAdd a sample chart to the repository

Créez d’abord un répertoire local sur ~/acr-helm, puis téléchargez le graphique stable/wordpress existant :First, create a local directory at ~/acr-helm, then download the existing stable/wordpress chart:

mkdir ~/acr-helm && cd ~/acr-helm
helm repo update
helm fetch stable/wordpress

Tapez ls pour lister le graphique téléchargé et notez la version de Wordpress indiquée dans le nom de fichier.Type ls to list the downloaded chart, and note the Wordpress version included in the filename. Comme la commande helm fetch stable/wordpress n’a pas spécifié de version particulière, la dernière version a été extraite.The helm fetch stable/wordpress command didn't specify a particular version, so the latest version was fetched. Dans l’exemple de sortie ci-dessous, la version du graphique Wordpress est 8.1.0 :In the following example output, the Wordpress chart is version 8.1.0:

wordpress-8.1.0.tgz

Envoyez le graphique vers votre référentiel de graphiques Helm dans Azure Container Registry en exécutant la commande az acr helm push dans Azure CLI.Push the chart to your Helm chart repository in Azure Container Registry using the az acr helm push command in the Azure CLI. Spécifiez le nom de votre graphique Helm téléchargé à l’étape précédente, par exemple wordpress-8.1.0.tgz :Specify the name of your Helm chart downloaded in the previous step, such as wordpress-8.1.0.tgz:

az acr helm push --name mycontainerregistry wordpress-8.1.0.tgz

Après quelques instants, Azure CLI signale que votre graphique est enregistré, comme dans l’exemple de sortie suivant :After a few moments, the Azure CLI reports that your chart is saved, as shown in the following example output:

{
  "saved": true
}

Répertorier les graphiques dans le référentielList charts in the repository

Pour utiliser le graphique chargé à l’étape précédente, vous devez mettre à jour l’index de référentiel Helm local.To use the chart uploaded in the previous step, the local Helm repository index must be updated. Vous pouvez réindexer les référentiels dans le client Helm, ou utiliser l’interface de ligne de commande Azure pour mettre à jour l’index de référentiel.You can reindex the repositories in the Helm client, or use the Azure CLI to update the repository index. Chaque fois que vous ajoutez un graphique à votre référentiel, cette étape doit être effectuée :Each time you add a chart to your repository, this step must be completed:

az acr helm repo add --name mycontainerregistry

Avec un graphique stocké dans votre référentiel et l’index mis à jour disponible localement, vous pouvez utiliser les commandes du client Helm standard pour la recherche ou l’installation.With a chart stored in your repository and the updated index available locally, you can use the regular Helm client commands to search or install. Pour lister tous les graphiques stockés dans votre référentiel, utilisez la commande helm search, en spécifiant le nom de votre propre registre de conteneurs Azure :To see all the charts in your repository, use the helm search command, providing your own Azure Container Registry name:

helm search mycontainerregistry

Le graphique Wordpress envoyé à l’étape précédente est répertorié, comme illustré dans l’exemple de sortie suivant :The Wordpress chart pushed in the previous step is listed, as shown in the following example output:

NAME                  CHART VERSION    APP VERSION    DESCRIPTION
helmdocs/wordpress    8.1.0           5.3.2          Web publishing platform for building blogs and websites.

Vous pouvez également répertorier les graphiques avec l’interface de ligne de commande Azure, en utilisant az acr helm list :You can also list the charts with the Azure CLI, using az acr helm list:

az acr helm list --name mycontainerregistry

Afficher des informations pour un graphique HelmShow information for a Helm chart

Pour afficher les informations relatives à un graphique spécifique dans le référentiel, utilisez la commande helm inspect.To view information for a specific chart in the repo, you can use the helm inspect command.

helm inspect mycontainerregistry/wordpress

Quand aucun numéro de version n’est fourni, la dernière version est utilisée.When no version number is provided, the latest version is used. Helm retourne des informations détaillées sur votre graphique, comme indiqué dans l’exemple de sortie condensé suivant :Helm returns detailed information about your chart, as shown in the following condensed example output:

apiVersion: v1
appVersion: 5.3.2
description: Web publishing platform for building blogs and websites.
engine: gotpl
home: http://www.wordpress.com/
icon: https://bitnami.com/assets/stacks/wordpress/img/wordpress-stack-220x234.png
keywords:
- wordpress
- cms
- blog
- http
- web
- application
- php
maintainers:
- email: containers@bitnami.com
  name: Bitnami
name: wordpress
sources:
- https://github.com/bitnami/bitnami-docker-wordpress
version: 8.1.0
[...]

Vous pouvez également afficher les informations pour un graphique à l’aide de la commande az acr helm show de l’interface de ligne de commande Azure.You can also show the information for a chart with the Azure CLI az acr helm show command. Là encore, la dernière version d’un graphique est retournée par défaut.Again, the latest version of a chart is returned by default. Vous pouvez ajouter --version pour lister une version spécifique d’un graphique, par exemple 8.1.0 :You can append --version to list a specific version of a chart, such as 8.1.0:

az acr helm show --name mycontainerregistry wordpress

Installer un graphique Helm à partir du référentielInstall a Helm chart from the repository

Vous installez le graphique Helm dans votre référentiel en spécifiant le nom du référentiel et le nom du graphique.The Helm chart in your repository is installed by specifying the repository name and the chart name. Utilisez le client Helm pour installer le graphique Wordpress :Use the Helm client to install the Wordpress chart:

helm install mycontainerregistry/wordpress

Conseil

Si vous procédez à l’envoi à votre référentiel de graphiques Helm Azure Container Registry et retournez ultérieurement dans une nouvelle session CLI, votre client Helm local a besoin d’un jeton d’authentification mis à jour.If you push to your Azure Container Registry Helm chart repository and later return in a new CLI session, your local Helm client needs an updated authentication token. Pour obtenir un nouveau jeton d’authentification, utilisez la commande az acr helm repo add.To obtain a new authentication token, use the az acr helm repo add command.

Les étapes suivantes sont effectuées pendant le processus d’installation :The following steps are completed during the install process:

  • Le client Helm recherche dans l’index de référentiel local.The Helm client searches the local repository index.
  • Le graphique correspondant est téléchargé à partir du référentiel Azure Container Registry.The corresponding chart is downloaded from the Azure Container Registry repository.
  • Le graphique est déployé à l’aide de Tiller dans votre cluster Kubernetes.The chart is deployed using the Tiller in your Kubernetes cluster.

À mesure que l’installation se poursuit, suivez les instructions fournies dans la sortie de commande pour afficher les URL et les informations d’identification WordPress.As the installation proceeds, follow the instructions in the command output to see the WorPress URLs and credentials. Vous pouvez également exécuter la commande kubectl get pods pour voir les ressources Kubernetes déployées par le biais du graphique Helm :You can also run the kubectl get pods command to see the Kubernetes resources deployed through the Helm chart:

NAME                                    READY   STATUS    RESTARTS   AGE
wordpress-1598530621-67c77b6d86-7ldv4   1/1     Running   0          2m48s
wordpress-1598530621-mariadb-0          1/1     Running   0          2m48s
[...]

Supprimer un graphique Helm du référentielDelete a Helm chart from the repository

Pour supprimer un graphique du référentiel, utilisez la commande az acr helm delete.To delete a chart from the repository, use the az acr helm delete command. Spécifiez le nom du graphique (wordpress ici) et la version à supprimer (8.1.0).Specify the name of the chart, such as wordpress, and the version to delete, such as 8.1.0.

az acr helm delete --name mycontainerregistry wordpress --version 8.1.0

Si vous souhaitez supprimer toutes les versions du graphique nommé, omettez le paramètre --version.If you wish to delete all versions of the named chart, leave out the --version parameter.

Le graphique continue d’être retourné quand vous exécutez helm search.The chart continues to be returned when you run helm search. Là encore, le client Helm ne met pas automatiquement à jour la liste des graphiques disponibles dans un référentiel.Again, the Helm client doesn't automatically update the list of available charts in a repository. Pour mettre à jour l’index de référentiel du client Helm, utilisez à nouveau la commande az acr helm repo add :To update the Helm client repo index, use the az acr helm repo add command again:

az acr helm repo add --name mycontainerregistry

Étapes suivantesNext steps