用途:更新 dotnet/runtime 仓库中 Helix 队列定义文件里的 OS 版本引用,用于新增版本、替换已 EOL 版本,或对照 supported-os 矩阵审计覆盖。适用于 YAML/文档式队列与镜像引用更新,不涉及产品代码,通常无需基线构建。
主要能力:识别并修改 eng/pipelines/helix-platforms.yml、libraries/coreclr/installer 的 helix-queues-setup.yml、pipeline-with-resources.yml 及 docs/workflow/using-docker.md 中的版本引用;处理 latest/oldest 槽位;区分容器镜像格式与纯队列格式;处理 _internal 对应项;按发行版命名约定更新队列名与镜像标签;检查 release 分支;提示 supported-os 同步。
使用方式:用户提供发行版与版本、槽位、分支或审计模式。流程包括:用 MCR registry 标签列表确认目标镜像标签存在;先查 supported-os.json,必要时用 endoflife.date 核对生命周期;grep 扫描现有引用;逐文件更新版本注释、队列名与镜像标签,保留主机队列与变量名;重新 grep 验证无残留;按需触发 runtime-extra-platforms;检查 release 分支;最后创建 PR。
限制:不创建新容器镜像(应到 dotnet-buildtools-prereqs-docker 提 issue/PR);不更新 supported-os.json/md(应到 dotnet/core);不新增发行版或架构;不申请新 Helix VM 队列;Windows/macOS 队列需 dnceng 协调。servicing 分支应保守,仅用 GA 且已支持版本。镜像信息发布正处于过渡期,以 registry 标签为准。