调试概览

以下信息可帮助您调试工作流，并协助您部署可靠、可预测且经过优化的工作流。

项目和环境	理想情况下，为保护生产环境资源，请为每个环境使用单独的项目：一个用于开发任务的项目；一个用于应用测试的项目；一个用于将开发内容合并到构建系统的模拟环境项目；以及一个用于生产环境且包含最终 build 的项目。 或者，使用单独的工作流。
创建工作流	您可以在 Google Cloud 控制台编辑器中编写工作流，也可以使用首选 IDE 或源代码编辑器编写。 修改 YAML 文件容易出错。 在 IDE 或编辑器中设置自动补全，以减少在开发工作流时出现拼写错误和其他常见错误。适用于工作流的 Google Cloud 控制台编辑器确实提供了一些 YAML 和语法验证以及自动补全功能；不过，可能存在必须修正的语法错误，而这些错误只有在部署时才会被发现。请参阅 YAML 缩进。
工作流部署	您必须从 Google Cloud 项目 部署工作流，才能执行该工作流以进行测试。
执行工作流	测试工作流时，您可以使用 gcloud CLI 或在 Google Cloud 控制台中执行工作流： 使用 gcloud workflows run 从命令行执行工作流并查看结果。 使用 Google Cloud 控制台执行工作流，并在输出窗格中查看结果。 您可以在 Google Cloud 控制台中或使用 gcloud CLI 访问工作流执行结果。如果您是从命令行进行测试，则可能需要在 Google Cloud 控制台的工作流详情页面中查看日志。 您可以检索指定工作流执行的历史记录，以步骤条目列表的形式显示，每个条目都提供有助于您确定错误来源或优化工作流性能的信息。 您可以使用内置的环境变量访问工作流的环境信息（例如其位置或项目标识符）。内置环境变量不需要声明，并且每次执行工作流时都可以使用。 在工作流执行期间抛出的错误包含标记，以帮助您确定错误的原因。 您可以 检查任何长时间运行的执行操作的状态。 每个工作流执行都至少会自动触发两个执行日志：一个在执行开始时，一个在执行结束时。您可以在 Workflows 或 Cloud Logging 中查看日志。如需查看单个工作流的日志，请使用 Workflows 中的日志标签页。如需获取所有工作流的日志的汇总视图，请使用 Cloud Logging 中的 Logs Explorer 页面。 您可以将日志发送到 Cloud Logging： 通过启用调用日志记录可设置标志，以便记录工作流执行期间的每个调用步骤或异常。 通过创建使用来源中的 sys.log 函数的自定义日志。

后续步骤

• Workflows 的已知问题
• 监控工作流
• 问题排查
• 查看执行步骤的历史记录