Stocker des charts Helm dans Artifact Registry
Helm est le gestionnaire de packages des Kubernetes. Elle utilise des graphiques qui définissent un ensemble de ressources Kubernetes à déployer.
Ce guide de démarrage rapide vous montre comment :
- Créer un dépôt privé dans Artifact Registry
- Créer un exemple de graphique
- S'authentifier auprès du dépôt
- Transférer le graphique vers le dépôt
- Déployer le graphique
Avant de commencer
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Artifact Registry, Google Kubernetes Engine APIs.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Artifact Registry, Google Kubernetes Engine APIs.
Choisir une interface système
Pour suivre ce guide de démarrage rapide, utilisez Cloud Shell ou votre interface système locale.
- Cloud Shell
- Cloud Shell est un environnement shell permettant de gérer les ressources hébergées sur Google Cloud. Il est préinstallé avec Docker, Helm et la Google Cloud CLI, l'interface de ligne de commande principale de Google Cloud.
- Interface système locale
- Si vous préférez utiliser votre interface système locale, vous devez installer Docker et la gcloud CLI dans votre environnement.
Démarrer Cloud Shell
Pour lancer Cloud Shell, procédez comme suit :
Accédez à Google Cloud Console.
Cliquez sur le bouton Activer Cloud Shell : .
Une session Cloud Shell s'ouvre dans un cadre situé en bas de la console. Cette interface système vous permet d'exécuter les commandes
gcloud
.Installez Helm 3.8.0 ou version ultérieure. Dans les versions précédentes de Helm, les graphiques au format OCI fonctionnalité expérimentale.
Exécutez
helm version
pour vérifier votre version.
Configurer une interface système locale
Pour installer la gcloud CLI et Helm, procédez comme suit:
Installez la CLI gcloud. Pour mettre à jour l'installation, exécutez la commande
gcloud components update
.Installez Helm 3.8.0 ou une version ultérieure. Dans les versions précédentes de Helm, la prise en charge des graphiques au format OCI est une fonctionnalité expérimentale.
Exécutez
helm version
pour vérifier votre version.
Créer un dépôt
Créez un dépôt Docker pour stocker l'exemple de graphique utilisé dans ce guide de démarrage rapide.
Console
Ouvrez la page Dépôts de la console Google Cloud.
Cliquez sur Créer un dépôt.
Spécifiez
quickstart-helm-repo
comme nom de dépôt.Choisissez le format Docker.
Sous Type d'emplacement, sélectionnez Région, puis l'emplacement
us-west1
.Cliquez sur Créer.
Le dépôt est ajouté à la liste des dépôts.
gcloud
Exécutez la commande suivante pour créer un dépôt Docker nommé
quickstart-helm-repo
à l'emplacementus-west1
avec la description "dépôt Docker".gcloud artifacts repositories create quickstart-helm-repo --repository-format=docker \ --location=us-west1 --description="Helm repository"
Exécutez la commande suivante pour vérifier que votre dépôt a bien été créé.
gcloud artifacts repositories list
Exécutez la commande gcloud artifacts
pour obtenir plus d'informations sur les commandes Artifact Registry.
Créer un graphique
Dans ce guide de démarrage rapide, vous allez créer un exemple de graphique nommé
hello-chart
- Accédez au répertoire dans lequel vous souhaitez créer le graphique.
Exécutez la commande suivante pour créer le graphique :
helm create hello-chart
Helm crée un répertoire nommé
hello-chart
avec un ensemble de charts par défaut . L'un des fichiers est Chart.yaml, qui inclut des informations sur le graphique.Emballez le graphique dans une archive.
helm package hello-chart/
Helm crée une archive nommée
hello-chart-0.1.0.tgz
à l'aide du nom du graphique et du numéro de version dansChart.yaml
.
S'authentifier avec le dépôt
Avant de pouvoir transférer ou installer des images, Helm doit s'authentifier auprès d'Artifact Registry.
Helm peut utiliser les paramètres de registre existants dans un fichier de configuration Docker. Si vous n'avez pas encore configuré Docker pour l'utiliser avec Artifact Registry, vous pouvez vous authentifier avec un jeton d'accès pour ce guide de démarrage rapide.
Pour en savoir plus sur l'authentification, consultez la section Configurer l'authentification pour Helm.
S'authentifier avec votre configuration Docker
Par défaut, Helm prend en charge les paramètres de registre dans le fichier de configuration Docker config.json. Helm trouve les paramètres de registre soit l'emplacement par défaut, soit l'emplacement spécifié par la DOCKER_CONFIG.
Si vous avez configuré Docker avec un outil d'aide à la connexion pour s'authentifier auprès d'Artifact Registry, de Helm utilise votre configuration existante pour les dépôts Docker Artifact Registry.
S'authentifier avec un jeton d'accès
Pour s'authentifier avec un jeton d'accès:
Obtenez un jeton d'accès en tant qu'identifiant lorsque vous vous authentifiez auprès d'Artifact Registry avec Helm.
Linux/macOS
Exécutez la commande suivante :
gcloud auth print-access-token | helm registry login -u oauth2accesstoken \ --password-stdin https://us-west1-docker.pkg.dev
Windows
Exécutez la commande suivante :
gcloud auth print-access-token ya29.8QEQIfY_... helm registry login -u oauth2accesstoken -p "ya29.8QEQIfY_..." \ https://us-west1-docker.pkg.dev/PROJECT-ID/REPOSITORY
Où :
oauth2accesstoken
est le nom d'utilisateur à utiliser pour s'authentifier avec un jeton d'accès.gcloud auth print-access-token
est la commande gcloud permettant d'obtenir un jeton d'accès. Votre jeton d'accès est le mot de passe utilisé pour l'authentification.
Helm est désormais authentifié avec Artifact Registry. Vous êtes prêt à Transférez le graphique vers le dépôt.
Transférer le graphique vers Artifact Registry
Une fois que vous avez créé votre archive de graphiques et que vous vous êtes authentifié auprès du dépôt Artifact Registry, vous pouvez transférer le graphique vers le dépôt.
Pour transférer le graphique, exécutez la commande suivante:
helm push hello-chart-0.1.0.tgz oci://us-west1-docker.pkg.dev/PROJECT/quickstart-helm-repo
Remplacez PROJECT par l'ID de votre projet Google Cloud.
Helm utilise les valeurs de Chart.yaml
pour l'image :
- Le nom du graphique est le nom de l'image :
hello-chart
- La version du graphique est la balise d'image :
0.1.0
Helm renvoie un résultat semblable à l'exemple suivant :
Login Succeeded
Pushed: us-west1-docker.pkg.dev/my-project/quickstart-helm-repo/hello-chart:0.1.0
Digest: sha256:67a72...
Exécutez la commande suivante pour vérifier que le graphique est maintenant stocké dans le dépôt :
gcloud artifacts docker images list us-west1-docker.pkg.dev/PROJECT/quickstart-helm-repo
Le résultat de la commande ressemble à ceci :
Listing items under project my-project, location us-west1, repository quickstart-helm-repo.
IMAGE: us-west1-docker.pkg.dev/my-project/quickstart-helm-repo/hello-chart
DIGEST: sha256:67a72...
CREATE_TIME: 2021-11-08T22:59:57
UPDATE_TIME: 2021-11-08T22:59:57
Vous pouvez maintenant déployer une version à l'aide du graphique stocké dans Artifact Registry.
Déployer le graphique
Dans Helm, une instance déployée de votre application est appelée version. Après que vous avez ajouté votre dépôt à la configuration Helm, vous pouvez déployer publication de votre graphique.
Créez un cluster nommé
chart-cluster
pour votre déploiement à l'aide de la commande suivante:gcloud container clusters create --zone us-west1-a chart-cluster
Une fois le cluster créé, la commande renvoie un résumé semblable à celui-ci : l'exemple suivant:
kubeconfig entry generated for chart-cluster. NAME: chart-cluster LOCATION: us-west1-a MASTER_VERSION: 1.20.10-gke.1600 MASTER_IP: 34.66.36.211 MACHINE_TYPE: e2-medium NODE_VERSION: 1.20.10-gke.1600 NUM_NODES: 3 STATUS: RUNNING
Obtenez les identifiants du cluster afin que
kubectl
puisse y accéder :gcloud container clusters get-credentials --zone us-west1-a chart-cluster
Exécutez la commande suivante pour déployer une version de
hello-chart
en utilisant les fichiers du graphique extraits localement:helm install hello-chart oci://us-west1-docker.pkg.dev/PROJECT/quickstart-helm-repo/hello-chart --version 0.1.0
La commande renvoie un résumé du déploiement:
NAME: hello-chart LAST DEPLOYED: Mon Nov 8 23:15:13 2021 NAMESPACE: default STATUS: deployed REVISION: 1
Vous avez déployé une version à l'aide du graphique que vous avez créé. transférées vers Artifact Registry.
Effectuer un nettoyage
Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Google Cloud, procédez comme suit :
Supprimez le dépôt que vous avez créé à l'aide de la commande suivante :
gcloud artifacts repositories delete quickstart-helm-repo --location=us-west1
Supprimez le cluster que vous avez créé :
gcloud container clusters delete --zone=us-west1-a chart-cluster
Étape suivante
- En savoir plus sur l'utilisation des graphiques
- En savoir plus sur Helm
- Consultez nos ressources sur le DevOps et découvrez notre programme de recherche.