Guide de démarrage rapide : déployer une fonction Cloud Run à l'aide de la console Google Cloud

Guide de démarrage rapide : déployer une fonction Cloud Run à l'aide de la console Google Cloud

Cette page explique comment déployer une fonction HTTP Cloud Run à l'aide de la console Google Cloud .

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.

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

Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un projet, vous disposez déjà des autorisations requises.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry, Cloud Build, Cloud Run Admin API, and Cloud Logging 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

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

Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un projet, vous disposez déjà des autorisations requises.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry, Cloud Build, Cloud Run Admin API, and Cloud Logging 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

1. 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.

2. Consultez les tarifs de Cloud Run ou estimez les coûts à l'aide du simulateur de coût.

Rôles requis

Pour obtenir les autorisations nécessaires pour suivre ce guide de démarrage rapide, demandez à votre administrateur de vous accorder les rôles IAM suivants :

• Développeur de source Cloud Run (roles/run.sourceDeveloper) sur le projet
• Utilisateur du compte de service (roles/iam.serviceAccountUser) sur l'identité du service
• Lecteur de journaux (roles/logging.viewer) sur le projet

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Accorder au compte de service Cloud Build l'accès à votre projet

Cloud Build utilise automatiquement le compte de service Compute Engine par défaut comme compte de service Cloud Build par défaut pour compiler votre code source et votre ressource Cloud Run, sauf si vous modifiez ce comportement.

Pour que Cloud Build puisse créer vos sources, accordez au compte de service Cloud Build le rôle Créateur Cloud Run (roles/run.builder) dans votre projet :

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:SERVICE_ACCOUNT_EMAIL_ADDRESS \
    --role=roles/run.builder

Remplacez PROJECT_ID par l'ID de votre projet Google Cloudet SERVICE_ACCOUNT_EMAIL_ADDRESS par l'adresse e-mail du compte de service Cloud Build. Si vous utilisez le compte de service Compute Engine par défaut comme compte de service Cloud Build, utilisez le format suivant pour l'adresse e-mail du compte de service :

[e-mail]

Remplacez PROJECT_NUMBER par votre numéro de projet Google Cloud.

Pour obtenir des instructions détaillées sur la recherche de votre ID et de votre numéro de projet, consultez la section Créer et gérer des projets.

L'application du rôle de compilateur Cloud Run prend quelques minutes.

Déployer la fonction

Pour déployer une fonction, procédez comme suit :

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

   Accédez à Cloud Run

2. Cliquez sur Écrire une fonction.

3. Dans le champ Nom du service, saisissez un nom de service pour décrire votre fonction, par exemple my-nodejs-http-function. Les noms de service doivent commencer par une lettre et comporter 49 caractères au maximum (lettres, chiffres ou traits d'union). Les noms de service ne peuvent pas se terminer par un tiret et doivent être uniques par région et par projet. Un nom de service ne peut pas être modifié ultérieurement et il est visible publiquement.

4. Dans la liste Région, utilisez la valeur par défaut europe-west1 ou sélectionnez la région dans laquelle vous souhaitez déployer votre fonction.

5. Dans la liste Environnement d'exécution, utilisez la valeur par défaut ou sélectionnez une version d'environnement d'exécution.

6. Dans la section 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.

7. Cliquez sur Créer et attendez que Cloud Run crée le service à l'aide d'une révision de substitution. La console vous redirige vers l'onglet Source, où vous pouvez voir le code source de votre fonction.

8. Dans l'onglet Source, cliquez sur Enregistrer et redéployer. Vous pouvez également cliquer sur Afficher la charge utile pour afficher l'objet de requête entrant.

9. Après le déploiement, l'URL du conteneur s'affiche à côté du texte URL :. Pour afficher le résultat de la fonction, cliquez sur Copier dans le presse-papiers pour copier son URL, puis collez-la dans la barre d'adresse de votre navigateur.

   Bravo ! Vous avez déployé une fonction Cloud Run HTTP à l'aide de la console Google Cloud .

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)
• 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

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 à la page Services de 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 entraîne les effets décrits ci-dessous :
• 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

• Pour déployer un exemple de fonction sur Cloud Run à l'aide de Google Cloud CLI, consultez le Guide de démarrage rapide : Déployer une fonction sur Cloud Run à l'aide de gcloud CLI.

• Pour déployer des fonctions à l'aide de la console Google Cloud et de Google Cloud CLI, consultez Déployer des fonctions.

• Pour afficher et supprimer des fonctions existantes, consultez la section Gérer les révisions de service.

• Pour créer des conteneurs de fonctions dans votre propre chaîne d'outils et les déployer sur Cloud Run, consultez la section Créer des fonctions.

• Pour créer des déclencheurs avec Eventarc, consultez Créer des déclencheurs avec Eventarc.