Planifier une fonction Cloud Run HTTP

Ce tutoriel explique comment planifier une fonction Cloud Run HTTP en ciblant un point de terminaison HTTP dans Cloud Scheduler. Utilisez une fonction HTTP lorsque vous avez besoin que votre fonction dispose d'un point de terminaison d'URL et réponde aux requêtes HTTP, par exemple pour les webhooks.

Si vous avez créé une fonction CloudEvents, vous pouvez également utiliser des déclencheurs d'événements Eventarc pour planifier l'exécution de votre fonction en réponse à des événements dans votre projet. Eventarc peut déclencher des messages sur un sujet Pub/Sub, des modifications dans un bucket Cloud Storage, et plus encore. Pour en savoir plus, consultez Types de fonctions Cloud Run.

La planification de l'exécution d'une fonction Cloud Run est un cas d'utilisation courant pour Cloud Scheduler. Au cours de ce tutoriel, vous allez :

1. Créez une fonction Cloud Run HTTP simple.
2. Créez une tâche Cloud Scheduler.
3. Exécutez le job Cloud Scheduler.
4. Vérifiez que la tâche Cloud Scheduler déclenche votre fonction Cloud Run.

Coûts

Dans ce document, vous utilisez les composants facturables suivants de Google Cloud :

• Cloud Run
• Cloud Scheduler

Pour obtenir une estimation des coûts en fonction de votre utilisation prévue, utilisez le simulateur de coût.

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.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler APIs.

Enable the APIs

Create a service account:

1. In the Google Cloud console, go to the Create service account page.

   Go to Create service account
2. Select your project.

3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

   In the Service account description field, enter a description. For example, Service account for quickstart.

4. Click Create and continue.

5. Grant the following roles to the service account: Cloud Run > Cloud Run Invoker, Cloud Run > Cloud Run Builder.

   To grant a role, find the Select a role list, then select the role.

   To grant additional roles, click add Add another role and add each additional role.

6. Click Continue.

7. Click Done to finish creating the service account.

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

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler APIs.

Enable the APIs

Create a service account:

1. In the Google Cloud console, go to the Create service account page.

   Go to Create service account
2. Select your project.

3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

   In the Service account description field, enter a description. For example, Service account for quickstart.

4. Click Create and continue.

5. Grant the following roles to the service account: Cloud Run > Cloud Run Invoker, Cloud Run > Cloud Run Builder.

   To grant a role, find the Select a role list, then select the role.

   To grant additional roles, click add Add another role and add each additional role.

6. Click Continue.

7. Click Done to finish creating the service account.

Notez que vous devez attribuer le rôle Demandeur Cloud Run, car dans Cloud Run Functions, les autorisations d'appel sont disponibles en gérant le service Cloud Run sous-jacent.

Rôles requis

Pour obtenir les autorisations nécessaires pour suivre le tutoriel, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

• Développeur de source Cloud Run (roles/run.sourceDeveloper)
• Administrateur Cloud Scheduler (roles/cloudscheduler.admin)
• Accesseur de vues de journaux (roles/logging.viewAccessor)
• Administrateur de projet IAM (roles/resourcemanager.projectIamAdmin)
• Administrateur de compte de service (roles/iam.serviceAccountAdmin)
• Utilisateur du compte de service (roles/iam.serviceAccountUser)

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

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

Attribuer les rôles

Console

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

   Accéder à IAM
2. Sélectionnez le projet.
3. Cliquez sur person_add 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 du compte Google utilisé pour déployer le service Cloud Run.

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

gcloud

Pour attribuer les rôles IAM requis à votre compte dans votre projet :

     gcloud projects add-iam-policy-binding PROJECT_ID \
         --member=PRINCIPAL \
         --role=ROLE
     

Remplacez :

• PROJECT_NUMBER par le numéro de votre projet Google Cloud .
• PROJECT_ID par l'ID de votre projet Google Cloud .
• PRINCIPAL par le compte pour lequel vous ajoutez la liaison. Il s'agit généralement de l'adresse e-mail du compte Google utilisé pour déployer le service Cloud Run.
• ROLE par le rôle que vous ajoutez au compte déployeur.

Effectuer un nettoyage

Pour éviter que les ressources utilisées lors de ce tutoriel soient facturées sur votre compte Google Cloud, supprimez le projet contenant les ressources, ou conservez le projet et supprimez les ressources individuelles.

Supprimer le 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.

Supprimer les ressources du tutoriel

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

   Accéder à Cloud Scheduler

2. Cochez la case située en regard de votre tâche.

3. Cliquez sur delete Supprimer, puis confirmez la suppression.

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

   Accédez à Cloud Run

5. Cochez la case située à côté de votre service.

6. Cliquez sur delete Supprimer, puis confirmez la suppression.

7. Dans la console Google Cloud , accédez à la page Comptes de service.

   Accéder à la page "Comptes de service"

8. Cochez la case à côté du compte de service que vous avez créé.

9. Cliquez sur delete Supprimer, puis confirmez la suppression.

Étapes suivantes

• Utiliser Cloud Scheduler pour déclencher Cloud Run de manière planifiée
• Écrivez des fonctions CloudEvents pour planifier votre fonction afin qu'elle réponde aux événements de votre projet.