Vous pouvez créer et gérer des workflows dans la console Google Cloud ou à l'aide du Google Cloud CLI dans votre terminal ou dans Cloud Shell. Vous pouvez également gérer les workflows via l'API 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é.
Console
Dans la console Google Cloud, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.
Vérifiez que la facturation est activée pour votre projet Google Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.
Activer l'API Workflows
gcloud
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Vérifiez que la facturation est activée pour votre projet Google Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.
Activer l'API Workflows
gcloud services enable workflows.googleapis.com
REST
Pour gérer les workflows à l'aide de l'API Workflows, nous vous recommandons
que vous utilisez le service
bibliothèques clientes pour appeler
Service workflows.googleapis.com
. Pour en savoir plus, consultez
API Workflows :
Créer un compte de service
Un compte de service représente l'identité d'un workflow et détermine les autorisations dont dispose le workflow et les ressources Google Cloud qu'il peut y accéder. Créez un compte de service si vous n'en possédez pas déjà un. puis l'accorder les rôles nécessaires gérer les workflows et créer des journaux.
Si vous ne spécifiez pas de compte de service lors de la création du workflow, 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
Nous vous recommandons vivement d'utiliser un compte de service ne bénéficiant que des privilèges les plus faibles nécessaires pour accéder aux ressources requises.
Notez que pour créer une ressource et lui associer un compte de service, vous devez les autorisations requises pour créer cette ressource et emprunter l'identité du compte de service que vous allez rattacher à la ressource. Pour en savoir plus, consultez Autorisations de compte de service
Console
Dans la console Google Cloud, accédez à la page Comptes de service.
Sélectionnez un projet, puis cliquez sur Créer un compte de service.
Dans le champ Nom du compte de service, saisissez un nom.
Ce nom doit comporter entre 6 et 30 caractères. Il peut inclure des caractères alphanumériques minuscules et des tirets. Après avoir créé un compte de service, vous ne pouvez pas changer son nom.
Cliquez sur Créer et continuer.
Cliquez sur Select a role (Sélectionner un rôle).
Sélectionnez les rôles suivants et cliquez sur Ajouter un autre rôle si nécessaire:
- Pour créer, mettre à jour et exécuter des workflows, sélectionnez Workflows > Éditeur de workflows.
- Pour envoyer des journaux à Cloud Logging, sélectionnez Logging > Rédacteur de journaux.
Cliquez sur OK pour terminer la création du compte de service.
gcloud
Créez le compte de service.
gcloud iam service-accounts create SERVICE_ACCOUNT
Accordez des autorisations au compte de service en attribuant des rôles.
Pour créer, mettre à jour et exécuter des workflows, attribuez le rôle Rôle
roles/workflows.editor
:gcloud projects add-iam-policy-binding PROJECT_ID \ --member "serviceAccount:SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com" \ --role "roles/workflows.editor"
Pour envoyer des journaux à Cloud Logging, attribuez le rôle
roles/logging.logWriter
rôle:gcloud projects add-iam-policy-binding PROJECT_ID \ --member "serviceAccount:SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com" \ --role "roles/logging.logWriter"
Remplacez les éléments suivants :
SERVICE_ACCOUNT
: nom du compte de service. Il doit comporter entre 6 et 30 caractères alphanumériques pouvant inclure des minuscules et des tirets. Après avoir créé un compte de service, vous ne pouvez pas changer son nom.PROJECT_ID
: ID de votre projet.
REST
Vous pouvez utiliser
serviceAccounts.create
pour créer un compte de service. Pour en savoir plus, consultez
Créez des comptes de service.
Vous pouvez attribuer plusieurs rôles par programmation en modifiant et en définissant
stratégie d'autorisation pour une ressource à l'aide de la
setIamPolicy
. Pour en savoir plus, consultez
Accordez ou révoquez plusieurs rôles de manière automatisée.
Créer un workflow
Une définition de workflow est constituée d'une série d'étapes décrites à l'aide de la syntaxe Workflows, qui peut être écrite au format YAML ou JSON. Après avoir défini un workflow, vous le déployez disponibles pour exécution. L'étape de déploiement vérifie également que le fichier source peut être exécuté. Elle échoue si le fichier source ne contient pas de définition de workflow valide.
La modification des fichiers YAML peut entraîner des erreurs. Vous pouvez créer votre workflow à l'aide d'un IDE ou d'un éditeur de code source de votre choix, et configurer la saisie semi-automatique et la validation de la syntaxe pour réduire les erreurs.
<ph type="x-smartling-placeholder">Console
Dans la console Google Cloud, accédez à la page Workflows :
Cliquez sur
Créer.Saisissez un nom pour le workflow, par exemple
myFirstWorkflow
. Le nom peut contenir des lettres, des chiffres, des traits de soulignement et des tirets. Il doit commencer par une lettre et se terminer par un chiffre ou une lettre.Si vous le souhaitez, ajoutez une description du workflow.
Dans la liste Région, sélectionnez une région l'emplacement dans lequel déployer votre workflow ; pour exemple : us-central1.
Dans la liste Compte de service, sélectionnez un compte de service que vous utilisez pour accéder à d'autres services Google Cloud. Pour plus dans ce document, reportez-vous Créez un compte de service.
Vous avez également la possibilité d'effectuer l'une des opérations suivantes :
Indiquez le niveau de journalisation des appels que vous souhaitez appliquer à la définition du workflow. Dans la liste Niveau de journalisation des appels, sélectionnez l'une des options suivantes:
- Non spécifié: aucun niveau de journalisation n'est spécifié. Il s'agit de l'option par défaut. Un niveau de journalisation d'exécution est prioritaire sur tout niveau de journalisation de workflow, sauf si celui-ci n'est pas spécifié (valeur par défaut). Dans ce cas, le niveau de journalisation du workflow s'applique.
- Erreurs uniquement: consigne toutes les exceptions interceptées, ou lorsqu'un appel est arrêté en raison d'une exception.
- Tous les appels: consigne tous les appels aux sous-workflows ou aux fonctions de la bibliothèque, ainsi que leurs résultats.
- Aucun journal: aucun journal d'appels.
Spécifiez une clé Cloud Key Management Service que le workflow doit utiliser pour le chiffrement des données: sélectionnez Clé de chiffrement gérée par le client (CMEK). Pour en savoir plus, consultez la page Utiliser des clés de chiffrement gérées par le client.
Spécifiez une variable d'environnement accessible par votre workflow au moment de l'exécution. Pour en savoir plus, consultez Utiliser des variables d'environnement.
Ajoutez un libellé : les libellés sont des paires clé/valeur qui vous aident à organiser vos instances Google Cloud. Pour en savoir plus, consultez Que sont les libellés ? Les libellés de workflow sont hérités par les exécutions du workflow. Pour afficher étiquettes d'exécution, utilisez la méthode
workflows.executions.list
pour répertorier et filtrer les exécutions de workflow ;Planifiez votre workflow: sélectionnez Ajouter un déclencheur > Cloud Scheduler. Pour en savoir plus, consultez la page Planifier un workflow à l'aide de Cloud Scheduler.
Déclenchez un workflow via un événement ou un message Pub/Sub : sélectionnez Ajouter un déclencheur > Eventarc. Pour en savoir plus, consultez la page Déclencher un workflow avec des événements ou des messages Pub/Sub.
Cliquez sur Suivant.
Dans l'éditeur de workflow, saisissez la définition de votre workflow. Consultez un exemple de workflow.
Cliquez sur Déployer.
gcloud
Assurez-vous que le code source de votre workflow est enregistré dans un fichier YAML ou JSON, par exemple
MY_WORKFLOW.YAML
ouMY_WORKFLOW.JSON
. Consultez un exemple de workflow.Ouvrez un terminal.
Vous pouvez créer et déployer un workflow à l'aide du Commande
gcloud workflows deploy
:gcloud workflows deploy WORKFLOW_NAME \ --location=LOCATION \ --call-log-level=CALL_LOGGING_LEVEL \ --description="DESCRIPTION" \ --labels="LABEL_KEY=LABEL_VALUE" \ --set-env-vars="ENV_KEY=ENV_VALUE" \ --kms-key=ENCRYPT_KEY \ --service-account=SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com \ --source=YAML_OR_JSON_SOURCE_FILE
Remplacez les éléments suivants :
WORKFLOW_NAME
: nom de votre workflow, par Exemple :myFirstWorkflow
. Le nom peut contenir des lettres, des chiffres, des traits de soulignement et des traits d'union. Il doit commencer par une lettre et se terminer par une un chiffre ou une lettre.LOCATION
: le region (région) dans laquelle déployer votre workflow pour exemple :us-central1
.CALL_LOGGING_LEVEL
: Facultatif. Niveau de journalisation des appels à appliquer lors de l'exécution. Peut être une valeur parmi :none
: aucun niveau de journalisation n'est spécifié. Il s'agit de l'option par défaut. Un niveau de journalisation d'exécution est prioritaire sur un niveau de journalisation de workflow, sauf si celui-ci n'est pas spécifié (valeur par défaut). Dans ce cas, le niveau de journalisation du workflow s'applique.log-errors-only
: journalise toutes les exceptions interceptées, ou lorsqu'un appel est arrêté en raison d'une exception.log-all-calls
: journalise tous les appels aux sous-workflows ou aux fonctions de la bibliothèque, ainsi que leurs résultats.log-none
: aucune journalisation des appels.
DESCRIPTION
: Facultatif. Une description du le workflow de ML.LABEL_KEY=LABEL_VALUE
: Facultatif. Liste de paires clé-valeur d'étiquettes qui vous aide à organiser vos aux instances Google Cloud ; Exemple :name=wrench
. Pour plus pour en savoir plus, consultez Que sont les libellés ? Les libellés de workflow sont hérités par les exécutions du workflow. Pour afficher étiquettes d'exécution, utilisez la méthodeworkflows.executions.list
pour répertorier et filtrer les exécutions de workflow ;ENV_KEY=ENV_VALUE
: Facultatif. Liste de les paires clé-valeur des variable d'environnement ; Exemple :MONTH=January
. Pour Pour en savoir plus, consultez Utilisez des variables d'environnement.ENCRYPT_KEY
: Facultatif. Un service Cloud KMS que le workflow doit utiliser pour le chiffrement des données au formatprojects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME
Pour en savoir plus, consultez la page Utiliser des clés de chiffrement gérées par le client.SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com
: Facultatif. Le compte de service que votre workflow utilisera pour accéder à d'autres services Google Cloud. Pour en savoir plus, dans ce document, consultez Créer un compte de service.YAML_OR_JSON_SOURCE_FILE
: fichier source de la définition du workflow. Exemple :myFirstWorkflow.yaml
.
REST
Pour créer un workflow portant un nom spécifique, utilisez la méthode
projects.locations.workflows.create
et utilisez le paramètre de requête workflowId
pour spécifier un ID pour la
le workflow de ML.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
WORKFLOW_NAME
: nom de votre (par exemple,myFirstWorkflow
). Le nom peut contenir des lettres, des chiffres, des traits de soulignement et des traits d'union. Il doit commencer par une lettre et se terminer par un chiffre ou une lettre.DESCRIPTION
: Facultatif. Une description de votre workflow. Ne doit pas dépasser 1 000 caractères Unicode.LABEL_KEY
etLABEL_VALUE
: facultatif. Carte d'étiquettes clés et valeurs qui vous aident à organiser vos instances Google Cloud. Par exemple:{"name": "wrench", "mass": "1kg", "count": "3"}
Pour en savoir plus, consultez Que sont les libellés ? Procédure Les libellés sont hérités par les exécutions du workflow. Pour afficher les étiquettes d'exécution, utilisez laworkflows.executions.list
pour répertorier et filtrer les exécutions de workflow. <ph type="x-smartling-placeholder">SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com
: facultatif. Le service que votre workflow utilisera pour accéder à d'autres services Google Cloud. L'ID du projet est l'ID de votre projet Google Cloud. Pour plus d'informations, reportez-vous à la section Créez un compte de service.ENCRYPT_KEY
: Facultatif. A Clé Cloud KMS que le workflow doit utiliser pour le chiffrement des données au formatprojects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME
Pour en savoir plus, consultez Utiliser des clés de chiffrement gérées par le client.CALL_LOGGING_LEVEL
: Facultatif. Niveau de journalisation des appels à appliquer lors de l'exécution. Par défaut, aucun niveau de journalisation spécifié, et le niveau de journalisation du workflow s'applique à la place. Pour en savoir plus, consultez Envoyez des journaux à Logging. L'une des suivantes: <ph type="x-smartling-placeholder">- </ph>
CALL_LOG_LEVEL_UNSPECIFIED
: aucun niveau de journalisation n'est spécifié et le niveau de journalisation du workflow s'applique à la place. Il s'agit de la valeur par défaut. Sinon, le niveau de journalisation s'applique et prévaut sur le niveau de journalisation du workflow.LOG_ERRORS_ONLY
: journalise toutes les exceptions interceptées. ou lorsqu'un appel est arrêté en raison d'une exception.LOG_ALL_CALLS
: journalise tous les appels de sous-workflows ou de fonctions de bibliothèque et leurs résultats.LOG_NONE
: aucune journalisation des appels.
ENV_KEY
etENV_VALUE
: facultatif. Une carte de les paires clé/valeur des variable d'environnement ; Exemple :{ "month": "January", "day": "Monday"}
Pour en savoir plus, consultez Utilisez des variables d'environnement.SOURCE_CODE
: workflow définition. Vous devez échapper les nouvelles lignes en YAML. Par exemple :main:\n params:\n - input\n steps:\n - returnOutput:\n return: Hello
.Vous devez échapper les guillemets dans JSON. Par exemple :
{\"main\":{\"params\":[\"input\"],\"steps\":[{\"returnOutput\":{\"return\":\"Hello\"}}]}}
LOCATION
: le région dans laquelle le workflow doit être déployé, par exemple :us-central1
.
Corps JSON de la requête :
{ "name": "WORKFLOW_NAME", "description": "DESCRIPTION", "labels": {"LABEL_KEY":"LABEL_VALUE"}, "serviceAccount": "SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com", "cryptoKeyName": "ENCRYPT_KEY", "callLogLevel": "CALL_LOGGING_LEVEL", "userEnvVars": {"ENV_KEY":"ENV_VALUE"}, "sourceContents": "SOURCE_CODE" }
Pour envoyer votre requête, développez l'une des options suivantes :
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Operation
:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.workflows.v1.OperationMetadata", "createTime": "2023-12-05T14:06:06.338390918Z", "target": "projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_NAME", "verb": "create", "apiVersion": "v1" }, "done": false }
Si la valeur de "done"
est définie sur false
, l'opération est toujours en cours.
Répertorier les workflows
Vous pouvez répertorier les workflows ou utiliser des filtres pour récupérer un workflow spécifique.
Console
Dans la console Google Cloud, accédez à la page Workflows.
Cette page répertorie vos flux de travail dans tous les emplacements et fournit des informations détaillées : tels que les noms, les régions, les dernières révisions, etc.
Pour filtrer vos workflows:
- Cliquez sur Filtrer . ou le champ Filtrer les workflows.
- Dans la liste Propriétés, sélectionnez une option pour filtrer les workflows.
Vous pouvez sélectionner une seule propriété ou utiliser l'opérateur logique
OR
pour ajouter d'autres propriétés.Pour trier vos flux de travail, à côté d'un en-tête de colonne pris en charge, cliquez sur
Trier :
gcloud
Lister les workflows à l'aide de la méthode
Commande gcloud workflows list
:
gcloud workflows list --location=LOCATION
Remplacez LOCATION
par l'ID ou par le terme complet.
identifiant de l'emplacement de votre workflow.
Cette commande liste vos workflows à l'emplacement spécifié et inclut
des détails tels que les champs NAME
, STATE
, REVISION_ID
et
UPDATE_TIME
REST
Pour répertorier les workflows d'un projet et d'un emplacement donnés, utilisez la
projects.locations.workflows.list
.
Pour récupérer les détails d'un workflow unique, vous pouvez également
projects.locations.workflows.get
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID de votre projet Google Cloud.LOCATION
: le région dans laquelle les workflows sont déployés, exemple :us-central1
.
Pour envoyer votre requête, développez l'une des options suivantes :
Si la requête aboutit, le corps de la réponse contient des instances de Workflow
et la réponse doit ressembler à ce qui suit :
{ "workflows": [ { "name": "projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_NAME", "state": "ACTIVE", "revisionId": "000001-0ce", "createTime": "2023-12-08T13:56:59.306770745Z", "updateTime": "2023-12-08T13:56:59.547021939Z", "revisionCreateTime": "2023-12-08T13:56:59.340161044Z", "serviceAccount": "projects/PROJECT_ID/serviceAccounts/PROJECT_NUMBER-compute@developer.gserviceaccount.com", "sourceContents": "main:\n params: [input]\n [...] return: '${wikiResult.body[1]}'\n" }, { object (Workflow) } ], "nextPageToken": string, "unreachable": [ string ] }
Mettre à jour un workflow
Vous pouvez mettre à jour un workflow existant. Vous devez spécifier le nom du workflow mettre à jour et sa source. Notez que vous ne pouvez pas modifier le nom d'un workflow ou l'emplacement.
La mise à jour d'un workflow n'a aucune incidence sur les exécutions en cours. À venir uniquement les exécutions du workflow utilisent la configuration mise à jour.
Chaque fois que vous mettez à jour un workflow, son versionID
est mis à jour. L'versionID
comprend deux parties, séparées par un trait d'union:
Nombre (commençant par 1) qui s'incrémente chaque fois que vous mettez à jour un workflow.
Chaîne alphanumérique aléatoire à trois caractères.
Par exemple, 000001-27f
indique la version initiale d'un workflow et
000002-d52
indique un workflow qui a été mis à jour une fois.
Console
Dans la console Google Cloud, accédez à la page Workflows.
Cliquez sur le nom du workflow que vous souhaitez mettre à jour. Notez que vous ne pouvez pas modifier le nom du workflow.
La page Détails du workflow s'affiche.
Vous pouvez modifier le workflow de différentes manières:
Pour modifier la source:
- Cliquez sur l'onglet Source.
- Cliquez sur Modifier.
- Pour enregistrer vos modifications, cliquez sur Enregistrer. Le workflow mis à jour est déployés.
Pour mettre à jour la description, le compte de service utilisé par le workflow l'authentification, le niveau de journal d'appels, les variables d'environnement, les étiquettes la clé de chiffrement:
- Cliquez sur l'onglet Détails.
- Cliquez sur le bouton .
- Si vous mettez à jour le niveau des journaux d'appels, sélectionnez l'une des options suivantes:
<ph type="x-smartling-placeholder">
- </ph>
- Non spécifié: aucun niveau de journalisation n'est spécifié. Il s'agit de l'option par défaut. Un niveau de journalisation d'exécution est prioritaire sur tout niveau de journalisation de workflow, sauf si celui-ci n'est pas spécifié (valeur par défaut). Dans ce cas, le niveau de journalisation du workflow s'applique.
- Erreurs uniquement: consigne toutes les exceptions interceptées, ou lorsqu'un appel est arrêté en raison d'une exception.
- Tous les appels: consigne tous les appels aux sous-workflows ou aux fonctions de la bibliothèque, ainsi que leurs résultats.
- Aucun journal: aucun journal d'appels.
- Si vous mettez à jour un libellé existant ou en ajoutez un nouveau, votre
à 10 minutes pour que le nouveau libellé soit pris en compte. Les libellés de workflow sont
héritées par les exécutions du workflow. Pour afficher les étiquettes d'exécution,
utilisez la méthode
workflows.executions.list
pour répertorier et filtrer les exécutions de workflow ; - Pour enregistrer vos modifications, cliquez sur Enregistrer. Le workflow mis à jour est déployés.
Pour modifier les champs précédents en même temps, ou pour ajouter ou mettre à jour un déclencheur:
- Cliquez sur Modifier.
- Pour modifier la source, cliquez sur Suivant.
- Pour enregistrer vos modifications et déployer le workflow mis à jour, cliquez sur Déployer :
Si vous souhaitez mettre à jour les rôles de votre compte de service, cliquez sur le bouton Onglet Autorisations.
Les comptes principaux sont des utilisateurs, des groupes, des domaines ou des comptes de service. Pour mettre à jour un compte principal existant:
- Recherchez une ligne contenant le compte principal.
- Cliquez sur Modifier le compte principal ligne.
- Cliquez sur Ajouter rôle ou cliquez sur Supprimer rôle.
Si vous ajoutez un rôle, sélectionnez un rôle dans la liste Sélectionnez un rôle. le rôle approprié.
Pour ajouter un autre rôle, cliquez sur Ajouter un autre rôle.
Cliquez sur Enregistrer.
gcloud
Ouvrez un terminal.
Sélectionnez le nom du workflow que vous souhaitez mettre à jour. Si vous ne connaissez pas le nom du workflow, vous pouvez saisir la commande suivante pour répertorier tous vos workflows:
gcloud workflows list
Localisez le fichier YAML ou JSON dans lequel la source de votre workflow est enregistrée. comme
WORKFLOW_NAME.YAML
ouWORKFLOW_NAME.JSON
Vous pouvez mettre à jour un workflow existant en modifiant sa source, sa description les étiquettes, les variables d'environnement, le niveau du journal d'appels, la clé de chiffrement compte de service associé à l'aide du
gcloud workflows deploy
.Vous devez spécifier le nom du workflow que vous souhaitez mettre à jour et ses source; les autres options sont facultatives. Pour supprimer un clé de chiffrement gérée par le client, utilisez l'option
--clear-kms-key
.gcloud workflows deploy WORKFLOW_NAME \ --call-log-level=CALL_LOGGING_LEVEL \ --description="DESCRIPTION" \ --labels="LABEL_KEY=LABEL_VALUE" \ --set-env-vars="ENV_KEY=ENV_VALUE" \ --kms-key=ENCRYPT_KEY \ --service-account=SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com \ --source=YAML_OR_JSON_SOURCE_FILE
Remplacez les éléments suivants :
WORKFLOW_NAME
: Obligatoire. Nom de votre workflow.CALL_LOGGING_LEVEL
: Facultatif. Niveau de journalisation des appels à appliquer le workflow de ML. Peut être une valeur parmi :none
: aucun niveau de journalisation n'est spécifié. Il s'agit de l'option par défaut. Un niveau de journalisation d'exécution est prioritaire sur un niveau de journalisation de workflow, sauf si celui-ci n'est pas spécifié (valeur par défaut). Dans ce cas, le niveau de journalisation du workflow s'applique.log-errors-only
: journalise toutes les exceptions interceptées, ou lorsqu'un appel est arrêté en raison d'une exception.log-all-calls
: journalise tous les appels aux sous-workflows ou aux fonctions de la bibliothèque, ainsi que leurs résultats.log-none
: aucune journalisation des appels.
DESCRIPTION
: Facultatif. Une description du le workflow de ML.LABEL_KEY=LABEL_VALUE
: Facultatif. Liste de paires clé-valeur d'étiquettes qui vous aide à organiser vos aux instances Google Cloud ; Exemple :name=wrench
. Pour plus pour en savoir plus, consultez Que sont les libellés ? Les libellés de workflow sont hérités par les exécutions du workflow. Pour afficher étiquettes d'exécution, utilisez la méthodeworkflows.executions.list
pour répertorier et filtrer les exécutions de workflow ;ENV_KEY=ENV_VALUE
: Facultatif. Liste de les paires clé-valeur des variable d'environnement ; Exemple :MONTH=January
. Pour Pour en savoir plus, consultez Utilisez des variables d'environnement.ENCRYPT_KEY
: Facultatif. Un service Cloud KMS que le workflow doit utiliser pour le chiffrement des données au formatprojects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME
Pour en savoir plus, consultez la page Utiliser des clés de chiffrement gérées par le client.SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com
: Facultatif. Le compte de service que votre workflow utilisera pour accéder à d'autres services Google Cloud. Si vous souhaitez mettre à jour les rôles compte de service, consultez Autoriser un workflow à accéder aux ressources Google Cloud et Gérer l'accès aux projets, aux dossiers et aux organisationsYAML_OR_JSON_SOURCE_FILE
: Obligatoire. La source du workflow au format YAML ou JSON. Exemple :myFirstWorkflow.yaml
.
REST
Pour mettre à jour un workflow existant, utilisez la
projects.locations.workflows.patch
et utiliser éventuellement le paramètre de requête updateMask
pour spécifier une liste
de champs à mettre à jour.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
WORKFLOW_NAME
: nom de votre (par exemple,myFirstWorkflow
).DESCRIPTION
: Facultatif. Une description de votre workflow. Ne doit pas dépasser 1 000 caractères Unicode.LABEL_KEY
etLABEL_VALUE
: facultatif. Carte d'étiquettes clés et valeurs qui vous aident à organiser vos instances Google Cloud. Par exemple:{"name": "wrench", "mass": "1kg", "count": "3"}
Pour en savoir plus, consultez Que sont les libellés ? Procédure Les libellés sont hérités par les exécutions du workflow. Pour afficher les étiquettes d'exécution, utilisez laworkflows.executions.list
pour répertorier et filtrer les exécutions de workflow. <ph type="x-smartling-placeholder">SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com
: facultatif. Le service que votre workflow utilisera pour accéder à d'autres services Google Cloud. L'ID du projet est l'ID de votre projet Google Cloud. Pour plus d'informations, reportez-vous à la section Créez un compte de service.ENCRYPT_KEY
: Facultatif. A Clé Cloud KMS que le workflow doit utiliser pour le chiffrement des données au formatprojects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME
Pour en savoir plus, consultez Utiliser des clés de chiffrement gérées par le client.CALL_LOGGING_LEVEL
: Facultatif. Niveau de journalisation des appels à appliquer lors de l'exécution. Par défaut, aucun niveau de journalisation spécifié, et le niveau de journalisation du workflow s'applique à la place. Pour en savoir plus, consultez Envoyez des journaux à Logging. L'une des suivantes: <ph type="x-smartling-placeholder">- </ph>
CALL_LOG_LEVEL_UNSPECIFIED
: aucun niveau de journalisation n'est spécifié et le niveau de journalisation du workflow s'applique à la place. Il s'agit de la valeur par défaut. Sinon, le niveau de journalisation s'applique et prévaut sur le niveau de journalisation du workflow.LOG_ERRORS_ONLY
: journalise toutes les exceptions interceptées. ou lorsqu'un appel est arrêté en raison d'une exception.LOG_ALL_CALLS
: journalise tous les appels de sous-workflows ou de fonctions de bibliothèque et leurs résultats.LOG_NONE
: aucune journalisation des appels.
ENV_KEY
etENV_VALUE
: facultatif. Une carte de les paires clé/valeur des variable d'environnement ; Exemple :{ "month": "January", "day": "Monday"}
Pour en savoir plus, consultez Utilisez des variables d'environnement.SOURCE_CODE
: workflow réduit définition. Par exemple :{\"main\":{\"params\":[\"input\"],\"steps\":[{\"returnOutput\":{\"return\":\"Hello\"}}]}}
.LOCATION
: le région dans laquelle le workflow est déployé, par exempleus-central1
UPDATE_FIELDS
: Facultatif. A des champs à mettre à jour, séparés par une virgule. Si aucune valeur n'est fournie, le workflow est intégralement mis à jour. Par exemple,description,callLogLevel
.
Corps JSON de la requête :
{ "name": "WORKFLOW_NAME", "description": "DESCRIPTION", "labels": {"LABEL_KEY":"LABEL_VALUE"}, "serviceAccount": "SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com", "cryptoKeyName": "ENCRYPT_KEY", "callLogLevel": "CALL_LOGGING_LEVEL", "userEnvVars": {"ENV_KEY":"ENV_VALUE"}, "sourceContents": "SOURCE_CODE" }
Pour envoyer votre requête, développez l'une des options suivantes :
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Operation
:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.workflows.v1.OperationMetadata", "createTime": "2023-12-05T14:06:06.338390918Z", "target": "projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_NAME", "verb": "update", "apiVersion": "v1" }, "done": false }
Si la valeur de "done"
est définie sur false
, l'opération est toujours en cours.
Supprimer un workflow
Vous pouvez supprimer un workflow existant. La suppression d'un workflow supprime également ses et annule toutes les exécutions actives du workflow.
Console
Dans la console Google Cloud, accédez à la page Workflows.
Cliquez sur le nom du workflow que vous souhaitez supprimer, puis sur
Supprimer.Lorsque vous êtes invité à confirmer la suppression, saisissez le nom du workflow.
Cliquez sur Confirmer.
gcloud
Ouvrez un terminal.
Recherchez le nom du workflow que vous souhaitez supprimer. Si vous ne connaissez pas le nom du workflow, vous pouvez saisir la commande suivante pour répertorier tous vos workflows:
gcloud workflows list
Supprimer un workflow à l'aide de la méthode Commande
gcloud workflows delete
:gcloud workflows delete WORKFLOW_NAME
Remplacez
WORKFLOW_NAME
par le nom de votre le workflow de ML.
REST
Pour supprimer un workflow portant un nom spécifique, utilisez la méthode
projects.locations.workflows.delete
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
WORKFLOW_NAME
: nom du que vous souhaitez supprimer.PROJECT_ID
: ID de votre projet Google Cloud.LOCATION
: le région dans laquelle le workflow est déployé, exemple :us-central1
.
Pour envoyer votre requête, développez l'une des options suivantes :
Si la requête aboutit, le corps de la réponse contient une instance de Operation
:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.workflows.v1.OperationMetadata", "createTime": "2023-12-05T14:06:06.338390918Z", "target": "projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_NAME", "verb": "delete", "apiVersion": "v1" }, "done": false }
Si la valeur de "done"
est définie sur false
, l'opération est toujours en cours.