Créer un workflow à l'aide de la gcloud CLI
Ce guide de démarrage rapide vous explique comment créer, déployer et exécuter votre premier workflow à l'aide de la Google Cloud CLI. L'exemple de workflow envoie une requête à une API publique, puis renvoie la réponse de l'API.
Pour obtenir la liste de toutes les commandes de la CLI gcloud Workflows, consultez la page de référence de la CLI gcloud Workflows.
Avant de commencer
Les contraintes de sécurité définies par votre organisation peuvent vous empêcher d'effectuer les étapes suivantes. Pour obtenir des informations de dépannage, consultez la page Développer des applications dans un environnement Google Cloud limité.
- 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 gratuits pour exécuter, tester et déployer des charges de travail.
- 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.
-
-
Make sure that billing is enabled for your Google Cloud project.
- 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.
-
-
Make sure that billing is enabled for your Google Cloud project.
Activer l'API Workflows
gcloud services enable workflows.googleapis.com
- Créez le compte de service et attribuez-lui un nom. Exemple :
sa-name
gcloud iam service-accounts create sa-name
- Pour envoyer des journaux à Cloud Logging, accordez le rôle
roles/logging.logWriter
au compte de service.gcloud projects add-iam-policy-binding PROJECT_ID \ --member "serviceAccount:sa-name@PROJECT_ID.iam.gserviceaccount.com" \ --role "roles/logging.logWriter"
Pour en savoir plus sur les rôles et les autorisations des comptes de service, consultez Autoriser l'accès à un workflow ressources Google Cloud.
Créer, déployer et exécuter un workflow
Dans votre répertoire d'accueil, créez un fichier appelé
myFirstWorkflow.yaml
oumyFirstWorkflow.json
.Copiez et collez le workflow suivant dans le nouveau fichier, puis enregistrez-le:
YAML
JSON
À moins que vous ne saisissiez votre propre terme de recherche, ce workflow utilise votre Emplacement Google Cloud pour créer un terme de recherche, qu'il transmet l'API Wikipédia. Une liste de des articles Wikipédia associés est renvoyé.
Déployez le workflow et associez-le au compte de service spécifié:
gcloud workflows deploy myFirstWorkflow --source=myFirstWorkflow.EXTENSION \ --service-account=sa-name@PROJECT_ID.iam.gserviceaccount.com
Remplacez les éléments suivants :
EXTENSION
: extension de fichier de votre workflow Utilisezyaml
pour la version YAML oujson
pour la version JSONPROJECT_ID
: ID de votre projet.
Exécutez le workflow :
gcloud workflows run myFirstWorkflow \ --data='SEARCH_TERM'
Remplacez
SEARCH_TERM
par votre terme de recherche, par exemple{"searchTerm":"North"}
. Si vous saisissez{}
, votre serveur Google Cloud l'emplacement est utilisé pour construire un terme de recherche.Cette méthode renvoie les résultats de la tentative d'exécution. Le résultat ressemble à ce qui suit :
argument: '{"searchTerm":"North"}' duration: 0.210616856s endTime: '2023-05-10T21:56:39.465899376Z' name: projects/734581694262/locations/us-central1/workflows/workflow-1/executions/eae31f11-a5c3-47e2-8014-05b400820a79 result: '["North","North America","Northern Ireland","North Korea","North Macedonia","North Carolina","Northrop Grumman B-2 Spirit","Northrop F-5","Northern Cyprus","North Dakota"]' startTime: '2023-05-10T21:56:39.255282520Z' state: SUCCEEDED status: currentSteps: - routine: main step: returnOutput workflowRevisionId: 000001-ac2
Vous avez déployé et exécuté votre premier workflow !
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.
Supprimez le workflow que vous avez créé :
gcloud workflows delete myFirstWorkflow
Lorsque vous êtes invité à poursuivre l'opération, saisissez
y
.
Le workflow est supprimé.