Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spigell/pulumi-hcloud-kube-hetzner
Optimized and Maintenance-free Kubernetes on Hetzner Cloud in one command! With Pulumi!
https://github.com/spigell/pulumi-hcloud-kube-hetzner
Last synced: 2 months ago
JSON representation
Optimized and Maintenance-free Kubernetes on Hetzner Cloud in one command! With Pulumi!
- Host: GitHub
- URL: https://github.com/spigell/pulumi-hcloud-kube-hetzner
- Owner: spigell
- Created: 2023-10-27T18:20:58.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-04-12T13:57:06.000Z (3 months ago)
- Last Synced: 2024-04-12T19:38:21.331Z (3 months ago)
- Language: Go
- Homepage:
- Size: 1.31 MB
- Stars: 10
- Watchers: 1
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Security: docs/security.md
- Roadmap: docs/roadmap.md
Lists
- awesome-pulumi - `spigell/pulumi-hcloud-kube-hetzner` - Deploy and manage Kubernetes (k3s) cluster with Hetzner Cloud. (Tools / Miscellaneous)
README
## Pulumi Hcloud Kube Hetzner
This is a [Pulumi component](https://www.pulumi.com/docs/concepts/resources/components) (only GO and Typescript/JS are supported now) for creating Kubernetes clusters in Hetzner Cloud. It is inspired by [terraform-hcloud-kube-hetzner](https://github.com/kube-hetzner/terraform-hcloud-kube-hetzner). It can be used as a golang library/module as well, tho :)
*Note: This project is in active development, and not everything is completed. However, it DOES work and is usable right now. I definitely appreciate feedback and will help with any issues*
### Goal
The goal of this project is to enable anybody, regardless of their "DevOps tools" expertise, to efficiently deploy and manage Kubernetes clusters on Hetzner's cost-effective cloud infrastructure. Leveraging existing features such as autotests and YAML out-of-box configuration (thanks to Pulumi), along with Hetzner's cheapest cloud offerings, the project aims to minimize operational costs and automate complex deployments. To prioritize security, additional efforts will be made to enhance security measures, ensuring the deployment and running are highly secured.
### Killer Features
- Ability to manage labels and taints directly!
- Adding and removing nodepools/nodes without changing internal IP addresses is possible.
- Most of the examples are tested via Github Actions and maintained.
## Getting Started
### Prerequisites
Please install following tools:
- Pulumi CLI and required runtime for your language
- GNU Make
- packer (only for microos image creation. If you have existing image, you can skip this step)
- curl
You need to have a Hetzner Cloud account. You can sign up for free [here](https://hetzner.com/cloud/).
### Usage
#### TL;DR (Typescript)
```
$ export HCLOUD_TOKEN=
$ mkdir pulumi-hcloud-kube-hetzner
$ cd pulumi-hcloud-kube-hetzner
$ pulumi new -g https://github.com/spigell/pulumi-hcloud-kube-hetzner/tree/main/pulumi-templates/typescript
$ make microos (optionanl)
$ make pulumi-init-stack [PULUMI_EXAMPLE_NAME]
$ yarn install
$ pulumi up -yf
```
## Development
### GO
```
$ make test-go-project [TEMPLATE=go/library|go/component]
$ cd test-component
$ make pulumi-generate-config [PULUMI_CONFIG_SOURCE=../examples/.yaml]
```
For component building:
```
$ cd ./pulumi-component
$ make build && make install_provider # It generates all SDKs and build providers
$ export PATH=$PATH:~/go/bin
```
That's it. Now you can use all pulumi commands like `up` or `pre` with your own version of the project.
After making changes, create a PR to the `preview` branch.
## Roadmap
The roadmap is located in [roadmap.md](./docs/roadmap.md)