progressive-delivery
Progressive delivery on Kubernetes — canary and blue-green deployments via Argo Rollouts, plus environment-to-environment promotion via Kargo. USE WHEN implementing canary releases, blue-green deployments, traffic shifting between revisions, metric-gated promotions, AnalysisTemplate/AnalysisRun design, Argo Rollouts CRDs, or Kargo freight/warehouse/stage promotion pipelines, multi-stage promotion across dev/staging/prod, ArgoCD+Kargo integration. Rollouts handles WHICH revision serves traffic; Kargo handles WHICH revision is in which environment. Use both together when you need both deployment strategy AND multi-environment promotion.
How do I install this agent skill?
npx skills add https://github.com/julianobarbosa/claude-code-skills --skill progressive-deliveryIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides comprehensive documentation and reference material for implementing progressive delivery on Kubernetes using Argo Rollouts and Kargo. It includes installation guides, core concepts, and YAML examples for canary and blue-green deployments. No security issues were detected, and the skill follows established best practices for these tools.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Progressive Delivery
Two complementary tools for moving versions safely through Kubernetes environments:
- Argo Rollouts — replaces
Deploymentwith aRolloutCRD that supports canary, blue-green, and metric-gated automated analysis. Handles traffic shaping at the cluster/service-mesh layer. - Kargo — extends GitOps with promotion logic. Tracks
Freight(versioned bundles of artifacts) and promotes it throughStages(dev → staging → prod) viaWarehouses(sources) and verification steps.
ArgoCD continues to do what it does (sync desired state → cluster). Rollouts decides traffic split during a single deploy. Kargo decides when the next stage gets the new version.
Scope routing
| If you need to… | Read |
|---|---|
| Canary / blue-green / metric-gated deploy of a single workload | References/argo-rollouts.md + References/argo-rollouts/ |
| Promote a version across dev → stg → prod with manual or automated gates | References/kargo.md + References/kargo/ |
| Both (Rollouts as the deploy strategy inside a Kargo-managed promotion) | Read both; Kargo invokes ArgoCD which deploys a Rollout |
Mental model
Kargo: Freight v1.2.3 -> [dev stage] -> verify -> [stg stage] -> verify -> [prod stage]
|
v
ArgoCD: syncs Rollout manifest
|
v
Rollouts: canary @ 10% -> analysis -> 50% -> 100%
When NOT to use
- Simple
Deploymentrollouts that don't need traffic shaping or analysis gates — vanilla Kubernetes Deployments are fine. - Manual promotion via PRs editing target revision — that's the core
argocdskill, not this one. - Feature flags and runtime percentage rollouts inside the app — that's an application concern (LaunchDarkly, Unleash, etc.), not a deployment one.
Gotchas
- Rollouts replaces Deployment; it is not an addition. Migrating an existing app means changing the resource kind. Plan for one revision of downtime if not handled with kubectl-argo-rollouts conversion.
- AnalysisTemplate metrics queries are scoped to the Rollouts controller's permissions. If your Prometheus is in another namespace, the controller needs RBAC or a service-account token.
- Kargo Freight is immutable. Once produced, you don't edit it — you produce new Freight. Trying to "patch" a Stage's current Freight is an anti-pattern.
- Kargo + ArgoCD integration requires Kargo's controller to have permission to update ArgoCD
ApplicationCRs. Default install doesn't grant this — read the Helm values forargocd.permissions. - Verification steps run between stages, not within them. A failing verification doesn't roll back the prior stage — it just blocks promotion forward. If you need rollback, that's a separate Rollouts-level analysis.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/julianobarbosa/claude-code-skills/progressive-delivery">View progressive-delivery on skillZs</a>