用途:在 PyTorch 某版本正式转为稳定版(release go live)时,更新 tools/scripts/generate_binary_build_matrix.py 及其测试快照。
主要能力与涉及文件:脚本 generate_binary_build_matrix.py 是版本与通道架构的唯一来源;tools/tests/assets/build_matrix_*.json 为紧凑单行 JSON 快照,必须与脚本输出一致;tools/tests/update_test_assets.sh 为规范的重生成脚本;tools/tests/test_generate_binary_build_matrix.py 为测试入口。
使用方式:
- 先确认上线版本(如 2.12.0),典型状态为 CURRENT_NIGHTLY_VERSION="2.13.0"、CURRENT_CANDIDATE_VERSION="2.12.0"、CURRENT_STABLE_VERSION="2.11.0";本次只推进 CURRENT_STABLE_VERSION 至候选版本,不要改 nightly 或 candidate。
- 将 CURRENT_STABLE_VERSION 单行改为新稳定版本。
- 比较 CUDA_ARCHES_DICT 与 ROCM_ARCHES_DICT 的 nightly/test/release 三个通道,若 release 与 test 不同则把 release 提升为与 test 一致;并核对 STABLE_CUDA_VERSIONS 三个条目一致。
- 从仓库根目录用 shell 脚本重生成 fixture,不要用测试的 --update-reference-files(会输出 indent=2 造成巨大 diff)。示例命令:cd tools/tests 后依次运行 python3 ../scripts/generate_binary_build_matrix.py 加对应参数并重定向到各 assets/build_matrix_*.json。可跳过 update_test_assets.sh 中的 conda 相关行,因其在主分支已损坏且不再维护。
- 运行 python3 -m tools.tests.test_generate_binary_build_matrix,预期 7 个测试通过。
- 用 git diff --stat 检查改动最小:脚本约 4 行,7 个 fixture 各 1 行,fixture 差异应仅为 stable_version 变化。
- 提交与 PR 标题沿用历史格式,如“Release X.Y go live. Update release matrix”;分支从 upstream/main 建,推送到 fork 后向 pytorch/test-infra:main 提 PR。
限制与注意:不要美化 fixture 输出;不要动 nightly/candidate 版本;未提交的无关 WIP 应先 stash;资料未提供具体版本号以外的收费、平台或效果信息。