Planifier et exécuter une job Cron à l'aide de Terraform
Ce guide de démarrage rapide explique comment utiliser Terraform pour créer un job cron Cloud Scheduler. Terraform est un outil IaC (Infrastructure as Code) qui vous permet de créer, de modifier et d'améliorer de manière prévisible votre infrastructure cloud en utilisant du code. Découvrez comment utiliser Terraform pour provisionner une infrastructure sur Google Cloud.
Une version sans frais de Cloud Scheduler est disponible. Par conséquent, l'exécution de ce démarrage rapide ne vous coûtera rien. Pour en savoir plus, reportez-vous à la section Tarification.
Dans le cadre de ce guide démarrage rapide, vous allez effectuer les étapes suivantes :
- Utilisez Terraform pour créer un job Cron pour Cloud Scheduler.
- définir un calendrier récurrent pour la tâche ;
- spécifier un sujet Pub/Sub comme cible de la tâche ;
- Exécutez la tâche.
- vérifier que la tâche a bien été exécutée.
Avant de commencer
-
Sign in to your Google Account.
If you don't already have one, sign up for a new account.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
- Terraform est déjà intégré à Cloud Shell. Si vous devez installer Terraform, consultez la documentation HashiCorp Terraform.
Créer un fichier de configuration Terraform
Pour utiliser Terraform avec Cloud Scheduler, vous devez créer un fichier de configuration pour décrire votre infrastructure et créer un plan d'exécution. Vous appliquez ensuite le fichier de configuration à votre plate-forme ou à votre service pour effectuer les opérations de provisionnement de votre infrastructure.
Pour créer un fichier de configuration Terraform appelé main.tf
, procédez comme suit:
Ouvrez un terminal et créez un répertoire:
mkdir terraform
Accédez au répertoire
terraform
:cd terraform
Ajoutez un nouveau fichier,
main.tf
, au répertoire:nano main.tf
Ajoutez le fournisseur Terraform pour les ressources Google Cloud suivant au fichier
main.tf
:Activez les API Cloud Scheduler et Pub/Sub:
Créez un sujet Pub/Sub en tant que ressource à laquelle les éditeurs peuvent envoyer des messages:
Cette opération crée un sujet appelé
pubsub_topic
.Créez un abonnement pour recevoir les messages publiés dans le sujet Pub/Sub:
Créez une job Cron à l'aide de la ressource
google_cloud_scheduler_job
:Les arguments suivants sont utilisés dans l'exemple:
name
: nom de la tâche.description
: description de l'offre d'emploi.schedule
: fréquence de la tâche, au format unix-cron.Dans cet exemple,
30 16 * * 7
signifie que la tâche s'exécutera à 16h30 les dimanches. Pour en savoir plus, consultez la section Format et fuseau horaire des tâches Cron.region
: région dans laquelle se trouve la tâche.pubsub_target
: cible du sujet Pub/Sub, y compris le nom de ressource complet du sujet (topic_name
) auquel la charge utile du message (data
) est publiée lorsque la tâche est exécutée.
D'autres arguments sont acceptés. Pour en savoir plus, consultez la documentation de référence sur les arguments du registre Terraform.
Créer la job Cron
Déployez vos ressources Terraform pour créer la job Cron.
Ouvrez un terminal et, dans le répertoire
terraform
, initialisez Terraform:terraform init
Vérifiez que les modifications que vous proposez avec Terraform correspondent au plan attendu :
terraform plan
Vous pouvez ignorer la note indiquant que l'option
-out
n'est pas utilisée.Créez la job Cron:
terraform apply
Lorsque l'invite Saisir une valeur s'affiche, saisissez
yes
pour procéder à la création des ressources.Vérifiez qu'une tâche est créée:
gcloud scheduler jobs describe test-job --location=us-central1
La sortie devrait ressembler à ce qui suit :
description: test job lastAttemptTime: '2024-04-04T13:56:00.669530Z' name: projects/PROJECT_ID/locations/us-central1/jobs/test-job pubsubTarget: data: dGVzdA== topicName: projects/PROJECT_ID/topics/pubsub_topic schedule: '30 16 * * 7' scheduleTime: '2024-04-04T13:58:00.737907Z' state: ENABLED
Vous avez créé une tâche qui envoie un message à un sujet Pub/Sub à 16h30 les dimanches. Vous pouvez maintenant exécuter la tâche.
Exécuter votre tâche
En plus de l'exécuter selon le calendrier spécifié, vous pouvez forcer l'exécution immédiate de votre tâche en exécutant la commande suivante.
gcloud scheduler jobs run test-job --location=us-central1
Notez qu'en raison d'une configuration initiale, l'exécution de la première tâche créée dans un projet peut prendre quelques minutes.
Vérifier les résultats
Vérifiez que votre sujet Pub/Sub reçoit des messages de votre tâche.
Extrayez des messages Pub/Sub d'un abonnement :
gcloud pubsub subscriptions pull pubsub_subscription --limit 5
Si aucun message n'a été initialement récupéré, exécutez de nouveau la commande.
Consultez les résultats de l'exécution de votre tâche. Le résultat doit ressembler à ce qui suit :
DATA: Hello world! MESSAGE_ID: 5028933846601543 ORDERING_KEY: ATTRIBUTES: DELIVERY_ATTEMPT: ACK_ID: RFAGFixdRkhRNxkIaFEOT14jPzUgKEUQAgVPAihdeTFXLkFacGhRDRlyfWB9[...]
Effectuer un nettoyage
Pour éviter que les ressources utilisées sur cette page ne soient facturées sur votre compte Google Cloud , supprimez le projet Google Cloud contenant les ressources.
- La suppression de votre projet Google Cloud arrête la facturation de toutes les ressources utilisées dans ce projet. Notez que par défaut, tous les fichiers de votre répertoire d'accueil Cloud Shell (par exemple, les fichiers Terraform) persistent entre les sessions.
Delete a Google Cloud project:
gcloud projects delete PROJECT_ID
Vous pouvez également supprimer toutes les ressources que vous avez créées avec Terraform.
La commande
terraform destroy
met fin à toutes les ressources spécifiées dans votre état Terraform. Il ne détruit pas les ressources qui ne sont pas gérées par le projet Terraform en cours. Votre fichier de configuration Terraform n'est pas détruit. Pour en savoir plus, consultez la section Supprimer l'infrastructure.terraform destroy