如何调试 Azure DevOps YAML 文件？

Question

正如我所见，有 3 种方法可以编写 Azure DevOps 构建：

1. 使用 GUI 为每件小事添加任务
2. YAML
3. 很少的任务，大部分工作委托给 Powershell。仅将任务用于发布符号或测试等任务。

到目前为止，我是最后一种方式的粉丝，因为它允许我在本地调试大部分构建逻辑。但是，也有缺点：

1. 不传达构建结构
2. 没有详细的时间表

可以通过专用的 VSTS 日志记录命令解决后者，但这似乎很乏味。

我不认真考虑第一个选项，因为构建不被视为代码。

YAML 选项很有趣，但是如何在本地调试呢？所以，当他们调用我的 powershell 脚本时，我可以调试各种部分，但是有没有办法真正调试它？就像在本地运行一样，我不希望在 YAML 中放置断点，但是能够在脚本中中断（没有 ReadHost）会很棒。

Answer 1

在早期的代理中，它支持本地测试 YAML 配置，而无需针对服务器排队构建，但它只是内部的，根据我的测试，它现在不可用。详情请参考YAML getting started - Run local (internal only, public preview soon)。

因此，目前我们无法在本地完全调试 YAML。但是，Microsoft 已为 VSCode 的 Azure Pipelines 扩展添加了一项新功能。现在，您将能够直接从 VSCode 创建 Azure Pipelines，而无需离开 IDE。

输入 Visual Studio Code 的 Azure Pipelines 扩展。轮到你了 可以有语法高亮和 IntelliSense 知道 Azure 管道 YAML 格式。这意味着您将收到红色警报 “ink”，如果你写的是“tasks:”，你应该写的是“task:”。 IntelliSense 也是模式感知的。无论您在文件中的哪个位置，请按 Ctrl-Space（或 macOS 上的 Cmd-Space）查看接受的内容 指向文件。

您可以参考以下博客使用 VSCode 编辑/调试 YAML 文件：

• How to edit a YAML Azure DevOps Pipeline
• Using VS Code Extension for Azure Pipeline–Part1

此外，还有一张关于该问题的建议票：Ability to test YAML builds locally，状态为Under Review。你也可以去投票以在未来的版本中实现这一点。