如何将CircleCI构建流水线迁移至VSTS？

我之前帮团队完成过从CircleCI到Azure DevOps Pipelines（也就是你说的VSTS）的迁移，结合实际操作经验，分享下关键步骤和避坑点，应该能帮你顺利完成迁移：

• 先导出并梳理现有CircleCI的config.yml，把所有job、step、环境变量、缓存策略、部署逻辑都列出来，尤其是自定义脚本、依赖安装的特殊规则，避免遗漏细节。
• 统计CircleCI的专属功能：比如workflows的并行/串行逻辑、Orbs组件、缓存键规则，这些需要在Azure DevOps里找到对应的替代方案。

1. 流水线结构映射 #

• CircleCI里的jobs对应Azure DevOps的jobs，steps对应steps，结构逻辑基本一致，但语法有差异：比如CircleCI的run: command在Azure DevOps里要写成script: command。
• CircleCI的workflows对应Azure DevOps的stages+jobs依赖关系，用dependsOn字段实现串行执行，直接定义多个同级job即可实现并行。

2. 环境变量与密钥迁移 #

• 普通环境变量可以直接在Azure DevOps的**流水线库（Library）**里创建变量组统一管理；敏感密钥建议存到Azure Key Vault，再链接到变量组，比CircleCI的密钥管理更安全。
• 注意语法替换：CircleCI里的$VAR_NAME在Azure DevOps里要改成$(VAR_NAME)。

3. 缓存策略迁移 #

CircleCI的restore_cache/save_cache要替换成Azure DevOps的Cache任务，举个npm依赖缓存的例子：

- task: Cache@2
  inputs:
    key: 'npm | "$(Agent.OS)" | package-lock.json'
    restoreKeys: |
      npm | "$(Agent.OS)"
    path: $(npm_config_cache)
  displayName: Cache npm packages

缓存键规则可以参考CircleCI的逻辑，用操作系统、依赖锁文件生成唯一键，保证缓存命中率。

4. 依赖与构建步骤迁移 #

• 把CircleCI里的run: npm install这类命令直接转成Azure DevOps的script步骤，也可以用官方提供的任务（比如Node.js Install任务来指定特定Node版本）。
• 如果用到了CircleCI的Orbs（比如node orb），可以找Azure DevOps对应的任务扩展，或者手动写脚本实现相同功能。

5. 部署步骤迁移 #

• 如果之前用CircleCI部署到云服务（AWS、Azure等），Azure DevOps有现成的部署任务（比如Azure App Service Deploy、AWS CLI任务），直接替换即可。
• 自定义部署脚本可以直接复制到script步骤里，记得替换环境变量语法。

• 先创建测试分支，把迁移后的azure-pipelines.yml推上去触发流水线，对比CircleCI的执行日志，确保依赖安装、构建产物、部署结果完全一致。
• 重点检查缓存是否生效、环境变量是否正确加载、并行任务的执行效率是否符合预期。

• 微软托管的代理池（Agent Pool）操作系统版本可能和CircleCI有差异，比如Ubuntu版本，遇到依赖安装失败时要调整对应命令。
• 如果用到了CircleCI专属工具（比如circleci CLI），要替换成Azure DevOps的CLI（az devops）或者用官方任务实现。

内容的提问来源于stack exchange，提问作者ram