sighupio / fury-kubernetes-on-premises

Kubernetes Fury Distribution On-Premises Core Module: Create on-prem Kubernetes Clusters
BSD 3-Clause "New" or "Revised" License
7 stars 4 forks source link

Kubernetes Fury on-premises

Release License Slack

Kubernetes Fury on-premises is an installer and add-on module for the Kubernetes Fury Distribution (KFD) that provides packages to install Kubernetes to on-premises VMs.

If you are new to KFD please refer to the official documentation on how to get started with KFD.

Overview

Kubernetes Fury on-premises uses a collection of open source tools to install Kubernetes in an on-premises environment.

Packages

The following packages are included in the Fury Kubernetes on-premises module:

Package Version Description
etcd 3.5.15 Ansible role to install etcd as systemd service
haproxy 3.0 Ansible role to install HAProxy as Kubernetes load balancer for the APIServer
containerd 1.7.23 Ansible role to install containerd as container runtime
kube-node-common - Ansible role to install prerequisites for Kubernetes setup
kube-control-plane - Ansible role to install master nodes
kube-worker - Ansible role to install worker nodes and join them to the cluster

Click on each package to see its full documentation.

Compatibility

This version is compatible with Kubernetes 1.30.6 plus the complete list in the compatibility matrix.

Check the compatibility matrix for additional information about previous releases of the module.

Usage

Prerequisites

Tool Version Description
furyctl >=0.27.0 The recommended tool to download and manage KFD modules and their packages. To learn more about furyctl read the official documentation.

Legacy provisioning

Clusters are now being totally managed by furyctl with the OnPremises provider, the following example is for a manual install. Check the getting-started repository to know more.

  1. List the role in a Furyfile.yml file
roles:
  - name: on-premises
    version: v1.30.6

See furyctl documentation for additional details about Furyfile.yml format.

  1. Execute furyctl legacy vendor -H to download the roles

  2. Inspect the downloaded roles inside ./vendor/roles/on-premise

  3. Install Kubernetes cluster using the downloaded roles. You can use our playbook examples

Reporting Issues

In case you experience any problems with the module, please open a new issue.

License

This module is open-source and it's released under the following LICENSE.