将经典管道迁移到 YAML

  • 项目

Azure DevOps Services

通过将现有经典管道转换为使用 YAML，开始使用 Azure Pipelines。 使用基于 YAML 的管道，可以将 CI/CD 策略作为代码实现，并查看其历史记录、比较版本、追溯、批注等。

转换经典管道时，最终产品是两个管道。 你将有一个新的 YAML 管道和一个可以停用的经典管道。 经典管道的运行历史记录将保留在经典管道中。

先决条件

在开始之前，请确保具有以下项。

  • 具有活动订阅的 Azure 帐户。 免费创建帐户。
  • 一个有效的 Azure DevOps 组织。 注册 Azure Pipelines。
  • 使用经典用户界面 (UI) 编辑器的工作管道。
  • 代码中的一个示例 YAML 管道文件。 在以下部分中创建一个示例 YAML 管道。

创建示例 YAML 管道

执行以下步骤来创建示例 YAML 管道，稍后将使用从经典 UI 编辑器导出的代码更新该管道。

  1. 登录到你的组织 (https://dev.azure.com/{yourorganization}) 并选择你的项目。

  2. 选择“ 管道”，然后选择“ 新建管道”。

    选择用于创建新管道的两个按钮。

  3. 选择源代码的位置作为 GitHub 或 Azure Repos Git。

    源代码的可能选择列表。

  4. 选择存储库。

    可在其中为源代码管道选择存储库的页面。

  5. 在“配置管道”页上，选择“ 初学者管道”。

    要从中选择用于配置新管道的模板列表。

  6. 选择“保存并运行”。

    “查看”页，可在其中选择“保存并运行”。

  7. 输入提交消息，选择“直接提交到main分支”，然后选择“保存并再次运行”。 新运行将启动，并提交到存储库。 等待运行完成。

    将消息提交到 main 分支，然后选择“保存并运行”按钮。

导出经典管道

执行以下步骤，将经典管道导出到可在编辑器中使用的 YAML 文件。

  1. 打开经典管道。

  2. 选择省略号 (...) ，然后选择“ 导出到 YAML”。

    上下文菜单的屏幕截图，用于将管道导出到 YAML。

  3. 在代码编辑器中打开下载的 YAML 文件。

  4. 如果 YAML 管道包括经典 UI 中定义的变量，请在管道设置 UI 或 YAML 文件中再次定义变量。 有关详细信息，请参阅 定义变量。

  5. 查看 YAML 文件中的任何 cron 计划。 默认情况下， cron YAML 中的计划采用 UTC 格式。 在经典管道中，它们位于组织的时区中。 有关详细信息，请参阅配置管道的计划。

  6. 使用任务助手对 YAML 文件进行任何其他更改。 任务助手是屏幕右侧的窗格，可帮助你正确创建和修改 YAML 步骤。

    使用任务助手配置管道任务。

  7. 保存并运行 管道。

清理资源

如果不再使用此示例管道，请从项目中删除它。 删除是永久性的，包括所有生成和关联的项目。

  1. 选择省略号 (...) ，然后选择“ 删除”。

  2. 输入管道的名称以永久删除它，然后选择“ 删除”。

常见问题解答

发生生成失败时，YAML 管道中是否存在创建工作项的任务？

YAML 管道没有失败 时创建工作项设置 ，如经典生成管道。 有几种选项可用于自行创建此功能。

后续步骤

了解 YAML 和经典管道之间的功能差异。

使用 Azure Pipelines