将经典管道迁移到 YAML

Azure DevOps Services

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

先决条件

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

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

创建示例 YAML 管道

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

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

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

    Two buttons to select for new pipeline creation.

  3. 选择源代码的位置作为 GitHubAzure Repos Git

    List of possible selections for your source code.

  4. 选择存储库。

    Page where you select a repository for your source code pipeline.

  5. 在“配置管道”页上,选择 “启动器管道”。

    List of templates to choose from for configuring your new pipeline.

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

    Review page where you select Save and run.

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

    Commit message to commit to the main branch, and then select Save and run button.

导出经典管道

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

  1. 打开经典管道。

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

    Screenshot of context menu, to export your pipeline to YAML.

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

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

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

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

    Configure your pipeline task with Task Assistant.

  7. 保存并运行 管道。

清理资源

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

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

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

常见问题解答

当生成失败时,YAML 管道中是否存在创建工作项的任务?

YAML 管道在失败设置(如经典生成管道) 上没有创建工作项 。 可以使用几个选项自行创建此功能。

后续步骤

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