深入理解Arcade依赖流：Darc与Maestro实现自动化更新

【免费下载链接】arcadeTools that provide common build infrastructure for multiple .NET Foundation projects.项目地址: https://gitcode.com/gh_mirrors/arca/arcade

Arcade是为多个.NET Foundation项目提供通用构建基础设施的工具集，其核心功能之一是通过Darc和Maestro实现自动化依赖更新。本文将详细介绍这两个工具如何协同工作，帮助开发者轻松管理项目依赖，提升开发效率。

什么是Arcade依赖流？

Arcade依赖流是一套自动化工具链，旨在解决多仓库项目中的依赖管理难题。它通过Darc（命令行工具）和Maestro++（自动化服务）的协同工作，实现了依赖版本的自动查询、更新和PR创建，确保各个项目间的依赖始终保持同步和兼容。

传统的依赖管理需要开发者手动检查更新、修改配置文件并提交PR，不仅耗时费力，还容易出错。而Arcade依赖流通过以下方式解决这些问题：

• 自动化检测：实时监控依赖项的新版本发布
• 智能更新：根据预设规则自动更新依赖版本
• 自动PR创建：生成包含依赖更新的拉取请求
• 集成测试：在更新后自动运行测试确保兼容性

Darc：依赖管理的命令行利器

Darc（Dependency Arcade CLI）是Arcade依赖流的核心命令行工具，提供了查询、更新和管理依赖的全方位功能。它能够与Build Asset Registry（BAR）交互，获取构建资产信息，并执行git操作来更新依赖。

Darc的主要功能

1. 依赖查询：通过darc get-dependencies命令查看项目当前依赖状态，包括依赖项名称、版本和来源。

2. 依赖更新：使用darc update-dependencies命令自动更新项目依赖至最新版本。Darc会：

   • 查询BAR获取最新构建信息
   • 更新Version.Details.xml等配置文件
   • 提交更改并创建PR

3. 订阅管理：通过darc add-subscription命令创建订阅，当依赖项有新版本时自动触发更新。

4. 渠道管理：使用darc add-channel和darc get-channels命令管理构建渠道，控制依赖的流向。

Darc工作流程

Darc的典型工作流程如下：

1. 开发者使用darc update-dependencies更新本地依赖
2. Darc查询BAR获取最新依赖版本
3. 更新项目中的依赖配置文件
4. 提交更改并创建PR
5. PR通过审核后合并到主分支

Darc的实现代码主要位于src/Microsoft.DotNet.Darc/目录下，其中包含了与BAR交互、git操作和PR创建等核心功能。

Maestro++：自动化依赖流的大脑

Maestro++是Arcade依赖流的自动化服务，它通过监控构建渠道和订阅，自动触发依赖更新流程。Maestro++使用Darc作为底层工具，实现了跨仓库的依赖自动流动。

Maestro++的核心功能

1. 自动触发更新：当监控的渠道中有新构建发布时，自动触发依赖更新。

2. 跨仓库协调：管理多个仓库之间的依赖关系，确保更新按正确顺序传播。

3. 策略执行：根据预设策略（如自动合并条件、测试要求等）执行依赖更新。

4. ** speculative构建**：在正式合并前执行推测性构建，提前发现兼容性问题。

Maestro++工作流程

Maestro++的工作流程可以概括为：

1. 监控订阅的渠道，检测新构建
2. 当新构建可用时，使用Darc确定需要更新的仓库和文件
3. 对每个需要更新的仓库，使用Darc创建提交和PR
4. 根据策略自动合并通过测试的PR
5. 继续监控下游仓库的构建结果，确保依赖链的完整性

Maestro++的实现代码主要位于src/Microsoft.DotNet.Maestro/目录下，包含了渠道监控、依赖分析和自动PR管理等功能。

Darc与Maestro++的协同工作

Darc和Maestro++虽然功能不同，但它们紧密协作，共同构成了Arcade依赖流的完整解决方案。

协作流程

1. 依赖发布：当一个项目发布新版本时，其构建资产被上传到BAR。

2. 渠道更新：Maestro++监控渠道，检测到新的构建资产。

3. 依赖分析：Maestro++使用Darc分析哪些仓库需要更新依赖。

4. 自动更新：Maestro++调用Darc为每个受影响的仓库创建更新PR。

5. 测试验证：PR触发自动测试，确保依赖更新不会引入问题。

6. 自动合并：通过测试的PR根据策略自动合并。

7. 链式传播：下游仓库检测到依赖更新，重复上述过程。

依赖流可视化

下图展示了Arcade依赖流中版本更新的完整流程，包括 speculative 构建和自动合并机制：

这个流程确保了依赖更新能够快速、安全地在多个仓库之间传播，减少了手动干预的需求。

实际应用：渠道、分支与订阅

Arcade依赖流通过渠道（Channels）、分支（Branches）和订阅（Subscriptions）三个核心概念来管理依赖的流动。

渠道（Channels）

渠道是构建资产的逻辑分组，用于控制依赖的流向。每个渠道对应一个特定的发布阶段或产品版本。例如：

• .NET Core 3.0 Dev：开发阶段的构建
• .NET Core 2.1 Release：稳定发布的构建

开发者可以使用Darc命令管理渠道：

darc add-channel --name "MyChannel" --classification "Release" darc get-channels

分支（Branches）

每个仓库可以有多个分支，对应不同的开发阶段。Maestro++会根据分支与渠道的关联关系，决定将哪些构建资产流向哪些分支。

订阅（Subscriptions）

订阅定义了从一个渠道到一个仓库分支的依赖流动规则。当渠道中有新的构建时，订阅会触发自动更新。

下图展示了渠道、分支和订阅之间的关系：

通过这种机制，Arcade实现了依赖的精细化管理，确保不同开发阶段的项目能够获取到合适的依赖版本。

如何开始使用Arcade依赖流

要在你的项目中使用Arcade依赖流，需要完成以下步骤：

1. 安装Darc

首先，你需要安装Darc工具。可以通过以下命令从源码构建：

git clone https://gitcode.com/gh_mirrors/arca/arcade cd arcade ./build.sh

2. 配置认证

Darc需要访问Azure DevOps和GitHub等服务，因此需要配置认证信息：

darc authenticate --provider github --access-token <your-token> darc authenticate --provider azdo --access-token <your-token>

3. 创建订阅

使用Darc创建订阅，指定源渠道和目标仓库分支：

darc add-subscription --source-repo https://gitcode.com/gh_mirrors/arca/arcade --source-branch master --target-repo https://gitcode.com/your/repo --target-branch main --channel ".NET Eng - Latest"

4. 手动触发更新（可选）

如果需要立即更新依赖，可以手动运行：

darc update-dependencies --channel ".NET Eng - Latest"

完成这些步骤后，Maestro++将自动监控渠道更新，并在有新版本时为你的项目创建依赖更新PR。

总结

Arcade依赖流通过Darc和Maestro++的协同工作，为多仓库项目提供了强大的自动化依赖管理解决方案。它不仅减少了手动工作，还提高了依赖更新的速度和可靠性，是.NET生态系统中不可或缺的工具。

无论是小型项目还是大型企业级应用，Arcade依赖流都能帮助你更好地管理项目依赖，让你专注于核心功能的开发。如果你还没有尝试过，现在就开始探索Arcade依赖流的强大功能吧！

官方文档：Documentation/Darc.md 和 Documentation/Maestro.md 提供了更详细的使用指南和高级功能说明。

【免费下载链接】arcadeTools that provide common build infrastructure for multiple .NET Foundation projects.项目地址: https://gitcode.com/gh_mirrors/arca/arcade