GitOps Progressive Delivery Canary Deployment Specification
Design an automated canary rollout specification using GitOps synchronization and progressive delivery.
Use this template to specify automated traffic shifting, health verification, and rollback automation within Kubernetes clusters managed by GitOps controllers.
Role: Lead Platform SRE Architect with deep expertise in GitOps synchronization engines, service meshes, and automated remediation.
Context
- Target Kubernetes cluster tier and topology: {{kubernetes_cluster_tier}}
- GitOps controller and synchronization engine: {{gitops_tooling}}
- Service mesh or ingress traffic router: {{traffic_manager}}
- Primary golden signal metrics and SLO thresholds: {{slo_metrics}}
- Automated rollback thresholds and criteria: {{rollback_triggers}}
- Canary traffic ramp-up schedule and evaluation intervals: {{canary_step_intervals}}
Task
Produce an exhaustive engineering specification for a GitOps-driven progressive delivery canary system that manages traffic shifting, real-time telemetry validation, and automated rollback orchestration.
Method
- Define the repository structure, branch synchronization, and CRD manifests for {{gitops_tooling}}.
- Configure traffic splitting mechanisms via {{traffic_manager}} to decouple release from deployment.
- Translate {{canary_step_intervals}} into step-by-step traffic weight percentage tiers and stabilization pauses.
- Specify statistical metric analysis queries against {{slo_metrics}} for each evaluation interval.
- Design automated fast-rollback mechanisms that execute immediately upon violating {{rollback_triggers}}.
- Establish GitOps reconciliation locks during active canary cycles to prevent state drift.
- Detail post-promotion cleanup, baseline synchronization, and incident webhook notification payloads.
Constraints
- MUST define automatic, zero-human-intervention rollbacks if {{rollback_triggers}} are breached.
- MUST NOT allow GitOps drift reconciliation to override an ongoing canary state machine.
- Traffic shifts must strictly adhere to the intervals specified in {{canary_step_intervals}}.
- Health evaluation metrics must be derived exclusively from {{slo_metrics}} baseline parameters.
Output format
Deliver the document using the following structured sections:
- Progressive Delivery System Architecture
- Traffic Routing & Canary Split Configuration
- Metric Analysis & Decision Engine Matrix
- Rollout Schedule & Step Progression Table
- Fast-Rollback State Machine & Alert Routing Total word count: 900–1,300 words.
Self-review
- Validate that metric queries in section 3 map directly to {{slo_metrics}}.
- Ensure rollback mechanisms are guaranteed to be fully automated without human confirmation.
- Check that GitOps synchronization conflicts with active canary steps are explicitly mitigated.
Explicit role, a named task, and discrete steps the model can follow.
Background, inputs and variables the model needs before it starts.
Hard boundaries — what the model must and must not do.
A named, field-level shape for the response.
Ordered work items that force analysis before an answer.
Length and structure that travel across frontier models.
Signal density — instruction weight without padding.
Documented variables so the scaffold adapts to new inputs.
Quality bar, assumptions and behaviour when inputs are thin.
How much real usage the template has behind it.