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

Cette page vous explique comment utiliser la console Google Cloud pour créer Pipeline de livraison 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éer un pipeline de livraison ; et deux cibles utilisant 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.

    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
  7. In the Google Cloud console, on the project selector page, select or create a Google Cloud 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
  12. 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 clusters Les points de terminaison de l'API Kubernetes doivent être accessible 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 diffusion 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. Mais vous pouvez aussi créer un pipeline de livraison à 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 tout fichier YAML Cloud Deploy crée votre skaffold.yaml et manifester 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. 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.

      Page principale de Cloud Deploy dans la console Google Cloud

    Cloud Run

    1. Sous Nouvelle cible, dans le champ Nom de la cible, remplacez la texte par défaut avec 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 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.

      Page principale de Cloud Deploy dans la console Google Cloud

    Vous disposez maintenant 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.

    Nouveau pipeline de livraison 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, le nouveau pipeline de livraison le pipeline in-console-quickstart-pipeline, et y accéder maintenant.

    La visualisation du pipeline s'affiche, 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érempli. Conservez ces valeurs par défaut.

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

    Vous pouvez cliquer sur le bouton View manifest (Afficher le fichier manifeste) pour afficher le fichier manifeste. généré automatiquement pour chaque cible, et vous pouvez cliquer sur Affichez le fichier Skaffold pour afficher le 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 du déploiement s'affiche. Elle correspond au déploiement sur la première cible. vous pouvez suivre la progression de ce déploiement. Cette opération prend quelques minutes terminé. 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.

    Cliquez sur le nom du pipeline pour afficher la visualisation.

    La visualisation du pipeline est affichée, le déploiement étant terminé jusqu'au cible.

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

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

    Parce que nous avons sélectionné l'option Exiger 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 une deuxième cible

  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 à 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é.

Pipeline de livraison 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. Supprimer les clusters GKE ou Cloud Run services:

    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 la livraison. le pipeline, la publication et les déploiements.

    Saisissez le nom du pipeline dans le champ prévu à cet effet, puis cliquez sur Confirmer pour pour terminer la suppression des ressources.

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

  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