|
6 | 6 | This document covers the `cuda.core` release process. For other packages: |
7 | 7 | `cuda-bindings` and `cuda-python` involve a private repository and are not |
8 | 8 | documented here; `cuda-pathfinder` is largely automated by the |
9 | | -[release-cuda-pathfinder.yml](workflows/release-cuda-pathfinder.yml) |
| 9 | +[CI: Release](workflows/release.yml) |
10 | 10 | workflow. |
11 | 11 |
|
| 12 | +To release `cuda-pathfinder`, dispatch **CI: Release** with |
| 13 | +`component` set to `cuda-pathfinder`, `release-action` set |
| 14 | +to `full-release`, and `git-tag` set to the existing |
| 15 | +`cuda-pathfinder-v<VERSION>` tag. The workflow finds the successful |
| 16 | +tag-triggered CI run, checks release notes, creates or reuses a draft, |
| 17 | +builds and deploys versioned docs, and uploads the source archive, checksum, |
| 18 | +and wheels. It publishes to TestPyPI, verifies installation and the imported |
| 19 | +version, then publishes to PyPI and verifies again before publishing the |
| 20 | +GitHub Release without marking it as latest. A failed |
| 21 | +docs build prevents asset uploads, package publication, and finalization. |
| 22 | + |
| 23 | +The release-note checker runs from `git-tag`, not the workflow revision. |
| 24 | +For Pathfinder, that tag must contain a version |
| 25 | +of `ci/tools/check_release_notes.py` that writes `version=<VERSION>` to |
| 26 | +`GITHUB_OUTPUT`. The release-notes job rejects an empty version before |
| 27 | +documentation, asset uploads, or package publication can start. Pathfinder |
| 28 | +package publication also requires successful draft metadata preparation. |
| 29 | + |
| 30 | +The default `dry-run` action validates preparation, builds docs, and |
| 31 | +collects release artifacts without creating a GitHub Release or publishing |
| 32 | +packages. It can be dispatched from a development branch; use |
| 33 | +`dry-run-docs-branch` only when a preview deployment is needed. |
| 34 | + |
12 | 35 | Each section below provides detailed guidance for a step in the |
13 | 36 | [Release Checklist](ISSUE_TEMPLATE/release_checklist.yml). To start a |
14 | 37 | release, create a new issue from that template and work through it item by |
|
0 commit comments