smol_k8s_lab 0.10.6

bootstrap simple projects on kubernetes with kind and k3s

☁️ smol k8s lab 🧸

A project aimed at getting up and running quickly with slimmer k8s distros locally in one small command line tool, as well as benchmarking various k8s distros.

Getting Started

Installation

If you've already got Python3.11 and brew installed, you should be able to:

# install the CLI
pip3.11 install smol-k8s-lab

# Check the help menu before proceeding
smol-k8s-lab --help

Configuration

We've got a Quickstart guide for you to jump right in!

There's also full tutorials to manually set up different distros in the docs we maintain as well as BASH scripts for basic automation of each k8s distro in:

./bash_scripts/{NAME_OF_K8S_DISTRO}/bash_full_quickstart.sh

Under the hood

Supported k8s distributions

We always install the latest version of kubernetes that is available from the distro's startup script.

Distro	Description
k0s	Simple, Solid & Certified Kubernetes Distribution
k3s	The certified Kubernetes distribution built for IoT & Edge computing
KinD	kind is a tool for running local Kubernetes clusters using Docker container “nodes”. kind was primarily designed for testing Kubernetes itself, but may be used for local development or CI.

We tend to test first on k3s first, then the other distros.

Stack We Install on K8s

Version is the helm chart version, or manifest version.

Application	Version	Description
🐄 Local Path Provisioner	k3s latest	Default simple local file storage for persistent data
metallb	0.13.7	loadbalancer for metal, since we're mostly selfhosting
nginx-ingress	4.4.0	The ingress controller allows access to the cluster remotely, needed for web traffic
cert-manager	1.10.1	For SSL/TLS certificates
k9s	latest	Terminal based dashboard for kubernetes

Optionally installed

Application/Tool	Version	Description
ESO	0.6.1	external-secrets-operator integrates external secret management systems like GitLab
Argo CD	5.16.2	Gitops - Continuous Deployment
Kyverno	latest	Kubernetes native policy management to enforce policies on k8s resources

Tooling Used for the CLI itself and interface

smol-k8s-lab is written in Python and built and published using Poetry. You can check out the pyproject.toml for the versions of each library we install below:

• rich (this is what makes all the pretty formatted text)
• PyYAML (to handle the k8s yamls and configs)
• bcrypt (to pass a password to argocd and automatically update your Bitwarden)
• click (handles arguments for the CLI)

We also utilize the Bitwarden cli, for a password manager so you never have to see/know your argocd password.

Troubleshooting

If you're stuck, checkout the Notes to see if we also got stuck on the same thing at some point :) Under each app or tool, we'll have notes on how to learn more about it, as well as any errors we've already battled.

Other Notes

Check out the optional directory for quick examples on apps this script does not default install.

e.g. for postgres, go to ./optional/postgres

Status

This is still in later alpha, as we figure out all the distros we want to support, and pin all the versions, but if you'd like to contribute or just found a :bug:, feel free to open an issue (or pull request), and we'll take a look! We'll try to get back to you asap!

Contributors

JesseBot

Max!

And more!

Want to get started with argocd? If you've installed it via smol-k8s-lab, then you can jump here. Otherwise, if you want to start from scratch, start here