Présentation du débogage

Les informations suivantes peuvent vous aider à déboguer Workflows et à déployer un workflow fiable, prévisible et optimisé.

Projets et environnements
  • Idéalement, pour protéger vos ressources de production, utilisez des projets distincts pour chacun de vos environnements : un projet pour les tâches de développement, un projet pour les tests d'application, un projet de préproduction dans lequel le développement peut être fusionné avec le système créé, et un projet pour votre environnement de production où des versions finalisées sont disponibles.
  • Vous pouvez également utiliser des workflows distincts.
Création de workflow
  • Vous pouvez écrire votre workflow dans l'éditeur de la console Google Cloud, ou à l'aide de l'IDE ou de l'éditeur de code source de votre choix.
  • La modification des fichiers YAML peut entraîner des erreurs. Configurez la saisie semi-automatique dans votre IDE ou éditeur pour réduire les fautes de frappe et autres erreurs courantes lors du développement de votre workflow. L'éditeur de la console Google Cloud pour Workflows fournit du code YAML et de la syntaxe, ainsi que la saisie semi-automatique. Toutefois, il peut y avoir des erreurs de syntaxe devant être corrigées et qui ne sont détectées qu'au moment du déploiement. Consultez Retrait YAML.
Déploiement de workflow
Exécution du workflow
  • Lorsque vous testez un workflow, vous pouvez l'exécuter à l'aide de gcloud CLI ou dans la console Google Cloud :
    • Utilisez gcloud workflows run pour exécuter votre workflow à partir de la ligne de commande et afficher les résultats.
    • Utilisez la console Google Cloud pour exécuter votre workflow et afficher les résultats dans le volet Sortie.
  • Vous pouvez accéder aux résultats de l'exécution du workflow dans la console Google Cloud ou à l'aide de gcloud CLI. Si vous effectuez des tests à partir de la ligne de commande, vous souhaiterez probablement afficher les journaux dans la console Google Cloud, sur la page Détails du workflow.
  • Vous pouvez récupérer l'historique d'une exécution de workflow spécifiée sous la forme d'une liste d'entrées d'étape, chaque entrée fournissant des informations pouvant vous aider à déterminer la source d'une erreur ou à optimiser les performances d'un workflow.
  • Vous pouvez accéder aux informations d'environnement d'un workflow (telles que son emplacement ou son identifiant de projet) à l'aide de variables d'environnement intégrées. Les variables d'environnement intégrées ne nécessitent aucune déclaration et sont disponibles à chaque exécution de workflow.
  • Les erreurs générées lors de l'exécution d'un workflow contiennent des balises permettant d'identifier la cause de l'erreur.
  • Vous pouvez vérifier l'état de toute exécution de longue durée.
  • Chaque exécution de workflow déclenche automatiquement au moins deux journaux d'exécution: un au début d'une exécution et l'autre à la fin. Vous pouvez afficher les journaux dans Workflows ou dans Cloud Logging. Pour afficher les journaux d'un seul workflow, utilisez l'onglet Journaux de Workflows. Pour obtenir une vue globale des journaux de tous vos workflows, utilisez la page Explorateur de journaux dans Cloud Logging.
  • Vous pouvez envoyer des journaux à Cloud Logging:
    • Activez la journalisation des appels, qui vous permet de définir un indicateur afin que chaque étape ou exception d'appel pendant l'exécution de votre workflow soit journalisée.
    • En créant des journaux personnalisés qui utilisent la fonction sys.log dans votre source.

Étapes suivantes