name: ArgoRollouts
description: Argo Rollouts progressive delivery controller for Kubernetes. USE WHEN user mentions rollouts, canary deployments, blue-green deployments, progressive delivery, traffic shifting, analysis templates, or Argo Rollouts. Provides deployment strategies, CLI commands, metrics analysis, and YAML examples.

Argo Rollouts Skill

Comprehensive guide for Argo Rollouts - a Kubernetes controller providing advanced deployment capabilities including blue-green, canary, and experimentation for Kubernetes.

Quick Reference

Core Concepts

Rollout CRD

The Rollout resource replaces standard Kubernetes Deployment and provides:

• Blue-Green Strategy: Instant traffic switching between versions
• Canary Strategy: Gradual traffic shifting with analysis gates
• Traffic Management: Integration with service meshes and ingress controllers
• Automated Analysis: Metrics-based promotion/rollback decisions

Deployment Strategies

Blue-Green:

strategy:
  blueGreen:
    activeService: my-app-active
    previewService: my-app-preview
    autoPromotionEnabled: false

Canary:

strategy:
  canary:
    steps:
    - setWeight: 20
    - pause: {duration: 5m}
    - setWeight: 50
    - analysis:
        templates:
        - templateName: success-rate

Traffic Management Integrations

CLI Commands (kubectl-argo-rollouts)

# Installation
kubectl argo rollouts version

# Rollout Management
kubectl argo rollouts get rollout <name>
kubectl argo rollouts status <name>
kubectl argo rollouts promote <name>
kubectl argo rollouts abort <name>
kubectl argo rollouts retry <name>
kubectl argo rollouts undo <name>
kubectl argo rollouts pause <name>
kubectl argo rollouts restart <name>

# Dashboard
kubectl argo rollouts dashboard

# Validation
kubectl argo rollouts lint <file>

Analysis Providers

Reference Documentation

• Summary - Overview and architecture
• Deployment Strategies - Blue-green and canary details
• CLI Commands - kubectl plugin reference
• Analysis & Metrics - AnalysisTemplate configuration
• Examples - Complete YAML examples

Common Patterns

Canary with Automated Analysis

steps:
- setWeight: 10
- pause: {duration: 1m}
- analysis:
    templates:
    - templateName: success-rate
    args:
    - name: service-name
      value: my-service
- setWeight: 50
- pause: {duration: 2m}

Blue-Green with Pre-Promotion Analysis

strategy:
  blueGreen:
    activeService: active-svc
    previewService: preview-svc
    prePromotionAnalysis:
      templates:
      - templateName: smoke-tests
    autoPromotionEnabled: false

Troubleshooting

Best Practices

1. Always use analysis gates for production canaries
2. Set appropriate pause durations between weight increases
3. Configure rollback thresholds in AnalysisTemplates
4. Use preview services for blue-green validation
5. Monitor AnalysisRuns during deployments
6. Version your AnalysisTemplates alongside application code