Skip to content

Examples Overview

This page is your index to the three progressive tutorials included with Gubernator. Each example builds upon the previous, teaching you Gubernator concepts step by step.

Learning Path

┌────────────────────┐     ┌────────────────────┐     ┌────────────────────┐
│   Example 101      │ ──► │   The Empire        │ ──► │    SRE-01          │
│   Single Node      │     │   Cluster + Ingress │     │   Full SRE Stack   │
│   Basic stacks     │     │   CoreDNS + Caddy   │     │   Prometheus/Grafana│
│   10 min           │     │   30 min            │     │   60 min           │
└────────────────────┘     └────────────────────┘     └────────────────────┘
  Beginner                   Intermediate                Advanced / DevOps

Example 101 — Getting Started

Target: Beginner
Goal: Learn the basic Gubernator workflow on a single machine

Start Example 101 →

  • Deploy 3 stacks: NGINX, Redis, Whoami API
  • Learn gbnt stack deploy, gbnt task ls, gbnt stack rm
  • Verify containers with docker ps | grep gbnt

The Empire — Cluster + Ingress

Target: Intermediate
Goal: Run the full "Trifecta" — Gubernator + CoreDNS + Caddy

Start The Empire →

  • Launch the control plane with docker compose up
  • Deploy apps with automatic DNS resolution and Caddy routing
  • Use the Web UI compose editor to update and redeploy

SRE-01 — Full Observability Stack

Target: Advanced / SRE
Goal: A production-grade control plane managing Prometheus, Grafana, and Loki

Start SRE-01 →

  • Complete SRE tooling orchestrated by Gubernator itself
  • Prometheus scrapes Gubernator metrics
  • Grafana dashboards + Loki log aggregation