pflaeging-net-public/gubernat
4
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity
No description
197 commits 5 branches 13 tags 628 KiB
  • Shell 49.6%
  • Jinja 33.1%
  • Python 17.3%
Find a file
Exact
Peter Pfläging f47529f0c0 replace deprecated ansible_ with ansible_facts
2026-04-16 12:29:26 +02:00
cluster-template replace deprecated ansible_ with ansible_facts 2026-04-16 12:29:26 +02:00
components replace deprecated ansible_ with ansible_facts 2026-04-16 12:29:26 +02:00
doc - add helm_version (3.20.0) 2026-02-12 12:27:00 +01:00
playbooks make cilium upgrade actually use latest stable version 2026-01-17 13:20:16 +01:00
pve-auto New pathes in pv-auto for submodule usage of gubernat repo 2025-05-11 15:05:39 +02:00
roles replace deprecated ansible_ with ansible_facts 2026-04-16 12:29:26 +02:00
tools improve and automate generation of repo mirror imagelist 2025-08-03 17:33:01 +02:00
.gitignore enable headlamp instead of deprecated kubernetes-dashboard 2026-02-23 09:13:01 +01:00
imagelist.csv enable headlamp instead of deprecated kubernetes-dashboard 2026-02-23 09:13:01 +01:00
LICENSE Add LICENSE 2019-11-06 08:24:12 +00:00
MIGRATION.md add guide for enabling proxy-protocol 2026-04-07 11:10:46 +02:00
README.md smal changes in Readme.md 2026-02-26 10:40:13 +01:00
vm-env.sh switch to full-ansible as wide as possible 2025-02-12 09:20:39 +01:00

README.md

gubernat 🧭 - an opinionated kubernetes distribution / appliance toolkit

'gubernat' means 'steer' (latin)

New Version 2.0 with kubernetes v1.35 and headlamp as dashboard

About

Gubernat is an approach to establish a production ready kubernetes cluster with minimal effort.

The main goal of gubernat is to create a one or multi-node kubernetes cluster which is:

  • highly customizable
  • easy to understand
  • as near as possible to the upstream k8s
  • using stable components, preferably from CNCF projects

It can run on a single server, a small 3 node cluster and also a larger 100 node cluster.

gubernat provides a simple installation procedure for kubernetes (1.28+) with cilium as the networking layer, helm, as well as a a configurable set of ready-to-go components, including the kubernetes dashboard, cert-manager, the contour ingress and more.

Components

  • Base OS: AlmaLinux / RockyLinux / RHEL / CentOS 9 or 10 (minimal installation)
  • Kubernetes 1.35
  • Container Runtime: cri-o 1.35
  • k8s contour-ingress with cert-manager
  • HAProxy for API and dashboard as well as ingress load balancing
  • Helm 3
  • Local storage provisioning via local-path provisioner (under /data/k8s/ and /data/k8s-shared for shared storage)
  • Network layer: Cilium CNI
  • Kubernetes API services (on port 7443 per default)
  • Headlam as kubernetes dashboard (on port 8443 per default)

Documentation

For detailed instructions on how to setup a cluster with gubernat, as well as how to configure and use the installed components, see the documentation.

(c) peter pfläging peter@pflaeging.net