Configurer votre environnement

Avant de planifier et d'exécuter un job cron, vous devez configurer votre Google Cloud projet et votre environnement pour Cloud Scheduler.

Activer l'API Cloud Scheduler

Suivez les instructions ci-dessous pour créer ou sélectionner un Google Cloud projet et activer l'API Cloud Scheduler.

Console

  1. Connectez-vous à votre Google Cloud compte. Si vous ne connaissez pas encore Google Cloud, créez un compte pour évaluer les performances de nos produits dans des scénarios réels. 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.

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

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Scheduler API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

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

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Scheduler API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    8.

gcloud

  1. Connectez-vous à votre Google Cloud compte. Si vous ne connaissez pas encore Google Cloud, créez un compte pour évaluer les performances de nos produits dans des scénarios réels. 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.

  2. Installez la Google Cloud CLI.

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

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

    gcloud init

  5. Créez ou sélectionnez un Google Cloud projet.

    Rôles requis pour sélectionner ou créer un projet

    • Sélectionner un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
    • Créer un projet : pour créer un projet, vous avez besoin du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.

    • Créez un Google Cloud projet :

      gcloud projects create PROJECT_ID

      Remplacez PROJECT_ID par le nom du Google Cloud projet que vous créez.

    • Sélectionnez le Google Cloud projet que vous avez créé :

      gcloud config set project PROJECT_ID

      Remplacez PROJECT_ID par le nom de votre Google Cloud projet.

  6. Vérifiez que la facturation est activée pour votre Google Cloud projet.

  7. Activez l'API Cloud Scheduler :

    Rôles requis pour activer les API

    Pour activer les API, vous avez besoin de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le rôle Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles. 

    gcloud services enable cloudscheduler.googleapis.com

  8. Installez la Google Cloud CLI.

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

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

    gcloud init

  11. Créez ou sélectionnez un Google Cloud projet.

    Rôles requis pour sélectionner ou créer un projet

    • Sélectionner un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
    • Créer un projet : pour créer un projet, vous avez besoin du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.

    • Créez un Google Cloud projet :

      gcloud projects create PROJECT_ID

      Remplacez PROJECT_ID par le nom du Google Cloud projet que vous créez.

    • Sélectionnez le Google Cloud projet que vous avez créé :

      gcloud config set project PROJECT_ID

      Remplacez PROJECT_ID par le nom de votre Google Cloud projet.

  12. Vérifiez que la facturation est activée pour votre Google Cloud projet.

  13. Activez l'API Cloud Scheduler :

    Rôles requis pour activer les API

    Pour activer les API, vous avez besoin de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le rôle Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles. 

    gcloud services enable cloudscheduler.googleapis.com
    14.

Configurer l'authentification

La façon dont vous vous authentifiez auprès de Cloud Scheduler dépend de l'interface que vous utilisez pour accéder à l'API et de l'environnement dans lequel votre code s'exécute.

Pour en savoir plus, consultez les pages S'authentifier auprès de Cloud Scheduler et Utiliser l'authentification avec des cibles HTTP.

Ajouter une application App Engine

Si vous comptez utiliser une cible HTTP App Engine, vous devez ajouter une application App Engine à votre projet. Cette application sert à la fois d'emplacement pour le service Cloud Scheduler et pour le gestionnaire de tâches lui-même, qui effectue le travail associé à une tâche Cloud Scheduler et renvoie un accusé de réception en réponse.

Si vous souhaitez disposer d'un gestionnaire de tâches App Engine qui ne se trouve pas dans votre projet, vous devez sélectionner une cible HTTP. Dans ce cas, vous n'avez pas besoin d'une application App Engine dans votre projet.

Console

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

    Accéder à App Engine

  2. Dans la boîte de dialogue Bienvenue dans App Engine, effectuez l'une des opérations suivantes :

    • Si vous avez déjà créé une application App Engine et que le message Votre application App Engine a bien été créée s'affiche, vous pouvez passer aux étapes suivantes de cette section.

      ou

    • Si vous n'avez pas encore créé d'application App Engine, cliquez sur Créer une application , puis passez aux étapes suivantes de cette section.

  3. Sélectionnez une région pour votre application.

    Notez que europe-west et us-central sont appelés respectivement europe-west1 et us-central1 dans les commandes Cloud Scheduler.

    Une fois que vous avez défini une région pour l'application App Engine, vous ne pouvez pas la modifier.

  4. Ne sélectionnez pas de compte de service. Le compte de service App Engine par défaut est utilisé.

  5. Cliquez sur Suivant.

    L'application est configurée et créée. Cette opération peut prendre quelques minutes.

  6. Ne téléchargez pas le Cloud SDK. Cliquez plutôt sur Je le ferai plus tard.

    Le message Votre application App Engine a bien été créée devrait s'afficher.

gcloud

  1. Pour créer une application App Engine, exécutez la gcloud app create commande :

    gcloud app create --region=REGION

    Remplacez REGION par l' emplacement dans lequel l'application s'exécute. Notez que europe-west et us-central sont appelés respectivement europe-west1 et us-central1 dans les commandes Cloud Scheduler.

    Une fois que vous avez défini une région pour l'application App Engine, vous ne pouvez pas la modifier.

  2. Vous pouvez vérifier la région d'une application existante à l'aide de la commande suivante :

    gcloud app describe

    locationId indique la région. Exemple : locationId: us-central.