从Nexus迁移至Azure Artifacts的技术方案咨询

迁移前准备 #

• 环境配置：完成Azure DevOps组织、项目创建，分别创建对应Maven、NuGet、通用类型的Azure Artifacts feed；确保拥有Nexus的包读取/导出权限。
• 清单梳理：通过Nexus API或CLI工具导出所有待迁移包的完整清单，包含：
  • Maven包：groupId、artifactId、版本号、是否为快照包
  • NuGet包：包ID、版本号、是否包含符号包
  • 自定义包：文件名、版本、存储路径、包格式
• 工具安装：部署Azure CLI、NuGet CLI、Maven CLI，准备Python/PowerShell脚本用于批量处理。

分类型迁移步骤 #

Maven包迁移 #

• 批量拉取与推送流程：
  1. 基于导出的Maven清单，用脚本循环执行拉取命令：

     mvn dependency:get -DremoteRepositories=https://your-nexus-url/repository/maven-releases/ -Dartifact=com.example:demo:1.0.0 -Ddest=./maven-temp
     

  2. 配置Azure Artifacts的Maven源到本地settings.xml，添加对应的server节点（关联Azure PAT）。
  3. 循环执行推送命令：

     mvn deploy:deploy-file -Dfile=./maven-temp/demo-1.0.0.jar -DgroupId=com.example -DartifactId=demo -Dversion=1.0.0 -Durl=https://pkgs.dev.azure.com/your-org/your-project/_packaging/your-maven-feed/maven/v1 -DrepositoryId=azure-maven-feed
     

• 注意事项：快照包需提前在Azure feed设置中开启快照支持；优先迁移底层依赖包，避免依赖缺失导致推送失败。

NuGet包迁移 #

• 批量拉取与推送流程：
  1. 导出NuGet包清单后，循环执行拉取命令：

     nuget download DemoPackage -Source https://your-nexus-url/repository/nuget-hosted/ -Version 1.0.0 -OutputDirectory ./nuget-temp
     

  2. 配置Azure NuGet源：

     nuget sources Add -Name AzureNuFeed -Source https://pkgs.dev.azure.com/your-org/your-project/_packaging/your-nuget-feed/nuget/v3/index.json -Username az -Password your-azure-pat
     

  3. 循环推送包（含符号包）：

     nuget push ./nuget-temp/DemoPackage.1.0.0.nupkg -Source AzureNuFeed -ApiKey az
     nuget push ./nuget-temp/DemoPackage.1.0.0.snupkg -Source AzureNuFeed -ApiKey az
     

• 注意事项：确保NuGet CLI版本兼容Azure的v3源；若包存在依赖，需同步依赖包。

自定义包迁移 #

• 通用feed推送流程：
  1. 从Nexus raw仓库批量下载自定义包，保留原命名规则。
  2. 用Azure CLI循环推送：

     az artifacts universal publish --organization your-org --project your-project --feed your-universal-feed --name DemoCustom --version 1.0.0 --path ./custom-temp/demo.zip
     

• 注意事项：自定义包的名称和版本需符合Azure命名规范，避免特殊字符；脚本中可通过文件名解析版本信息，提升批量处理效率。

Azure侧限制下的运作方式 #

存储与带宽适配 #

• 迁移前统计所有包的总大小，对比Azure DevOps组织的存储配额，不足时提前购买额外存储。
• 分批次推送大体积包，每批次控制在10-20个，避免带宽耗尽或超时；跨区域迁移时优先选择就近的Azure DevOps区域。

权限与命名合规 #

• 迁移前配置Azure feed的权限：给开发团队分配读取权限，迁移账号分配推送权限，避免后续访问异常。
• 检查包命名：Maven包的groupId/artifactId不能包含@、#等特殊字符；NuGet包名称禁止空格；自定义包名称需符合Azure资源命名规则，不符合的提前在Nexus中重命名后再迁移。

版本冲突处理 #

• 迁移前对比Nexus与Azure的包清单，标记冲突版本：
  • 若需覆盖Azure中的包，先通过CLI删除对应版本：

    # Maven包删除
    az artifacts maven delete --organization your-org --project your-project --feed your-maven-feed --group-id com.example --artifact-id demo --version 1.0.0
    # NuGet包删除
    az artifacts nuget delete --organization your-org --project your-project --feed your-nuget-feed --package DemoPackage --version 1.0.0
    

  • 无需覆盖的直接跳过对应包。

速率限制规避 #

• Azure DevOps API存在速率限制，批量脚本中需添加延迟（每个包推送后等待1-2秒）；或使用Azure CLI的批量操作参数，降低请求频率，避免触发限流导致迁移中断。

迁移验证与收尾 #

• 抽样验证：从Azure feed中随机拉取不同类型的包，检查文件完整性、依赖关系是否正常。
• 源地址切换：更新所有项目的包源配置，替换为Azure Artifacts的源，测试项目构建是否成功。
• 冗余清理：保留Nexus包备份至少1个月，确认无问题后逐步停用Nexus的包服务。

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