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 livraison Cloud Deploy, puis créer une version pour ce pipeline.

Dans ce guide de démarrage rapide, vous allez effectuer les opérations suivantes:

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

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

3. Instanciez votre pipeline de livraison 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. 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.

2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

3. Vérifiez que la facturation est activée pour votre projet Google Cloud.

4. Activer les API Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage.

   Activer les API

5. Installez Google Cloud CLI.

6. Pour initialiser gcloudCLI, exécutez la commande suivante :

   gcloud init

   Remarque : Vous pouvez exécuter gcloud CLI dans la console Google Cloud sans installer Google Cloud CLI. Pour exécuter gcloud CLI dans la console Google Cloud, utilisez Cloud Shell.

7. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

8. Vérifiez que la facturation est activée pour votre projet Google Cloud.

9. Activer les API Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage.

   Activer les API

10. Installez Google Cloud CLI.

11. Pour initialiser gcloudCLI, exécutez la commande suivante :

    gcloud init

    Remarque : Vous pouvez exécuter gcloud CLI dans la console Google Cloud sans installer Google Cloud CLI. Pour exécuter gcloud CLI dans la console Google Cloud, utilisez Cloud Shell.

Si la CLI est déjà installée, assurez-vous d'utiliser 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 via le réseau depuis l'Internet public. Par défaut, les clusters GKE sont accessibles en externe.

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 livraison et des cibles en fonction de la configuration spécifiée dans un ou plusieurs fichiers YAML. Mais vous pouvez également créer un pipeline de livraison à l'aide de la console Google Cloud.

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

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 Pipeline name (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 la liste déroulante Région, sélectionnez us-central1.

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

   Si vous effectuez un déploiement 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 la liste déroulante 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 du champ Nom de la cible par console-prod.

   5. Sélectionnez quickstart-cluster-for-console-prod dans la liste déroulante Cluster Kubernetes Engine.

   6. Sélectionnez Exiger une approbation pour les déploiements.

      Dans ce guide de démarrage rapide, nous exigeons l'approbation de la deuxième cible, mais pas de la première.

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

      

   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 du champ Nom de la cible par console-prod.

   6. Cochez la case Exiger une approbation pour les déploiements pour cette cible.

      Dans ce guide de démarrage rapide, nous exigeons l'approbation de la deuxième cible, mais pas de la première.

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

      

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

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

   

Créer une version

Maintenant que vous disposez d'un pipeline de livraison 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 livraison affichant le nouveau pipeline de livraison in-console-quickstart-pipeline, accédez-y maintenant.

   La visualisation du pipeline est affichée, sans déploiement.

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

   La boîte de dialogue Create a release (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 View manifest (Afficher le fichier manifeste) pour afficher le fichier manifeste généré automatiquement, pour l'une des cibles, et vous pouvez cliquer sur View Skaffold file (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. Si vous le souhaitez, ajoutez une description pour cette version dans le champ Description.

4. Cliquez sur Créer pour démarrer la version.

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

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

   

   La visualisation du pipeline s'affiche, et le déploiement sur la première cible est terminé.

   

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

   La boîte de dialogue Promouvoir s'affiche.

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

   Étant donné que nous avons sélectionné Exiger une approbation pour les déploiements lorsque nous avons créé la deuxième cible, cette promotion est en attente d'approbation.

8. Cliquez sur Examiner dans la visualisation du pipeline de livraison.

   La page d'approbation s'affiche.

   

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

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

Une fois le second déploiement terminé, l'application est déployée dans la deuxième cible et votre pipeline de livraison 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 livraison, cliquez sur Supprimer pour supprimer le pipeline de livraison, la version et les déploiements.

   Saisissez le nom du pipeline dans le champ prévu à cet effet, puis cliquez sur Confirmer pour terminer la suppression des 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'une se termine par _clouddeploy, et l'autre [region].deploy-artifacts.[project].appspot.com.

   uvrez la page du navigateur Cloud Storage

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

Étapes suivantes

• Apprenez-en plus sur Cloud Deploy.

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

• Suivez le tutoriel Cloud Deploy.

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

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