Déployer une application conteneurisée sur Cloud Run à l'aide de Cloud Build

Déployer une application conteneurisée sur Cloud Run à l'aide de Cloud Build

Cette page vous explique comment utiliser Cloud Build pour déployer une application conteneurisée dans Cloud Run.

Remarque : Ce guide de démarrage rapide vous explique comment déployer une image dans Cloud Run, mais sachez que Cloud Build accepte les déploiements sur d'autres plates-formes comme App Engine, GKE et les fonctions Cloud Run.

Vous pouvez également utiliser Cloud Deploy pour configurer un pipeline de livraison continue afin de déployer dans Cloud Run.

---

Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée :

Visite guidée

---

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 sans frais 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.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Cloud Run, Artifact Registry, and Compute Engine APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Installez la Google Cloud CLI.

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.

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

gcloud init

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Cloud Run, Artifact Registry, and Compute Engine APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Installez la Google Cloud CLI.

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.

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

gcloud init

Si vous avez déjà installé Google Cloud CLI, assurez-vous de disposer de la dernière version disponible en exécutant la commande gcloud components update.

Accorder des autorisations

Cloud Build requiert plusieurs autorisations avant de pouvoir déployer une image dans Cloud Run. Pour accorder ces autorisations, procédez comme suit :

1. Ouvrez une fenêtre de terminal.

2. Définissez les variables d'environnement pour stocker l'ID et le numéro de votre projet.

   PROJECT_ID=$(gcloud config list --format='value(core.project)')
   PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format='value(projectNumber)')
   

3. Accordez le rôle Administrateur Cloud Run à votre compte de service Cloud Build.

   gcloud projects add-iam-policy-binding $PROJECT_ID \
       --member=serviceAccount:$(gcloud projects describe $PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --role=roles/run.admin \
   

4. Attribuez le rôle Utilisateur d'objets de stockage à votre compte de service Cloud Build.

   gcloud projects add-iam-policy-binding $PROJECT_ID \
       --member=serviceAccount:$(gcloud projects describe $PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --role=roles/storage.objectUser \
   

5. Attribuez le rôle Utilisateur du compte de service à votre compte de service Cloud Build.

   gcloud projects add-iam-policy-binding $PROJECT_ID \
       --member=serviceAccount:$(gcloud projects describe $PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --role=roles/iam.serviceAccountUser
   

   Remarque : Le rôle Utilisateur du compte de service accorde des autorisations trop permissives au compte de service Cloud Build. Lorsque vous configurez Cloud Build pour effectuer un déploiement sur Cloud Run dans un environnement de production, nous vous recommandons vivement de configurer le compte de service Cloud Build de sorte qu'il emprunte l'identité d'un compte de service Cloud Run existant. Pour en savoir plus, consultez Configurer l'emprunt d'identité d'un compte de service Cloud Build pour les services gérés.

Déployer une image prédéfinie

Vous pouvez configurer Cloud Build pour qu'il déploie une image prédéfinie stockée dans Artifact Registry dans Cloud Run.

Pour déployer une image prédéfinie, procédez comme suit :

1. Ouvrez une fenêtre de terminal (si aucune n'est déjà ouverte).

2. Créez un répertoire nommé helloworld et accédez-y :

   mkdir helloworld
   cd helloworld
   

3. Créez un fichier nommé cloudbuild.yaml avec le contenu suivant : Il s'agit du fichier de configuration de Cloud Build. Il contient des instructions permettant à Cloud Build de déployer l'image nommée us-docker.pkg.dev/cloudrun/container/hello sur le service Cloud Run nommé cloudrunservice.

   steps:
   - name: 'gcr.io/cloud-builders/gcloud'
     script: |
       gcloud run deploy cloudrunservice --image us-docker.pkg.dev/cloudrun/container/hello --region us-central1 --platform managed --allow-unauthenticated

4. Déployez l'image en exécutant la commande suivante :

   gcloud builds submit --region=us-west2 --config cloudbuild.yaml
   

Une fois la compilation terminée, un résultat semblable aux lignes suivantes doit s'afficher :

DONE
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

ID                                    CREATE_TIME                DURATION  SOURCE                                                                                            IMAGES  STATUS
784653b2-f00e-4c4b-9f5f-96a5f115bef4  2020-01-23T14:53:13+00:00  23S       gs://cloudrunqs-project_cloudbuild/source/1579791193.217726-ea20e1c787fb4784b19fb1273d032df2.tgz  -       SUCCESS

Vous venez de déployer l'image hello dans Cloud Run.

Exécuter l'image déployée

1. Ouvrez la page Cloud Run dans la console Google Cloud  :

   Ouvrez la page Cloud Run

2. Sélectionnez votre projet et cliquez sur Ouvrir.

   La page Services Cloud Run s'affiche.

3. Dans le tableau, recherchez la ligne portant le nom cloudrunservice, puis cliquez sur cloudrunservice.

   La page Informations sur le service de cloudrunservice s'affiche.

4. Pour exécuter l'image que vous avez déployée sur cloudrunservice, cliquez sur l'URL :

   

Étape suivante

• Apprenez à compiler à l'aide de Cloud Build.
• Découvrez comment créer un fichier de configuration de compilation de base.
• Découvrez comment afficher les résultats de la compilation.
• Découvrez d'autres façons de déployer sur Cloud Run.
• Découvrez comment déployer sur Google Kubernetes Engine.
• Apprenez-en plus sur les ressources DevOps.
• Découvrez le programme de recherche DevOps.