Skip to content

draft: promotion pipeline — build once, promote the artifact (RFC Flight half)#423

Closed
Omicron7 wants to merge 2 commits into
mainfrom
draft/promotion-pipeline
Closed

draft: promotion pipeline — build once, promote the artifact (RFC Flight half)#423
Omicron7 wants to merge 2 commits into
mainfrom
draft/promotion-pipeline

Conversation

@Omicron7

Copy link
Copy Markdown
Contributor

Summary

Implementation sketch for the Flight half of the Agentic Development Lifecycle RFC, opened as a draft to anchor the adoption discussion. Not for merge as-is — the deploy steps are TODO stubs; the value is the shape, naming, and open-questions list.

  • docs/promotion-pipeline.md — the design: image flow, tag naming (candidate-<n> / sha-<gitsha> / release-<r>), cru-deploy wrapper examples, required changes to the existing deploy actions, per-repo migration steps, and open questions.
  • build-candidate.yml — env-neutral candidate build from tip of main (skeleton).
  • promote.yml — resolves the digest actually running on stage and deploys that digest to production (race-free: what was reviewed is what ships), tags it release-<r>, marks the deployment in Datadog. Carries the shared production concurrency lock and binds the production GitHub Environment (the human gate).
  • rollback.yml — redeploy a prior release digest, --is-rollback marked; the future execution target for severity-gated auto-rollback.

Deliberately out of scope

Merge-gate / review-policy changes. This machinery works identically with or without human PR review — which is what lets it ship first, per the phased adoption plan.

Key open questions (details in the doc)

  1. BUILD secrets for env-neutral images (shared namespace vs prod-bound)
  2. Daily stage build scheduling (per-app cron vs central matrix in cru-deploy)
  3. Release record of truth (registry tag vs git tag vs DynamoDB ledger) + re-tag IAM for the deploy identities
  4. Deploy actions need an explicit image input (bypass <env>-<build> construction)

Relates to #421 / #422 (Datadog deploy telemetry — the observability side of the same phase).

🤖 Generated with Claude Code

Omicron7 and others added 2 commits July 15, 2026 15:14
Implementation sketch for the Flight half of the Agentic Development
Lifecycle RFC: env-neutral candidate builds, digest-based promotion of
the reviewed stage image to production, release tags as rollback points,
one-click rollback, and the shared production lock.

Design doc in docs/promotion-pipeline.md covers naming, cru-deploy
wrappers, required changes to the deploy actions (explicit image input),
app-repo migration steps, and open questions (env-neutral BUILD secrets,
release record of truth, re-tag IAM, stage build scheduling).

Merge-gate/review-policy changes are out of scope - this machinery works
with or without human PR review.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
deployment mark no longer exists in datadog-ci v5 (see PR #425); update
the stubs to the pinned dora deployment pattern, with rollback recorded
via a custom tag since dora has no --is-rollback.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@Omicron7

Copy link
Copy Markdown
Contributor Author

Superseded by #427 — the pipeline-v2 development branch implements this design for real (clean-break v2: new actions + workflows, no v1 modifications). The design doc evolved into docs/pipeline-v2.md on that branch; decision history lives in the design memo.

@Omicron7 Omicron7 closed this Jul 20, 2026
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