Créer un workflow à l'aide de Terraform

Créer un workflow à l'aide de Terraform

Dans ce guide de démarrage rapide, vous allez découvrir comment créer, déployer et exécuter votre premier workflow à l'aide de Terraform. Terraform est un outil 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.

Dans ce guide de démarrage rapide, l'exemple de workflow envoie une requête à une API publique, puis renvoie la réponse de l'API.

Vous allez effectuer les tâches suivantes :

1. Activez l'API Workflows à l'aide de Terraform.
2. Créez un compte de service pour le workflow à l'aide de Terraform.
3. Définir et déployer un workflow à l'aide de Terraform
4. Exécutez le workflow à l'aide de Google Cloud CLI.

Avant de commencer

Les contraintes de sécurité définies par votre organisation peuvent vous empêcher d'effectuer les étapes suivantes. Pour en savoir plus sur la résolution des problèmes, consultez Développer des applications dans un environnement Google Cloud limité.

Notez que Terraform est déjà intégré à Cloud Shell. Si vous devez installer Terraform, consultez la documentation HashiCorp Terraform.

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.

Install the Google Cloud CLI.

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.

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

gcloud init

Create or select a Google Cloud project.

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.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Resource Manager and Identity and Access Management (IAM) APIs:

gcloud services enable cloudresourcemanager.googleapis.com iam.googleapis.com

Install the Google Cloud CLI.

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.

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

gcloud init

Create or select a Google Cloud project.

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.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Resource Manager and Identity and Access Management (IAM) APIs:

gcloud services enable cloudresourcemanager.googleapis.com iam.googleapis.com

Créer un fichier de configuration Terraform

Créez un fichier de configuration Terraform nommé main.tf et incluez les ressources du fournisseur Google pour Terraform utilisées dans ce démarrage rapide.

Notez que vous pouvez utiliser l'interpolation pour les substitutions, telles que les variables de référence, les attributs de ressources et les fonctions d'appel.

1. Créez un répertoire.

   mkdir terraform

2. Accédez au répertoire terraform :

   cd terraform

3. Ajoutez un nouveau fichier, main.tf, au répertoire:

   nano main.tf

4. Ajoutez les ressources suivantes au fichier main.tf :

   1. Attribuez l'ID du projet:

      provider "google" {
      project = "PROJECT_ID"
      }

      Remplacez PROJECT_ID par l'ID de votre projet.

   2. Activer l'API Workflows

      # Enable Workflows API
      resource "google_project_service" "default" {
        service            = "workflows.googleapis.com"
        disable_on_destroy = false
      }

   3. Créer un compte de service pour le workflow

      # Create a dedicated service account
      resource "google_service_account" "default" {
        account_id   = "sample-workflows-sa"
        display_name = "Sample Workflows Service Account"
      }

   4. Définissez le workflow à l'aide de la ressource google_workflows_workflow :

      Important : Lorsque vous définissez des workflows dans Terraform, les variables doivent être échappées avec $${...} and not ${...}.
      # Create a workflow
      resource "google_workflows_workflow" "default" {
        name            = "sample-workflow"
        region          = "us-central1"
        description     = "A sample workflow"
        service_account = google_service_account.default.id
      
        deletion_protection = false # set to "true" in production
      
        labels = {
          env = "test"
        }
        user_env_vars = {
          url = "https://timeapi.io/api/Time/current/zone?timeZone=Europe/Amsterdam"
        }
        source_contents = <<-EOF
        # This is a sample workflow that you can replace with your source code
        #
        # The workflow does the following:
        # - Retrieves the current date from a public API and stores the
        #   response in `currentDate`
        # - Retrieves a list of Wikipedia articles from a public API related
        #   to the day of the week stored in `currentDate`
        # - Returns the list of articles in the workflow output
        #
        # Note that when you define workflows in Terraform, variables must be
        # escaped with two dollar signs ($$) and not a single sign ($)
      
        - getCurrentDate:
            call: http.get
            args:
                url: $${sys.get_env("url")}
            result: currentDate
        - readWikipedia:
            call: http.get
            args:
                url: https://en.wikipedia.org/w/api.php
                query:
                    action: opensearch
                    search: $${currentDate.body.dayOfWeek}
            result: wikiResult
        - returnOutput:
            return: $${wikiResult.body[1]}
      EOF
      
        depends_on = [google_project_service.default]
      }
      

Les arguments suivants sont utilisés dans l'exemple de workflow :

• name: Nom de votre workflow.
• region : emplacement de votre workflow.
• description : description de votre workflow.
• service_account : adresse e-mail ou ID unique du compte de service associé à la dernière version du workflow. Ce compte de service représente l'identité du workflow et détermine les autorisations dont il dispose. Si vous ne spécifiez pas de compte de service lors de la création du workflow, celui-ci utilise le compte de service Compute Engine par défaut pour son identité. Pour en savoir plus, consultez Autoriser un workflow à accéder aux ressources Google Cloud .
• labels : liste de paires clé-valeur de libellés à attribuer à ce workflow pour vous aider à organiser vos instances Google Cloud . Pour en savoir plus, consultez Que sont les libellés ?
• user_env_vars : variables d'environnement définies par l'utilisateur associées à cette révision du workflow. Pour en savoir plus, consultez Utiliser des variables d'environnement.
• source_contents : code Workflows à exécuter. Pour connaître la limite de taille des fichiers, consultez Limites de ressources.

Voici d'autres arguments facultatifs :

• crypto_key_name : ID de ressource d'une clé Cloud Key Management Service au format suivant :

  projects/PROJECT_NAME/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME

  Pour en savoir plus, consultez Utiliser des clés de chiffrement gérées par le client.

• call_log_level : niveau de journalisation à appliquer aux appels et aux réponses aux appels lors des exécutions de ce workflow. Les valeurs possibles sont les suivantes :

  • CALL_LOG_LEVEL_UNSPECIFIED
  • LOG_ALL_CALLS
  • LOG_ERRORS_ONLY
  • LOG_NONE

  Pour en savoir plus, consultez Journalisation des appels.

• project : ID du projet auquel appartient la ressource. Si elle n'est pas fournie, le projet du fournisseur est utilisé.

• name_prefix : crée un nom unique commençant par le préfixe spécifié. Si ce paramètre et name ne sont pas spécifiés, une valeur aléatoire est choisie pour le nom.

Créer et exécuter le workflow

Déployez vos ressources Terraform pour créer le workflow, puis exécutez-le.

1. Initialisez Terraform dans le répertoire:

   terraform init

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

3. Créez le workflow:

   terraform apply

4. Lorsque l'invite Saisir une valeur s'affiche, saisissez yes pour procéder à la création des ressources.

5. Vérifiez que le workflow a bien été créé:

   gcloud workflows list --location us-central1

   La sortie devrait ressembler à ce qui suit :

   NAME                                                                    STATE   REVISION_ID  UPDATE_TIME
   projects/project-name/locations/us-central1/workflows/sample-workflow   ACTIVE  000001-f9a   2024-02-24T13:38:58.353765906Z

6. Vous pouvez également exécuter le workflow:

   gcloud workflows execute sample-workflow

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Google Cloud , supprimez le projet Google Cloud qui les contient.

1. Supprimez toutes les ressources que vous avez créées avec Terraform :

   terraform destroy

2. Supprimez le workflow que vous avez créé :

   gcloud workflows delete sample-workflow

   Lorsque vous êtes invité à poursuivre l'opération, saisissez y.
3. Vous pouvez également supprimer votre projet Google Cloud pour éviter des frais. La suppression de votre projet Google Cloud arrête la facturation de toutes les ressources utilisées dans ce projet.
   Attention : La suppression d'un projet a les effets suivants :
   • 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.

   Delete a Google Cloud project:

   gcloud projects delete PROJECT_ID

Étapes suivantes

• Contrôler l'ordre d'exécution des étapes d'un workflow

• Mettez à jour un workflow existant.

• Découvrez des exemples de workflows.

• En savoir plus sur la syntaxe Workflows