Configurer votre environnement

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

Activer l'API Cloud Scheduler

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

Console

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

  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 Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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 Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

gcloud

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

  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 projet Google Cloud .

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

    • Sélectionnez 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 devez disposer 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 projet Google Cloud  :

      gcloud projects create PROJECT_ID

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

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

      gcloud config set project PROJECT_ID

      Remplacez PROJECT_ID par le nom de votre projet Google Cloud .

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

  7. Activez l'API Cloud Scheduler :

    Rôles requis pour activer les API

    Pour activer les API, vous avez besoin du rôle IAM Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. 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 projet Google Cloud .

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

    • Sélectionnez 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 devez disposer 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 projet Google Cloud  :

      gcloud projects create PROJECT_ID

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

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

      gcloud config set project PROJECT_ID

      Remplacez PROJECT_ID par le nom de votre projet Google Cloud .

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

  13. Activez l'API Cloud Scheduler :

    Rôles requis pour activer les API

    Pour activer les API, vous avez besoin du rôle IAM Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. 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 S'authentifier auprès de Cloud Scheduler et Utiliser l'authentification avec des cibles HTTP.

Ajouter une application App Engine

Si vous prévoyez d'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 n'est pas dans votre projet, vous devez sélectionner une cible HTTP à la place. Dans ce cas, vous n'avez pas besoin d'une application App Engine dans votre projet.

Console

  1. Dans la console Google Cloud , 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 ignorer les étapes restantes de cette section.

      ou

    • Si vous n'avez pas encore créé d'application App Engine, cliquez sur Créer une application et suivez les étapes restantes 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 plus 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 Cloud SDK. Cliquez plutôt sur Je le ferai plus tard.

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

gcloud

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

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