Cross-Cluster Progressive Delivery with Argo + Hera

Multi-cluster progressive delivery system demonstrating cluster-level canary deployments using Argo Workflows, Rollouts, and Hera Python SDK.

Perfect for KubeCon EU 2026 presentations!

📚 Documentation

INSTALL.md - Complete installation guide from scratch (macOS)
DEMO.md - Step-by-step demo guide for KubeCon presentation
docs/TROUBLESHOOTING.md - Common issues and solutions
docs/STEP-9-PROGRESSIVE-DELIVERY.md - Progressive delivery details
docs/STEP-10-MONITORING.md - Monitoring and observability

Architecture

Dev Cluster → Stage Cluster → Prod US-East-1 → Prod US-West-2
     ↓              ↓               ↓                ↓
  Rollout       Rollout         Rollout          Rollout
     ↓              ↓               ↓                ↓
  Validate      Validate        Validate         Validate
     ↓              ↓               ↓                ↓
  Promote ────────→ Promote ──────→ Promote ──────→ Done

🚀 Getting Started

For First-Time Setup

Read INSTALL.md - Complete installation guide (45 minutes)
Follow all 12 steps - From zero to working demo
Verify setup - Run ./scripts/monitor.sh
Test workflow - Run python3.12 hera-workflows/working_pipeline.py

For Demo Presentation

Read DEMO.md - Complete demo script
Setup port forwards - Argo Workflows, ArgoCD, Dashboard
Practice the flow - 10-minute presentation
Use talking points - Why Hera, progressive delivery, multi-cluster

⚙️ Configuration

Environment Variable Overrides

The project supports environment variables to customize repository and image settings, making it portable to your own AWS account and GitHub repository.

Variable	Description	Default	Used By
`ECR_REPO`	ECR repository URL	`940019131157.dkr.ecr.us-east-1.amazonaws.com/argocon-demo`	`gitops_pipeline.py`
`ECR_REPO_TAG`	Image tag to deploy	`v5.0.0`	`gitops_pipeline.py`
`GITHUB_REPO_URL`	Full GitHub repository URL	`https://github.com/elamaran11/k8s-argo-workflows-hera`	`setup-argocd-apps.sh`
`GITHUB_SLUG`	GitHub owner/repo format	`elamaran11/k8s-argo-workflows-hera`	`gitops_pipeline.py`
`GITHUB_TOKEN`	GitHub personal access token	(none)	`gitops_pipeline.py`

Example Usage

# Setup ArgoCD with your own ECR and GitHub repo
ECR_REPO=123456789.dkr.ecr.us-west-2.amazonaws.com/my-app \
GITHUB_REPO_URL=https://github.com/myorg/my-repo \
./scripts/setup-argocd-apps.sh

# Run GitOps workflow with custom settings
ECR_REPO=123456789.dkr.ecr.us-west-2.amazonaws.com/my-app \
ECR_REPO_TAG=v2.0.0 \
GITHUB_SLUG=myorg/my-repo \
GITHUB_TOKEN=ghp_xxxx \
python3.12 hera-workflows/gitops_pipeline.py

Prerequisites

macOS (tested on Ventura/Sonoma)
AWS Account with admin access
Docker Desktop
Python 3.12
CLI Tools: kubectl, eksctl, argocd

See INSTALL.md for detailed installation instructions.

Key Features

✅ Hera Simplicity - Python SDK reduces YAML complexity
✅ Progressive Rollout - Region-by-region with validation gates
✅ Argo Rollouts - Canary deployments within each cluster
✅ ArgoCD - GitOps-based deployment automation
✅ Multi-Cluster - 4 EKS clusters across 2 AWS regions
✅ Real-time Monitoring - Custom dashboard + Argo UIs
✅ Production Ready - Argo Workflows v3.7.8 with emissary executor

What's Included

Infrastructure

4 EKS 1.34 clusters (dev, stage, prod-us-east-1, prod-us-west-2)
Argo Workflows v3.7.8
Argo Rollouts v1.7.2
Argo CD v2.13.2
Argo Events v1.9.2

Workflows

simple_example.py - Prints workflow YAML
working_pipeline.py - Demo workflow with echo commands
gitops_pipeline.py - Full GitOps promotion with Git operations

Monitoring

CLI monitoring script (scripts/monitor.sh)
Web dashboard (Flask app at http://localhost:5001)
Argo Workflows UI (https://localhost:2746)
ArgoCD UI (https://localhost:8080)

Demo Application

Simple Flask app with health endpoints
Docker builds for amd64 architecture
Stored in Amazon ECR
Deployed via Argo Rollouts with canary strategy

Repository Structure

.
├── INSTALL.md                    # Complete installation guide
├── DEMO.md                       # KubeCon demo script
├── README.md                     # This file
├── requirements.txt              # Python dependencies
├── infrastructure/               # Cluster and Argo configs
│   ├── cluster-template.yaml    # EKSCTL cluster template
│   ├── applicationset.yaml      # ArgoCD multi-cluster setup
│   ├── workflow-rbac.yaml       # Workflow RBAC permissions
│   └── argo-workflows-configmap.yaml  # Workflow controller config
├── hera-workflows/              # Hera Python workflows
│   ├── simple_example.py        # Basic example
│   ├── working_pipeline.py      # Demo workflow
│   └── gitops_pipeline.py       # Full GitOps workflow
├── environments/                # GitOps manifests
│   ├── dev/                     # Dev environment
│   ├── stage/                   # Stage environment
│   ├── prod-us-east-1/          # Prod US-East-1
│   └── prod-us-west-2/          # Prod US-West-2
├── visualization/               # Web dashboard
│   ├── app.py                   # Flask backend
│   └── templates/               # HTML templates
├── scripts/                     # Automation scripts
│   ├── create-clusters.sh       # Create EKS clusters
│   ├── install-argo.sh          # Install Argo stack
│   ├── setup-argocd-apps.sh     # Setup ArgoCD apps
│   ├── deploy-demo-app.sh       # Build and push demo app
│   ├── monitor.sh               # Monitoring dashboard
│   └── watch-workflow.sh        # Watch workflow execution
├── demo-app/                    # Sample Flask application
│   ├── app.py                   # Flask app code
│   └── Dockerfile               # Container image
└── docs/                        # Additional documentation
    ├── TROUBLESHOOTING.md       # Common issues
    ├── STEP-9-PROGRESSIVE-DELIVERY.md
    └── STEP-10-MONITORING.md

Quick Commands

Setup (one-time)

# Install everything
./scripts/create-clusters.sh      # ~20 minutes
./scripts/install-argo.sh          # ~5 minutes
./scripts/deploy-demo-app.sh v1.0.0  # ~2 minutes
./scripts/setup-argocd-apps.sh     # ~2 minutes

Daily Use

# Start port forwards (3 terminals)
kubectl port-forward svc/argo-server -n argo 2746:2746 --context dev
kubectl port-forward svc/argocd-server -n argocd 8080:443 --context dev
cd visualization && python3.12 app.py

# Monitor system
./scripts/monitor.sh

# Run workflow
source venv/bin/activate
python3.12 hera-workflows/working_pipeline.py

Get ArgoCD Access

# Get ArgoCD admin password
kubectl get secret argocd-initial-admin-secret -n argocd -o jsonpath="{.data.password}" | base64 -d && echo

# Login to ArgoCD (optional - for CLI access)
argocd login localhost:8080 --username admin --password <password-from-above> --insecure

# Get ArgoCD token (if needed for API access)
argocd account generate-token --account admin

Cleanup

# Delete clusters
eksctl delete cluster --name dev --region us-east-1
eksctl delete cluster --name stage --region us-east-1
eksctl delete cluster --name prod-us-east-1 --region us-east-1
eksctl delete cluster --name prod-us-west-2 --region us-west-2

# Delete ECR repository
aws ecr delete-repository --repository-name argocon-demo --region us-east-1 --force

Cost Estimate

Running costs:

4 EKS clusters: ~$0.40/hour
8 EC2 t3.medium nodes: ~$0.67/hour
LoadBalancers: ~$0.10/hour
Total: ~$1.17/hour or ~$28/day

Cost savings tips:

Delete clusters when not in use
Use t3.small nodes instead of t3.medium
Run in single region (2 clusters instead of 4)

Troubleshooting

See docs/TROUBLESHOOTING.md for common issues.

Quick fixes:

# Workflow controller issues
kubectl logs -n argo deployment/workflow-controller --tail=50 --context dev

# ArgoCD sync issues
argocd app sync argocd/app-dev --force

# Port forward issues
pkill -f "port-forward"

Resources

Hera Documentation: https://hera.readthedocs.io
Argo Workflows: https://argoproj.github.io/workflows
Argo Rollouts: https://argoproj.github.io/rollouts
Argo CD: https://argo-cd.readthedocs.io
Argo Community Slack: https://argoproj.github.io/community/join-slack

Contributing

This is a demo project for KubeCon EU 2026. Feel free to:

Fork and customize for your use case
Submit issues for bugs or improvements
Share your progressive delivery stories

License

MIT License - See LICENSE file for details

Ready to get started? Head to INSTALL.md for complete setup instructions!

Preparing for demo? Check out DEMO.md for the presentation guide!

Navigation Menu

Repository files navigation

Cross-Cluster Progressive Delivery with Argo + Hera

📚 Documentation

Architecture

🚀 Getting Started

For First-Time Setup

For Demo Presentation

⚙️ Configuration

Environment Variable Overrides

Example Usage

Prerequisites

Key Features

What's Included

Infrastructure

Workflows

Monitoring

Demo Application

Repository Structure

Quick Commands

Setup (one-time)

Daily Use

Get ArgoCD Access

Cleanup

Cost Estimate

Troubleshooting

Resources

Contributing

License

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 60 Commits
.kiro		.kiro
demo-app		demo-app
docs		docs
environments		environments
hera-workflows		hera-workflows
infrastructure		infrastructure
scripts		scripts
visualization		visualization
workflow_creator		workflow_creator
.gitignore		.gitignore
DEMO.md		DEMO.md
INSTALL.md		INSTALL.md
PROJECT-SUMMARY.md		PROJECT-SUMMARY.md
README.md		README.md
requirements.txt		requirements.txt

Folders and files

Latest commit

History

Repository files navigation

Cross-Cluster Progressive Delivery with Argo + Hera

📚 Documentation

Architecture

🚀 Getting Started

For First-Time Setup

For Demo Presentation

⚙️ Configuration

Environment Variable Overrides

Example Usage

Prerequisites

Key Features

What's Included

Infrastructure

Workflows

Monitoring

Demo Application

Repository Structure

Quick Commands

Setup (one-time)

Daily Use

Get ArgoCD Access

Cleanup

Cost Estimate

Troubleshooting

Resources

Contributing

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages