Créer un pipeline et une version dans la console Google Cloud

Créer un pipeline et une version dans la console Google Cloud

Cette page explique comment utiliser la console Google Cloud pour créer un pipeline de diffusion Cloud Deploy, puis créer une version pour ce pipeline.

Dans ce guide de démarrage rapide, vous allez:

1. Créez deux clusters GKE ou configurez deux services Cloud Run.

2. Créez un pipeline de diffusion et deux cibles à l'aide de la console Google Cloud.

3. Instanciez votre pipeline de diffusion en créant une version à l'aide de la console Google Cloud.

   Une fois cette version créée, l'application est automatiquement déployée sur la cible.

4. Consultez les résultats dans la console Google Cloud.

Avant de commencer

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage APIs.

   Enable the APIs

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

   Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.

7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

8. Make sure that billing is enabled for your Google Cloud project.

9. Enable the Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage APIs.

   Enable the APIs

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

    Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.

Si la CLI est déjà installée, assurez-vous d'exécuter la dernière version:

gcloud components update

Créer votre environnement d'exécution

Si vous effectuez un déploiement sur Cloud Run, vous pouvez ignorer cette commande.

Pour GKE, créez deux clusters : quickstart-cluster-for-console-staging et quickstart-cluster-for-console-prod, avec les paramètres par défaut. Les points de terminaison de l'API Kubernetes des clusters doivent être accessibles sur le réseau depuis l'Internet public. Les clusters GKE sont accessibles en externe par défaut.

gcloud container clusters create-auto quickstart-cluster-for-console-staging \
                 --project=PROJECT_ID \
                 --region=us-central1 && \
gcloud container clusters create-auto quickstart-cluster-for-console-prod \
                 --project=PROJECT_ID \
                 --region=us-central1

Créer un pipeline de livraison et deux cibles

Vous pouvez utiliser Cloud Deploy pour créer un pipeline de diffusion et des cibles en fonction de la configuration spécifiée dans un ou plusieurs fichiers YAML. Vous pouvez également créer un pipeline de diffusion à l'aide de la console Google Cloud.

Dans cette section, vous allez utiliser la console Google Cloud pour créer un pipeline de diffusion et deux cibles. Lorsque vous utilisez la console Google Cloud, vous n'avez pas besoin de créer de fichiers YAML. Cloud Deploy crée votre fichier skaffold.yaml et votre fichier manifeste à votre place.

1. Dans la console Google Cloud, accédez à la page principale de Cloud Deploy.

   Ouvrir la page Pipelines de diffusion

2. Cliquez sur Créer.

   

   Le formulaire Créer un pipeline de livraison s'affiche.

3. Dans le champ Nom du pipeline, remplacez le texte par défaut par in-console-quickstart-pipeline.

4. Si vous le souhaitez, saisissez une description pour ce pipeline de livraison.

5. Dans le menu déroulant Région, sélectionnez us-central1.

6. Sélectionnez votre environnement d'exécution.

   Si vous déployez sur GKE, sélectionnez Google Kubernetes Engine. Sinon, sélectionnez Cloud Run.

7. Créez vos cibles:

   GKE

   1. Sous Nouvelle cible, dans le champ Nom de la cible, remplacez le texte par défaut par console-staging.

   2. Dans le menu déroulant Cluster Kubernetes Engine, sélectionnez quickstart-cluster-for-console-staging.

   3. Cliquez sur OK.

   4. Cliquez sur Ajouter une cible.

      Remplacez le texte par défaut de Nom de la cible par console-prod.

   5. Sélectionnez quickstart-cluster-for-console-prod dans le menu déroulant Cluster Kubernetes Engine.

   6. Sélectionnez Nécessite une approbation pour les déploiements.

      Pour ce guide de démarrage rapide, nous exigeons une approbation pour la deuxième cible, mais pas pour la première.

   7. Cliquez sur Créer pour créer ce pipeline de diffusion.

      

   Cloud Run

   1. Sous Nouvelle cible, dans le champ Nom de la cible, remplacez le texte par défaut par console-staging.

   2. Dans le menu déroulant Région, sélectionnez us-central1.

   3. Cliquez sur OK.

   4. Cliquez sur Ajouter une cible.

   5. Remplacez le texte par défaut de Nom de la cible par console-prod.

   6. Activez la case Nécessite une approbation pour les déploiements pour cette cible.

      Pour ce guide de démarrage rapide, nous exigeons une approbation pour la deuxième cible, mais pas pour la première.

   7. Cliquez sur Créer pour créer ce pipeline de diffusion.

      

   Remarque :Si le compte de service Compute Engine par défaut ne dispose pas des autorisations nécessaires, vous pouvez cliquer sur le bouton Accorder pour les ajouter lorsque vous y êtes invité.

   Vous disposez désormais d'un pipeline de livraison avec deux cibles, prêt à créer une version.
   La page du pipeline s'affiche, avec les deux cibles, sans déploiement.

   

Créer une version

Maintenant que vous disposez d'un pipeline de diffusion avec deux cibles pointant vers deux clusters GKE ou deux services Cloud Run, vous pouvez créer une version pour déployer votre application sur la première cible.

1. Si vous n'êtes pas déjà sur la page du pipeline de diffusion, qui affiche le nouveau pipeline de diffusion in-console-quickstart-pipeline, accédez-y maintenant.

   La visualisation du pipeline s'affiche, sans déploiement.

2. Cliquez sur le bouton Créer une version.

   La boîte de dialogue Créer une version s'affiche. La plupart des champs sont préremplis. Conservez ces valeurs par défaut.

   

   Vous pouvez cliquer sur le bouton Afficher le fichier manifeste pour afficher le fichier manifeste généré automatiquement pour l'une ou l'autre cible, et sur Afficher le fichier Skaffold pour afficher le fichier skaffold.yaml généré. Vous pouvez également les modifier, mais pour ce guide de démarrage rapide, laissez-les tels quels.

3. Ajoutez éventuellement une description de cette version dans le champ Description.

4. Cliquez sur Créer pour lancer la publication.

   La page d'informations sur le déploiement s'affiche pour le déploiement vers la première cible. Vous pouvez suivre la progression de ce déploiement. Cette opération prend quelques minutes. Le déploiement peut prendre quelques secondes.

5. Une fois le premier déploiement terminé, cliquez sur le nom du pipeline de diffusion pour accéder à la page du pipeline de diffusion.

   

   La visualisation du pipeline s'affiche, avec le déploiement terminé pour la première cible.

   

6. Cliquez sur Promouvoir pour lancer le déploiement sur la cible suivante.

   La boîte de dialogue Promote (Promouvoir) s'affiche.

7. Conservez les valeurs par défaut, ajoutez une description du déploiement si vous le souhaitez, puis cliquez sur Promouvoir.

   Comme nous avons sélectionné Nécessite une approbation pour les déploiements lorsque nous avons créé la deuxième cible, cette promotion est en attente d'approbation.

8. Dans la visualisation du pipeline de diffusion, cliquez sur Vérifier.

   La page d'approbation s'affiche.

   

9. Cliquez à nouveau sur Examiner, puis dans la boîte de dialogue d'approbation, cliquez sur Approuver.

   Le déploiement est lancé pour la deuxième cible. Vous pouvez à nouveau cliquer sur le nom du pipeline de diffusion pour suivre la progression dans la visualisation du pipeline.

Une fois le deuxième déploiement terminé, l'application est déployée dans la deuxième cible et votre pipeline de diffusion est terminé.

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 :

1. Supprimez les clusters GKE ou les services Cloud Run:

   GKE

   gcloud container clusters delete quickstart-cluster-for-console-staging --region=us-central1 --project=PROJECT_ID \
   && gcloud container clusters delete quickstart-cluster-for-console-prod --region=us-central1 --project=PROJECT_ID
   

   Cloud Run

   gcloud run services delete in-console-quickstart-pipeline-target-1 --region=us-central1 --project=PROJECT_ID \
   && gcloud run services delete in-console-quickstart-pipeline-target-2 --region=us-central1 --project=PROJECT_ID
   

2. Sur la page du pipeline de diffusion, cliquez sur Supprimer pour supprimer le pipeline de diffusion, la version et les déploiements.

   Saisissez le nom du pipeline dans le champ prévu à cet effet, puis cliquez sur Confirmer pour terminer de supprimer les ressources.

   

3. Supprimez les deux cibles:

   gcloud deploy targets delete console-staging --region=us-central1  && \
   gcloud deploy targets delete console-prod --region=us-central1
   

4. Supprimez les buckets Cloud Storage créés par Cloud Deploy.

   L'un se termine par _clouddeploy et l'autre par [region].deploy-artifacts.[project].appspot.com.

   uvrez la page du navigateur Cloud Storage

Voilà ! Vous avez terminé le guide de démarrage rapide.

Étape suivante

• En savoir plus sur Cloud Deploy

• Découvrez les principes de base du déploiement d'applications.

• Suivez le tutoriel de Cloud Deploy.

• Découvrez comment gérer vos fichiers manifestes.

• Découvrez comment combiner les outils CI/CD Google Cloud pour développer et déployer efficacement des logiciels sur GKE.