Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vitobotta/hetzner-k3s

The easiest and fastest way to create and manage Kubernetes clusters in Hetzner Cloud using the lightweight distribution k3s by Rancher.
https://github.com/vitobotta/hetzner-k3s

crystal crystal-lang crystal-language devops docker hetzner hetzner-api hetzner-cloud k3s k8s kubernetes

Last synced: 6 days ago
JSON representation

The easiest and fastest way to create and manage Kubernetes clusters in Hetzner Cloud using the lightweight distribution k3s by Rancher.

Host: GitHub
URL: https://github.com/vitobotta/hetzner-k3s
Owner: vitobotta
License: mit
Created: 2021-08-07T11:39:12.000Z (over 3 years ago)
Default Branch: main
Last Pushed: 2024-10-26T12:18:36.000Z (3 months ago)
Last Synced: 2024-10-29T14:52:26.882Z (3 months ago)
Topics: crystal, crystal-lang, crystal-language, devops, docker, hetzner, hetzner-api, hetzner-cloud, k3s, k8s, kubernetes
Language: Crystal
Homepage:
Size: 50.2 MB
Stars: 1,856
Watchers: 29
Forks: 140
Open Issues: 27
Metadata Files:
- Readme: README.md
- Contributing: docs/Contributing_and_support.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

awesome-hcloud - vitobotta/hetzner-k3s
awesome-crystal - hetzner-k3s - A CLI tool to quickly create and manage Kubernetes clusters in Hetzner Cloud (CLI Utils)

README

        ![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/vitobotta/hetzner-k3s)

![GitHub Release Date](https://img.shields.io/github/release-date/vitobotta/hetzner-k3s)

![GitHub last commit](https://img.shields.io/github/last-commit/vitobotta/hetzner-k3s)

![GitHub issues](https://img.shields.io/github/issues-raw/vitobotta/hetzner-k3s)

![GitHub pull requests](https://img.shields.io/github/issues-pr-raw/vitobotta/hetzner-k3s)

![GitHub](https://img.shields.io/github/license/vitobotta/hetzner-k3s)

![GitHub Discussions](https://img.shields.io/github/discussions/vitobotta/hetzner-k3s)

![GitHub top language](https://img.shields.io/github/languages/top/vitobotta/hetzner-k3s)

![GitHub forks](https://img.shields.io/github/forks/vitobotta/hetzner-k3s?style=social)

![GitHub Repo stars](https://img.shields.io/github/stars/vitobotta/hetzner-k3s?style=social)

---

# The easiest and fastest way to create production grade Kubernetes clusters in Hetzner Cloud

## What is this?

This is a CLI tool to super quickly and super easily create and manage Kubernetes clusters in [Hetzner Cloud](https://www.hetzner.com/cloud) using the lightweight Kubernetes distribution [k3s](https://k3s.io/) from [Rancher](https://rancher.com/). In a recent test I created a 200 node HA cluster (3 masters, 197 worker nodes) in just **under 4 minutes** (when using only public network since private networks are limited to 100 instances per network). I believe this is a world record :)

Hetzner Cloud is an awesome cloud provider which offers a truly great service with the best performance/cost ratio in the market and locations in both Europe and USA.

k3s is my favorite Kubernetes distribution because it uses much less memory and CPU, leaving more resources to workloads. It is also super quick to deploy and upgrade because it's a single binary.

Using `hetzner-k3s`, creating a highly available k3s cluster with 3 masters for the control plane and 3 worker nodes takes **2-3 minutes** only. This includes

- creating all the infrastructure resources (instances, private network, firewall)

- deploying k3s to the nodes

- installing the [Hetzner Cloud Controller Manager](https://github.com/hetznercloud/hcloud-cloud-controller-manager) to provision load balancers right away

- installing the [Hetzner CSI Driver](https://github.com/hetznercloud/csi-driver) to provision persistent volumes using Hetzner's block storage

- installing the [Rancher System Upgrade Controller](https://github.com/rancher/system-upgrade-controller) to make upgrades to a newer version of k3s easy and quick

- installing the [Cluster Autoscaler](https://github.com/kubernetes/autoscaler) to allow for autoscaling node pools

Also see this [documentation page](https://github.com/vitobotta/hetzner-k3s/blob/main/docs/Setting%20up%20a%20cluster.md) for a tutorial on how to set up a cluster with the most common setup to get you started.

If you like this project and would like to help its development, consider [becoming a sponsor](https://github.com/sponsors/vitobotta).

___

## Who am I?

I'm the Lead Platform Architect for event management platform [Brella](https://www.brella.io/), based in Finland. I am responsible for all the technical aspects of the platform including development, infrastructure and mentoring developers. In my free time I act as a bug bounty hunter to find and responsibly disclose vulnerabilities in web applications.

See my public profile with links for connecting with me [here](https://vitobotta.com/).

---

## Docs

- [Installation](docs/Installation.md)

- [Creating a cluster](docs/Creating_a_cluster.md)

- [Setting up a cluster](docs/Setting%20up%20a%20cluster.md)

- [Recommendations](docs/Recommendations.md)

- [Maintenance](docs/Maintenance.md)

- [Deleting a cluster](docs/Deleting_a_cluster.md)

- [Load balancers](docs/Load_balancers.md)

- [Storage](docs/Storage.md)

- [Troubleshooting](docs/Troubleshooting.md)

- [Contributing and support](docs/Contributing_and_support.md)

___

## Code of conduct

Everyone interacting in the hetzner-k3s project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/vitobotta/hetzner-k3s/blob/main/CODE_OF_CONDUCT.md).

___

## License

This tool is available as open source under the terms of the [MIT License](https://github.com/vitobotta/hetzner-k3s/blob/main/LICENSE.txt).

___

## Stargazers over time

[![Stargazers over time](https://starchart.cc/vitobotta/hetzner-k3s.svg)](https://starchart.cc/vitobotta/hetzner-k3s)