Resume promotion after the registry response disappears
The registry accepts a promotion tag and drops the response; retry sees the tag but cannot tell whether it was created by this operation.
- Focused work estimate
- 6h + prerequisites
- Priority in the scenario
- High
- Engineering practice
- Idempotency · Registry APIs · Recovery
Estimated field mix
- DevOps60%
- Integrations40%
Field percentages are editorial estimates of the ticket's engineering focus. They total 100%; they are not measured time, proficiency scores, or ownership evidence.
Review it, then add it to your workspace.
The board opens an editable draft; nothing is saved until you confirm it. Sign-in and workspace permissions apply, and Demo boards remain ephemeral.
Project context
A fictional scheduling API is rebuilt separately for test, staging, and production-like local environments. The resulting images differ, release notes list the branch instead of the artifact, and rollback rebuilds old source with new dependencies. Use a local registry simulator and synthetic deployments; no cluster or customer traffic is supplied.
Setup prerequisites
- Artifact digests
- Release states
- Health checks
Preceding work
Complete these dependencies, or supply their agreed outputs before taking this ticket.
- DREL-101 · Bind release identity to an artifact digest
- DREL-103 · Promote the built artifact instead of rebuilding it
- DREL-104 · Gate promotion on database compatibility
- DREL-105 · Canary one cohort with a measurable abort rule
- DREL-106 · Pause a release when deployment state drifts
- DREL-108 · Rollback to a known artifact without rebuilding source
Acceptance criteria
- Promotion uses deterministic operation identity
- Retry reads digest and operation metadata before mutation
- Conflicting existing tag becomes visible and blocks automatic continuation
Implementation constraints
- The registry adapter is local and provider responses are treated as untrusted input.
Verification to include
- Promote and replay one operation with the same result.
- Drop the acceptance response and separately precreate a conflicting tag.
Deliverables
- Idempotent promotion adapter and ambiguity tests
Rollout and recovery
Enable one registry namespace while retaining digest-only deployment.
Value of the work
For the engineer: Practice immutable promotion, release authority, compatibility gates, canaries, and rollback.
For the team: Review a delivery flow that can identify exactly what is running and restore a known artifact without rebuilding it.
Evidence boundaries
Outcome Evidence: Tests, patches, and runbooks are requested deliverables. They become Outcome Evidence only through a qualified Mission and immutable Evidence IDs.
Ownership Evidence: Independent adaptation must be observed under a declared verification policy and cite immutable Evidence IDs. Completing a planning ticket establishes no Ownership Evidence.