Guide de démarrage rapide : déployer dans Cloud Run à partir d'un dépôt Git

Guide de démarrage rapide : déployer dans Cloud Run à partir d'un dépôt Git

Cette page vous explique comment effectuer un déploiement continu à partir d'un dépôt Git vers Cloud Run.

---

Pour obtenir des instructions détaillées sur cette tâche directement dans la console Google Cloud , cliquez sur Visite guidée :

Visite guidée

---

Pour en savoir plus sur ce processus, consultez la section Déploiement continu à partir de Git à l'aide de Cloud Build.

Avant de commencer

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.
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
Verify that billing is enabled for your Google Cloud project.
Make sure that you have the following role or roles on the project: Cloud Run Admin, Cloud Run Source Developer, Logs Viewer
Check for the roles
1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
1. In the Google Cloud console, go to the IAM page.

   Accéder à IAM
2. Sélectionnez le projet.
3. Cliquez sur  Accorder l'accès.

4. Dans le champ Nouveaux comptes principaux, saisissez votre identifiant utilisateur. Il s'agit généralement de l'adresse e-mail d'un compte Google.

5. Dans la liste Sélectionner un rôle, sélectionnez un rôle.
6. Pour attribuer des rôles supplémentaires, cliquez sur  Ajouter un autre rôle et ajoutez tous les rôles supplémentaires.
7. Cliquez sur Enregistrer.

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

Verify that billing is enabled for your Google Cloud project.

Make sure that you have the following role or roles on the project: Cloud Run Admin, Cloud Run Source Developer, Logs Viewer

Check for the roles

1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

Grant the roles

1. In the Google Cloud console, go to the IAM page.

   Accéder à IAM
2. Sélectionnez le projet.
3. Cliquez sur  Accorder l'accès.

4. Dans le champ Nouveaux comptes principaux, saisissez votre identifiant utilisateur. Il s'agit généralement de l'adresse e-mail d'un compte Google.

5. Dans la liste Sélectionner un rôle, sélectionnez un rôle.
6. Pour attribuer des rôles supplémentaires, cliquez sur  Ajouter un autre rôle et ajoutez tous les rôles supplémentaires.
7. Cliquez sur Enregistrer.

1. Enable the Cloud Build API.

   Enable the API

2. Si vous êtes soumis à une règle d'administration de restriction de domaine limitant les appels non authentifiés pour votre projet, vous devez accéder au service déployé comme décrit dans la section Tester les services privés.

3. Assurez-vous que le rôle Utilisateur du compte de service vous a été attribué pour l'identité de service. Par défaut, l'identité de service est le compte de service Compute Engine par défaut.

   Attribuer les rôles

   Pour accorder l'accès à la ressource d'identité de service, utilisez la commande gcloud iam service-accounts add-iam-policy-binding en remplaçant les variables en surbrillance par les valeurs appropriées :

         gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
             --member="PRINCIPAL" \
             --role="roles/iam.serviceAccountUser"
         

   Remplacez les éléments suivants :

   • SERVICE_ACCOUNT_EMAIL : adresse e-mail du compte de service que vous utilisez comme identité de service, par exemple :
     • Compte de service Compute Engine par défaut : [e-mail]
     • Un compte de service que vous avez créé : SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
   • PRINCIPAL : identifiant de l'utilisateur. Il s'agit généralement de l'adresse e-mail d'un compte Google.
4. Consultez les tarifs de Cloud Run ou estimez les coûts à l'aide du simulateur de coût.

Créer un dépôt à partir d'un modèle

Pour créer un dépôt :

1. Accédez au dépôt de modèles :

   Node.js

   Accédez à github.com/GoogleCloudPlatform/cloud-run-microservice-template-nodejs

   Python

   Accédez à github.com/GoogleCloudPlatform/cloud-run-microservice-template-python

   Go

   Accédez à github.com/GoogleCloudPlatform/cloud-run-microservice-template-go

   Java

   Accédez à github.com/GoogleCloudPlatform/cloud-run-microservice-template-java

2. Cliquez sur Utiliser ce modèle.

3. Sélectionnez Créer un dépôt.

4. Dans le formulaire, saisissez un nom de dépôt.

5. Cliquez sur Créer un dépôt à partir d'un modèle.

Déployer une fonction depuis le dépôt

Pour déployer depuis le dépôt :

1. Dans la console Google Cloud , accédez à la page Cloud Run :

   Accédez à Cloud Run

2. Sélectionnez Services dans le menu, puis cliquez sur Déployer un conteneur.

3. Dans Créer un service, assurez-vous que l'option Déployer en continu depuis un dépôt est sélectionnée.

4. Dans le formulaire, cliquez sur Configurer Cloud Build.

5. Dans le panneau de droite :

   1. Sous Dépôt, sélectionnez le dépôt que vous venez de créer. Si vous ne l'avez pas encore fait, vous devrez peut-être vous authentifier. Utilisez le lien s'authentifier dans le champ Fournisseur de dépôts.

   2. Vérifiez le contrat de confirmation concernant GitHub et l'interactivité Google Cloud .

   3. Cliquez sur Suivant.

   4. Sous Type de compilation, sélectionnez Google Cloud Buildpacks.

   5. Cliquez sur Enregistrer.

6. Dans le formulaire Créer un service :

   1. confirmez le nom du service. Il sera automatiquement renseigné avec le nom du dépôt.

   2. Dans le menu déroulant Région, sélectionnez la région dans laquelle vous souhaitez créer votre service.

   3. Sous Authentification, sélectionnez Autoriser l'accès public. Si vous ne disposez pas des autorisations nécessaires (rôle "Administrateur Cloud Run") pour sélectionner cette option, le service sera déployé et nécessitera une authentification.

   4. Cliquez sur Créer pour déployer l'exemple de dépôt sur Cloud Run, puis patientez jusqu'à la fin du déploiement.

7. Cliquez sur le lien URL affiché pour exécuter le conteneur déployé.

Emplacements Cloud Run

Cloud Run est régional, ce qui signifie que l'infrastructure qui exécute vos services Cloud Run est située dans une région spécifique et gérée par Google pour être disponible de manière redondante dans toutes les zones de cette région.



Lors de la sélection de la région dans laquelle exécuter vos services Cloud Run, vous devez tout d'abord considérer vos exigences en matière de latence, de disponibilité et de durabilité. Vous pouvez généralement sélectionner la région la plus proche de vos utilisateurs, mais vous devez tenir compte de l'emplacement des autres Google Cloudproduits utilisés par votre service Cloud Run. L'utilisation conjointe de produits Google Cloud dans plusieurs emplacements peut avoir une incidence sur la latence et le coût de votre service.



Cloud Run est disponible dans les régions suivantes :

Soumis aux tarifs de niveau 1

• asia-east1 (Taïwan)
• asia-northeast1 (Tokyo)
• asia-northeast2 (Osaka)
• asia-south1 (Mumbai, Inde)
• europe-north1 (Finlande) Faibles émissions de CO₂
• europe-north2 (Stockholm) Faibles émissions de CO₂
• europe-southwest1 (Madrid) Faibles émissions de CO₂
• europe-west1 (Belgique) Faibles émissions de CO₂
• europe-west4 (Pays-Bas) Faibles émissions de CO₂
• europe-west8 (Milan)
• europe-west9 (Paris) Faibles émissions de CO₂
• me-west1 (Tel Aviv)
• northamerica-south1 (Mexique)
• us-central1 (Iowa)  Faibles émissions de CO₂
• us-east1 (Caroline du Sud)
• us-east4 (Virginie du Nord)
• us-east5 (Columbus)
• us-south1 (Dallas) Faibles émissions de CO₂
• us-west1 (Oregon)  Faibles émissions de CO₂

Soumis aux tarifs de niveau 2

• africa-south1 (Johannesburg)
• asia-east2 (Hong Kong)
• asia-northeast3 (Séoul, Corée du Sud)
• asia-southeast1 (Singapour)
• asia-southeast2 (Jakarta)
• asia-south2 (Delhi, Inde)
• australia-southeast1 (Sydney)
• australia-southeast2 (Melbourne)
• europe-central2 (Varsovie, Pologne)
• europe-west10 (Berlin) Faibles émissions de CO₂.
• europe-west12 (Turin)
• europe-west2 (Londres, Royaume-Uni) Faibles émissions de CO₂
• europe-west3 (Francfort, Allemagne)
• europe-west6 (Zurich, Suisse) Faibles émissions de CO₂
• me-central1 (Doha)
• me-central2 (Dammam)
• northamerica-northeast1 (Montréal) Faibles émissions de CO₂
• northamerica-northeast2 (Toronto)  Faibles émissions de CO₂
• southamerica-east1 (São Paulo, Brésil)  Faibles émissions de CO₂
• southamerica-west1 (Santiago, Chili) Faibles émissions de CO₂
• us-west2 (Los Angeles)
• us-west3 (Salt Lake City)
• us-west4 (Las Vegas)

Si vous avez déjà créé un service Cloud Run, vous pouvez afficher la région dans le tableau de bord Cloud Run de la consoleGoogle Cloud .

OK

Mettre à jour le service

Pour modifier le service, procédez comme suit :

1. Transférez un commit vers la branche principale du dépôt.

2. Actualisez le service Cloud Run pour afficher l'état de la mise à jour.

Succès : vous avez déployé une image de conteneur depuis un dépôt Git vers Cloud Run.

Cloud Run met automatiquement à l'échelle vos instances de conteneur en fonction de la demande. Vous ne payez que pour le processeur, la mémoire et le réseau utilisés lors du traitement des requêtes.

Effectuer un nettoyage

Pour éviter que des frais supplémentaires ne soient facturés sur votre compte Google Cloud , supprimez toutes les ressources que vous avez déployées avec ce guide de démarrage rapide.

Supprimer votre dépôt

Cloud Run ne vous facture pas lorsque votre service déployé n'est pas utilisé. Toutefois, il se peut que des frais vous soient facturés pour le stockage de l'image de conteneur dans Artifact Registry. Pour supprimer des dépôts Artifact Registry, suivez les étapes décrites dans Supprimer des dépôts de la documentation Artifact Registry.

Supprimer votre service

Les services Cloud Run n'entraînent pas de coûts tant qu'ils ne reçoivent pas de requêtes. Pour supprimer votre service Cloud Run, procédez comme suit :

Console

Pour supprimer un service, procédez comme suit :

1. Dans la console Google Cloud , accédez à Cloud Run :

   Accédez à Cloud Run

2. Recherchez le service que vous souhaitez supprimer dans la liste des services, puis cliquez la case correspondante pour le sélectionner.

3. Cliquez sur Supprimer pour supprimer toutes les révisions du service.

gcloud

Pour supprimer un service, exécutez la commande suivante :

gcloud run services delete SERVICE --region REGION

Remplacez les éléments suivants :

• SERVICE : nom de votre service.
• REGION : Google Cloud région du service.

Supprimer votre projet de test

La suppression de votre projet Google Cloud arrête la facturation de toutes les ressources de ce projet. Pour libérer toutes les ressources Google Cloud de votre projet, procédez comme suit :

Attention : La suppression d'un projet a les effets suivants :
• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.
1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Étapes suivantes

• Démarrage rapide : Construire et déployer
• Déploiement continu avec Cloud Build
• Créer des conteneurs à l'aide de Buildpacks