Skip to content

Add Temporal-backed release automation - #2995

Open
eamsden wants to merge 44 commits into
mainfrom
eamsden/temporal-release-automation-python
Open

Add Temporal-backed release automation#2995
eamsden wants to merge 44 commits into
mainfrom
eamsden/temporal-release-automation-python

Conversation

@eamsden

@eamsden eamsden commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

What changed?

  • Automate release with one Temporal workflow implemented in Python.
  • Start and complete a release from the GitHub Actions run triggered when an SDK owner merges one valid release-note file.
  • Build the fixed native matrix and signed Maven payload, freeze their GitHub Actions artifact identities in Workflow state, publish Maven with bounded ambiguity recovery, then create the GitHub draft, attach assets, and make it public.
  • Keep release- and Maven-generation-specific task queues, GitHub App publication authentication, global publication concurrency, and credential-free candidate compilation.
  • Remove timers, separate approval and ownership workflows, manual takeover and recovery UI, and the former manual release workflow.

Why?

The current manu-matic Java release process contains footguns which have led to incidents. There is also enough fragility in the GitHub and Maven release process that dogfooding Temporal here seems reasonable. The Python implementation keeps the necessary orchestration and reconciliation in one readable operational path.

Breaking changes?

No SDK API changes.

The former manual prepare-release path is intentionally removed. Merging a valid release-note file is the release authorization and execution trigger.

Verification

  • 8 focused local tests using the Temporal ephemeral test server and mocked publication activities
  • Ruff formatting and lint
  • Strict mypy
  • uv lock consistency
  • Shell syntax and deterministic native/Maven archive smoke checks
  • Workflow YAML parsing, pinned Action validation, and permission-boundary checks
  • No scheduled or manual dispatch entrypoint in the Temporal release workflow

No release, test release, Maven publication, tag, GitHub release, or external Temporal operation was run while developing or testing this change.

Server PR

None.

Supersedes #2986.

@eamsden
eamsden force-pushed the eamsden/temporal-release-automation-python branch from fa2ee95 to 551ff6c Compare August 10, 2026 19:35
@eamsden
eamsden marked this pull request as ready for review August 10, 2026 19:36
@eamsden
eamsden requested a review from a team as a code owner August 10, 2026 19:36
@eamsden eamsden changed the title Add concise Temporal-backed Python release automation Add Temporal-backed release automation Aug 11, 2026
eamsden added 25 commits August 11, 2026 15:04
Orchestrate immutable sdk-java release candidates with transient GitHub Actions Workers, a no-input approval Update, privileged publication queues, and exact-state external reconciliation.
Make release progress explicitly staged and controllable, bind approval to a locked release-specific GitHub issue, and make Maven and GitHub publication reconciliation safe across ambiguous retries. Add a durable emergency handoff path, frozen Worker routing, prompt Activity cancellation, idempotent native builds, and focused local tests.
Harden the Temporal state machine, publication reconciliation, approval recovery, and transient Worker behavior. Add protected Maven generation authorization, draft-first exact asset handling, maintenance-branch recovery, and both automated and independent emergency paths.
Bind release workflows to the exact receipted Candidate run, separate candidate compilation from credentialed artifact storage, adopt fallback artifacts across reruns, and classify S3 absence without masking service failures.
@eamsden
eamsden force-pushed the eamsden/temporal-release-automation-python branch from 83b51f2 to 23eb331 Compare August 11, 2026 20:05
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.

1 participant