Gubernator Examples: Hands-On Tutorials

Gubernator features four progressive developer examples designed to walk you from basic container orchestration to advanced AI workloads:

Example 101 — Getting Started (WordPress & MySQL)
Goal: Understand the basics of single-node orchestration.
Stack: A classic multi-container application consisting of a WordPress front-end and a MySQL database backend.
Key Concepts: Persistent Docker named volumes, basic container scheduling, internal CoreDNS resolution (db.wp.gbnt), and initial Caddy Ingress routing.
Example 102 — Load Balancing (Round-Robin Routing)
Goal: Learn how Gubernator handles horizontal scaling and high availability.
Stack: A scaled deployment featuring multiple BusyBox HTTP replicas serving their individual container hostnames.
Key Concepts: Scaling up replicas, automatic target grouping under a single DNS record, and Caddy Ingress configuring native round-robin load balancing across the running replicas under hello.gbnt.local.
Example n8n — AI Automation Stack (RAG & Local LLMs)
Goal: Orchestrate a modern, automated AI agent workflow.
Stack: An automation workspace integrating n8n (workflows), PostgreSQL (backend database), Ollama (local LLM runtime running llama3.2), and Qdrant (vector database for RAG).
Key Concepts: Inter-container communication using CoreDNS, complex service dependencies, transient automated setup tasks (auto-pulling LLM models on startup), and multi-domain Caddy Ingress routing.
Example Jupyter — AI Development Stack (JupyterLab with PyTorch)
Goal: Spin up a fully-equipped machine learning and data science environment.

Stack: A specialized developer workspace running JupyterLab powered by the comprehensive quay.io/jupyter/pytorch-notebook image.
Key Concepts: Managing large Docker image downloads, mounting persistent data scientist workspace volumes, and setting up Ingress reverse proxying for custom/non-standard container ports (port 8888).

https://github.com/mario-ezquerro/gubernator/tree/main/examples https://github.com/mario-ezquerro/gubernator/tree/main/examples