Flux GitOps Stack

Key Features

• Pull-based GitOps reconciliation with Flux controllers monitoring Git repository changes
• Multi-tenancy support with Flux namespace isolation and RBAC integration
• Helm and Kustomize native support for complex application deployment patterns
• Kind cluster with containerd runtime optimized for local Kubernetes development
• Weave GitOps dashboard for visualizing application deployments and Git synchronization status
• Built-in container registry for storing custom images without external dependencies
• Flux image automation for updating container tags based on registry scanning
• Git webhook support for immediate synchronization triggers beyond polling intervals

Common Use Cases

• 1Local GitOps development environment for testing Flux configurations before production deployment
• 2CI/CD pipeline integration for validating GitOps workflows in ephemeral test clusters
• 3Multi-environment application promotion workflows using Git branching strategies
• 4Kubernetes manifest validation and drift detection in containerized development setups
• 5Training and education platform for teams learning GitOps principles and Flux operations
• 6Proof-of-concept deployments demonstrating GitOps benefits to stakeholders and management
• 7Custom controller development and testing in isolated Kubernetes environments

Prerequisites

• Docker Engine 20.10+ with privileged container support for Kind cluster operation
• Git repository with Kubernetes manifests and Flux configuration files
• Minimum 4GB RAM and 2 CPU cores for stable Kind cluster with Flux controllers
• Network access to GitHub/GitLab for Flux source controller Git repository synchronization
• Basic Kubernetes knowledge including pods, services, and namespace concepts
• Understanding of YAML syntax and Kubernetes manifest structure for GitOps workflows

docker-compose.yml

1services: 
2  kind: 
3    image: kindest/node:v1.28.0
4    container_name: flux-cluster
5    privileged: true
6    ports: 
7      - "${API_PORT:-6443}:6443"
8    volumes: 
9      - kind_data:/var/lib/containerd
10
11  registry: 
12    image: registry:2
13    container_name: flux-registry
14    restart: unless-stopped
15    ports: 
16      - "${REGISTRY_PORT:-5000}:5000"
17    volumes: 
18      - registry_data:/var/lib/registry
19
20  weave-gitops: 
21    image: ghcr.io/weaveworks/wego-app:latest
22    container_name: weave-gitops
23    restart: unless-stopped
24    ports: 
25      - "${GITOPS_PORT:-9001}:9001"
26
27volumes: 
28  kind_data: 
29  registry_data: 

.env Template

1# Flux GitOps
2API_PORT=6443
3REGISTRY_PORT=5000
4GITOPS_PORT=9001
5GITHUB_TOKEN=your_github_token

Usage Notes

Individual Services(3 services)

Copy individual services to mix and match with your existing compose files.

kind:
  image: kindest/node:v1.28.0
  container_name: flux-cluster
  privileged: true
  ports:
    - ${API_PORT:-6443}:6443
  volumes:
    - kind_data:/var/lib/containerd

registry:
  image: registry:2
  container_name: flux-registry
  restart: unless-stopped
  ports:
    - ${REGISTRY_PORT:-5000}:5000
  volumes:
    - registry_data:/var/lib/registry

weave-gitops:
  image: ghcr.io/weaveworks/wego-app:latest
  container_name: weave-gitops
  restart: unless-stopped
  ports:
    - ${GITOPS_PORT:-9001}:9001

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  kind:
5    image: kindest/node:v1.28.0
6    container_name: flux-cluster
7    privileged: true
8    ports:
9      - "${API_PORT:-6443}:6443"
10    volumes:
11      - kind_data:/var/lib/containerd
12
13  registry:
14    image: registry:2
15    container_name: flux-registry
16    restart: unless-stopped
17    ports:
18      - "${REGISTRY_PORT:-5000}:5000"
19    volumes:
20      - registry_data:/var/lib/registry
21
22  weave-gitops:
23    image: ghcr.io/weaveworks/wego-app:latest
24    container_name: weave-gitops
25    restart: unless-stopped
26    ports:
27      - "${GITOPS_PORT:-9001}:9001"
28
29volumes:
30  kind_data:
31  registry_data:
32EOF
33
34# 2. Create the .env file
35cat > .env << 'EOF'
36# Flux GitOps
37API_PORT=6443
38REGISTRY_PORT=5000
39GITOPS_PORT=9001
40GITHUB_TOKEN=your_github_token
41EOF
42
43# 3. Start the services
44docker compose up -d
45
46# 4. View logs
47docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/flux-gitops-stack/run | bash

Troubleshooting