Skip to content

Greenfield Cluster

Greenfield Cluster License

Overview

Greenfield Cluster is a production-ready Kubernetes cluster template designed for greenfield projects and startups. It provides a complete infrastructure stack with observability, security, and scalability built-in from day one.

🚀 Key Features

  • Complete Infrastructure Stack: Redis, PostgreSQL, MySQL, MongoDB, Kafka
  • Full Observability: OpenTelemetry, Jaeger, Prometheus, Grafana
  • Service Mesh: Istio with mTLS and traffic management
  • Security First: Sealed Secrets, RBAC, encryption
  • Cloud Agnostic: Deploy to AWS, GCP, Azure, or any Kubernetes cluster
  • Template Ready: Use as GitHub template for new projects

🎯 Use Cases

This template is perfect for:

  • Startups building microservices from scratch
  • Enterprises standardizing infrastructure
  • Teams wanting production-ready patterns
  • Developers learning Kubernetes best practices

Architecture Overview

graph TB subgraph "External Access" Internet[Internet] end subgraph "Istio Service Mesh" Gateway[Istio Gateway] subgraph "Application Layer" FastAPI[FastAPI App] end end subgraph "Data Layer" Redis[Redis Cluster] PostgreSQL[PostgreSQL] MySQL[MySQL] MongoDB[MongoDB] end subgraph "Messaging Layer" Kafka[Kafka Cluster] Zookeeper[Zookeeper] end subgraph "Observability Stack" OTel[OpenTelemetry
Collector] Jaeger[Jaeger] Prometheus[Prometheus] Grafana[Grafana] end Internet --> Gateway Gateway --> FastAPI FastAPI --> Redis FastAPI --> PostgreSQL FastAPI --> MySQL FastAPI --> MongoDB FastAPI --> Kafka Kafka --> Zookeeper FastAPI --> OTel OTel --> Jaeger OTel --> Prometheus Grafana --> Prometheus Grafana --> Jaeger style Gateway fill:#326CE5 style FastAPI fill:#009688 style OTel fill:#FF6F00 style Jaeger fill:#60D0E4 style Prometheus fill:#E6522C style Grafana fill:#F46800

Quick Start

Get up and running in 5 minutes:

# Clone or create from template
gh repo create my-project --template ianlintner/green_field_cluster

# Deploy everything
kubectl apply -k kustomize/base/

# Or use Helm
helm install greenfield helm/greenfield-cluster

What's Included

Infrastructure Components

Component Replicas Purpose
Redis 1 master + 2 replicas Caching, sessions
PostgreSQL 3 nodes Transactional data
MySQL 3 nodes Alternative RDBMS
MongoDB 3 nodes Document storage
Kafka 3 brokers Event streaming
Zookeeper 3 nodes Kafka coordination

Observability Stack

Component Purpose
OpenTelemetry Collector Telemetry aggregation
Jaeger Distributed tracing
Prometheus Metrics collection
Grafana Visualization

Example Application

A fully instrumented FastAPI application demonstrating:

  • OpenTelemetry tracing
  • Prometheus metrics
  • Database connectivity
  • Kafka integration
  • Health checks

Documentation

Contributing

Contributions are welcome! See our Contributing Guide.

License

MIT License - see LICENSE for details.