Skip to content

Latest commit

 

History

History
65 lines (44 loc) · 1.88 KB

README.md

File metadata and controls

65 lines (44 loc) · 1.88 KB

K1s

Disclaimer

This is a work in progress and may not be ready for production use. Use with caution and at your own risk.

Description

This project aims to set up and manage a k0s Kubernetes cluster on fedora CoreOS with batteries included.

This includes the following:

  • A k0s cluster
  • Cilium as the CNI
  • OLM for managing operators
  • Nginx Ingress Controller

Coming soon (hopefully):

  • Some storage solution
  • Some monitoring solution(probably prometheus stack)
  • Some logging solution(probably Loki)
  • Cilium Load Balancer and possibly ingress
  • proper node update handling(once coreos has a proper mechanism to update from container images)
  • proper node reboot handling(once kured supports coreos)

Prerequisites

  • Terraform
  • Helm binary

Installation

for installation of prerequisites, please refer to the official documentation of the respective projects.

Usage

Nodes:

  • Prepare nodes with Fedora CoreOS and
  • rebase them onto the os image $ rpm-ostree rebase ostree-unverified-registry:quay.io/k1s-os/os:latest (note: updates aren't automatic yet, so you will have to do this manually for now)

Terraform:

  • Refer to main.tf in the example folder.
  • Edit main.tf to suit your needs(mainly cluster details and node configs)
  • Run terraform get to download the module
  • Run terraform init to initialize terraform
  • Run terraform plan to see what will be created
  • Run terraform apply to create the cluster
  • Run terraform output -raw kubeconfig >> kubeconfig.yaml to get the kubeconfig

Contributing

I will welcome contributions once it is in somewhat stable state!

License

Mozilla Public License Version 2.0 for more information, please refer to the LICENSE file.

Contact

Michael Kaplan - [email protected]

Acknowledgements

k0s project GitHub website