如何通过 VS Code 在 Azure DevOps YAML 文件中添加和验证自定义构建任务

Question

我有 Azure DevOps 自定义扩展，其中包含构建任务。我正在尝试在代码库中配置/编辑 YAML 文件，并通过 VS Code 将自定义构建任务添加到其中。我正在使用 Microsoft VS Code 扩展 docs-yaml 扩展来验证我的 YAML 文件。

如下图所示，Microsoft 构建模板中提供的所有构建任务均已成功验证，没有任何问题。但它未能验证我的构建任务sampletask@3。据我了解，YAML 文件正在根据称为管道架构的文件进行验证。我在以下位置找到了此架构文件 https://raw.githubusercontent.com/microsoft/azure-pipelines-vscode/v1.174.2/service-schema.json

1. 如何/是否可以将我的构建任务详细信息添加到管道模式文件中？
2. 如果上述方法不可行，有什么方法可以在 VS Code 中成功验证我的构建任务吗？

请参考下图。

参考 ：

• https://marketplace.visualstudio.com/items?itemName=docsmsft.docs-yaml
• https://learn.microsoft.com/en-us/azure/devops/pipelines/yaml-schema?view=azure-devops&tabs=schema%2Cparameter-schema

Answer 1

\n

如何通过 VS Code 在 Azure DevOps YAML 文件中添加和验证自定义构建任务

\n

\n

我无法使用扩展重现此问题docs-yaml。

\n

然后我测试了另一个常用的扩展Azure Pipelines，我可以像你一样重现这个问题。所以我大胆假设这个验证应该来自扩展的Azure Pipelines。您可以检查您的 Visual Studio 代码中是否安装了此扩展。

\n

安装该扩展并重新启动 VS Code 后，我可以看到验证信息：

\n

\n

要解决此问题，我们可以继续阅读文档Azure Pipelines for VS Code \xef\xbc\x9a

\n

\n

该扩展具有开箱即用的通用架构文件，其中包含/仅包含内置任务。您的组织中\n可能安装了自定义任务。要向扩展传授这些知识，请获取您的\n架构的副本并告诉扩展在哪里可以找到它。

\n

\n
1. 访问\n https://dev.azure.com/YOU-ORG-HERE/_apis/distributedtask/yamlschema\n并将输出保存为my-schema.json.
\n
2. 编辑工作区的\nsettings.json 以包含以下内容：{
   \n "[azure-pipelines].customSchemaFile": "./path/to/my-schema.json"}
\n
3. 重新启动 VS 代码。该扩展现在将根据您的架构进行验证。\n它将为您提供自定义任务的自动完成功能。
\n

\n

\n

第二步详细步骤：

\n

单击 VS 代码左下角的齿轮按钮Manage-> Settings，然后单击“工作区”->“扩展”->“Azure 管道”：

\n

\n

\n

我将yamlschema.json文件保存在所在的文件夹中settings.json。

\n

重新启动 VS Code 后，我可以在 VS Code 中成功验证该构建任务：

\n

\n