Skip to main content

​
Welcome to Microservices Infrastructure

A production-ready Kubernetes infrastructure stack designed for local development and testing of microservices applications. Built with modern cloud-native technologies and optimized for developer experience.

​
What is it?

Microservices Infrastructure provides a complete Kubernetes platform running locally on Kind (Kubernetes in Docker), featuring:

Multiple Bootstrap Modes

Dev-fast (~120s), Cilium (~200s), or Full stack (~250s) with warm cluster support

Service Mesh

Istio ambient mode for advanced traffic management and security

Complete Observability

Prometheus, Grafana, Loki, Tempo, and OpenTelemetry Collector

GitOps Ready

ArgoCD with ApplicationSet pattern for declarative deployments

​
Key Features

  • Optimized Bootstrap — Three bootstrap modes with intelligent caching and warm cluster support
  • Advanced Networking — Cilium CNI with Hubble UI for network visibility and eBPF-based security
  • Service Mesh — Istio ambient mode for zero-config service-to-service encryption
  • Full Observability — Metrics, logs, and traces with Prometheus, Grafana, Loki, and Tempo
  • GitOps — ArgoCD for declarative application deployment and synchronization
  • Ingress — Traefik with middleware for CORS, authentication, and rate limiting
  • Object Storage — Garage S3-compatible storage for log and trace backends
  • Manifest Generation — Nixidy (Nix + Kustomize) for type-safe Kubernetes manifests
  • Cross-Platform — Works on macOS (Intel/ARM), Linux (x86_64/aarch64), and WSL2

​
Architecture Stack

LayerComponent
KubernetesKind (local development)
CNICilium + Hubble UI
Service MeshIstio (ambient mode)
GitOpsArgoCD + ApplicationSet
IngressTraefik (CORS / auth / rate-limit middleware)
MonitoringPrometheus, Grafana, Loki, Tempo, OTel Collector
Object StorageGarage (Loki/Tempo backend)
DatabasePostgreSQL
Manifest Generationnixidy (Nix + Kustomize)

​
Quick Start

Get up and running in under 2 minutes:
1

Install Prerequisites

Ensure you have Nix (with flakes), direnv, and Docker installed.
2

Clone and Enter

git clone https://github.com/hackz-megalo-cup/microservices-infra.git
cd microservices-infra
direnv allow
3

Bootstrap the Cluster

bootstrap
The dev-fast mode creates a single-node cluster in ~120s (cold start) or instantly (warm start).
On the second run, the bootstrap command detects unchanged configurations and completes instantly via hash-based caching.

​
Next Steps

Prerequisites

System requirements and tool installation

Quickstart Guide

Detailed setup walkthrough

Bootstrap Modes

Choose the right bootstrap mode

Architecture Overview

Understand the platform architecture
This repository provides the infrastructure foundation. For the application layer: Use tilt up or docker compose up in the app repository to deploy services onto this infrastructure.

Build docs developers (and LLMs) love

Get started for freeTalk to us