CUDA update policy - #104
Merged
Merged
Conversation
albanD
reviewed
Aug 20, 2026
albanD
left a comment
Contributor
There was a problem hiding this comment.
Mostly ok, just one small comment.
Comment on lines
+60
to
+66
| 3. Update CUDA in CD (prerequisite for CI enablement, **not** a qualification for release) | ||
| When: Evaluate if we have all packages for update is complete | ||
| Goal: Make sure all Linux and Windows wheel and libtorch binaries are produced on nightly. Nightly binaries on their own do not qualify the version for a release; they exist so that CI can be enabled and so users can test early. | ||
|
|
||
| 4. Update CUDA in CI (**this is the necessary condition to qualify for a CUDA version to be released as Experimental**) | ||
| When: Update CUDA in CD is complete and nightly binaries are green | ||
| Goal: Make sure the new CUDA version has both build and test jobs running in CI. All failing tests are identified, tracked with issues, and either fixed or explicitly accepted before branch cut. A version with no CI test coverage is not eligible for the release matrix. |
Contributor
There was a problem hiding this comment.
I'm surprised about this ordering? CI doesn't actually consume the CD result?
We could enable build + test in CI first. And then once good, enable CD ?
Contributor
Author
There was a problem hiding this comment.
Hi @albanD normally we do CD first since CD just builds binaries, followed up by CI which take considerably more time. Basically CD is build, CI is build+test. Resolving issues for CD help us to prepare for CI build and test. Since we would have caught the same issues in CI if we would start with CI first.
atalman
force-pushed
the
cuda_update_policy
branch
from
August 20, 2026 14:51
fea464d to
f8cd77b
Compare
ngimel
approved these changes
Aug 20, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Supersedes #74.
Same goal as #74 — write down the CUDA update policy the PyTorch team follows — with two changes based on review feedback.
1. Policy only; the upgrade runbook is dropped from the RFC
#74 also inlined the
CUDA/cuDNN Upgrade Runbookconsolidated frompytorch/builder. Those steps reference specific PRs, scripts and versions and change on every upgrade, while the RFC should be stable policy. They also duplicated a CUDA/cuDNN support table that is already maintained (and is current) in RELEASE.md. The runbook content is unchanged and preserved in #74; it should land as a runbook next to the CI/CD scripts it describes.A new
Relationship to RELEASE.md and the upgrade runbooksection states the split:pytorch/pytorchRELEASE.md — the per-release record and release mechanics (Release Compatibility Matrix, PyTorch CUDA Support Matrix, Accelerator Software, Drafting RCs, Modify release matrix);This mirrors CPython support, where RELEASE.md's
Pythonsection links out to RFC-0038. RELEASE.md'sAccelerator Softwaresection should get the same link to this RFC (follow-up PR inpytorch/pytorch).2. CI, not CD, is the gate for shipping a CUDA version
#74 said:
and defined the Experimental version as qualifying once it is "available in nightly releases (CD)". That is wrong: it makes buildable-in-nightly sufficient to ship, i.e. we could release a version nobody tested. Two principles are now stated explicitly and take precedence over the individual steps:
Resulting changes to the process:
Also fixed: the step-1 self-link pointed at the
cuda_updatebranch (would break once merged), theWindestypo, and a reference to conda platforms we no longer publish.Related RFCs for CUDA update:
pytorch/pytorch#147383
pytorch/pytorch#145544
pytorch/pytorch#138609
pytorch/pytorch#134015