Présentation du débogage

Les informations suivantes peuvent vous aider à déboguer des 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 où le développement peut être fusionné dans le système compilé, et un projet pour votre environnement de production où les builds finalisés 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 d'un IDE ou d'un é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 votre é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 les workflows fournit une validation YAML et de syntaxe, ainsi qu'une saisie semi-automatique. Toutefois, il peut y avoir des erreurs de syntaxe qui doivent être corrigées et qui ne sont détectées qu'au moment du déploiement. Consultez la section Indentation YAML.
Déploiement du workflow
Exécution du workflow
  • Lorsque vous testez un workflow, vous pouvez l'exécuter à l'aide de la Google Cloud 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 Output (Sortie).
  • Vous pouvez accéder aux résultats d'exécution du workflow dans la console Google Cloud ou à l'aide de la 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'étapes, chacune fournissant des informations qui peuvent vous aider à déterminer la source d'une erreur ou à optimiser les performances d'un workflow.
  • Vous pouvez accéder aux informations sur l'environnement d'un workflow (telles que son emplacement ou son identifiant) à l'aide de variables d'environnement intégrées. Les variables d'environnement intégrées ne nécessitent pas de 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 tags permettant d'identifier l'origine 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: l'un au début 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 Logs (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:
    • En activant la journalisation des appels, qui vous permet de définir un indicateur pour que chaque étape d'appel ou exception lors de 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.

Étape suivante