Kubernetes Fury on-premises

Kubernetes Fury on-premises is an installer and add-on module for the Kubernetes Fury Distribution (KFD) that provides packages to install Kubernetes to a set of existing 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 a set of existing VM (usually, 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 control-plane 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.31.4 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.31.0	The recommended tool to download and manage KFD modules and their packages. To learn more about furyctl read the official documentation.

Legacy provisioning

Tip

Clusters are now being totally managed by furyctl with the OnPremises provider, the following example is for a manual install.

Check the getting-started documentation to know more on how to create a cluster with furyctl.

1. List the role in a Furyfile.yml file

roles:
  - name: on-premises
    version: v1.31.4

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 example playbooks

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.