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 déploiement 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 consoleGoogle Cloud .

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

    Une fois cette version créée, l'application est automatiquement déployée dans 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.

    Go to project selector

  3. Verify 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. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  7. Pour initialiser la gcloud CLI, exécutez la commande suivante :

    gcloud init
  8. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  9. Verify that billing is enabled for your Google Cloud project.

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

    Enable the APIs

  11. Install the Google Cloud CLI.

  12. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  13. Pour initialiser la gcloud CLI, exécutez la commande suivante :

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

    Dans cette section, vous allez utiliser la console Google Cloud pour créer un pipeline de livraison 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 pour vous.

    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.

      Page principale de Cloud Deploy dans la console Google Cloud

      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. (Facultatif) 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 livraison.

        Page principale Cloud Deploy dans la console Google Cloud

      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. Cochez 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 livraison.

        Page principale Cloud Deploy dans la console Google Cloud

      Vous disposez maintenant d'un pipeline de livraison avec deux cibles. Vous pouvez créer une version.
      La page du pipeline s'affiche, montrant les deux cibles, sans déploiements.

      Nouveau pipeline de diffusion créé dans la console Google Cloud

    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 livraison affichant le nouveau pipeline de livraison 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.

      Boîte de dialogue **Créer une version**

      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 des cibles. Vous pouvez également cliquer 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. Vous pouvez également ajouter une description pour cette version dans le champ Description.

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

      La page des détails du 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 livraison pour accéder à la page correspondante.

      Cliquez sur le nom du pipeline pour afficher la visualisation.

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

      Visualisation du pipeline de diffusion avec la première cible terminée

    6. Cliquez sur Promouvoir pour commencer 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 du déploiement si vous le souhaitez, puis cliquez sur Promouvoir.

      Comme nous avons sélectionné Nécessite une approbation pour les déploiements lors de la création de 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.

      Approbation requise pour la promotion vers la deuxième cible

    9. Cliquez de 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 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 déploiement est terminé.

    Pipeline de livraison terminé.

    Effectuer un nettoyage

    Pour éviter que les ressources utilisées dans cette démonstration 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.

      Boîte de dialogue de confirmation pour supprimer le pipeline et les ressources enfants. target

    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 est [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