Skip to content

Align Python release process with immutable tag rules#42

Merged
daviburg merged 3 commits into
mainfrom
security/release-tag-process-before-tag-rules-clean
Jun 18, 2026
Merged

Align Python release process with immutable tag rules#42
daviburg merged 3 commits into
mainfrom
security/release-tag-process-before-tag-rules-clean

Conversation

@daviburg

Copy link
Copy Markdown
Member

What

Aligns the Python SDK release docs and ADO release template with the immutable-tag release process.

Why

We are preparing to add tag/release protection rules for Python after owner confirmation:

  • numeric/PEP440-style tag allowlist (Python uses bare numeric tags, not v*)
  • immutable release tag protection (deletion + non_fast_forward)

The current docs reference a non-existent .github/workflows/release.yml and recommend deleting/recreating failed release tags. The actual flow is Azure DevOps eng/ci/library-release.yml, which creates release/{version} and bare numeric tags, then creates a GitHub draft release and hands off to the partner PyPI release flow.

Changes

  • Documents the actual ADO release pipeline flow.
  • Removes the delete/recreate-tag retry path.
  • Recommends retrying with a new version, e.g. 1.2.3.post1.
  • Updates the ADO version regex to accept .postN versions so the documented retry path works.

Validation

  • Regex accepts 1.2.3, 1.2.3a1, 1.2.3b1, 1.2.3rc1, 1.2.3dev1, 1.2.3.post1.
  • Regex rejects v1.2.3 and 1.2.3-preview.1.
  • git diff --check passes.

-- Dobby

@daviburg daviburg requested a review from a team as a code owner June 16, 2026 17:07
@daviburg daviburg requested a review from hallvictoria June 16, 2026 17:11
@daviburg daviburg self-assigned this Jun 16, 2026
Comment thread eng/templates/official/jobs/bump-version.yml Outdated
@daviburg daviburg requested a review from hallvictoria June 18, 2026 18:15
@daviburg daviburg merged commit 94a92ab into main Jun 18, 2026
17 checks passed
@daviburg daviburg deleted the security/release-tag-process-before-tag-rules-clean branch June 18, 2026 19:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants