如何控制Azure DevOps流水线的代理工作文件夹路径

使用自托管Azure代理时，系统会为每个作业自动在工作区根目录下分配任务目标路径，默认格式和示例为/home/xxxxx/azure/_work/<工作区编号>/t/，不少用户推测这个路径的分配逻辑和流水线名称直接相关，实际上默认路径的数字部分是代理按历史作业运行顺序分配的工作区标识，t目录是单作业的专属临时目录，和流水线名称没有直接绑定关系。

能否自定义控制路径分配规则 #

完全可以通过YAML流水线配置实现自定义路径控制，刚好适配大仓库多流水线共用单代理的使用场景——也就是让所有需要拉取同一大仓库的流水线，都把代码检出到同一个固定路径（比如/home/xxxxx/azure/_work/MyProject），最终只在磁盘上保留一份仓库副本，避免重复拉取占用存储和带宽。

具体配置实现步骤 #

• 第一步：关闭系统默认的自动检出行为。在YAML流水线的根级别添加checkout: none配置，阻止系统自动把关联仓库拉取到随机分配的临时任务目录下。
• 第二步：手动调用内置的Checkout任务，通过参数指定固定的检出路径。调用时通过path参数传入预先定义好的绝对路径，任务就会把代码拉取到指定位置，不会走系统自动分配的路径逻辑。

大仓库单代理共用场景的注意事项 #

• 所有流水线指向同一固定检出路径时，要避免多任务并行操作该目录：如果两个流水线同时在这个路径执行拉取、文件修改操作，会出现工作区冲突。可以给代理配置单并发运行模式，或为需要操作该仓库的任务设置互斥锁，保证同一时间只有一个任务使用该目录。
• 固定路径下的Git仓库不会重复下载全量内容：后续每次拉取只会同步增量变更，既减少了全量拉取的带宽消耗，也避免了每个流水线单独存一份仓库副本带来的磁盘空间占用，和预期的优化目标完全匹配。
• 不要尝试修改代理的基础工作目录配置来实现这个需求：调整代理根工作目录会影响所有作业的临时存储路径，反而会打乱原有任务的路径逻辑，通过手动指定检出路径的方式影响范围最小。

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