On-Premises Installer

On-Premises Installer is an installer and add-on module for the SIGHUP Distribution (SD) that provides packages to install Kubernetes to a set of existing VMs.

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

Overview

On-Premises Installer 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.16	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.26	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.32.4 plus the complete list in the compatibility matrix.

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

Warning

Support for the ARM platform is still in beta status, the Load Balancers installed with the haproxy role are not currently supported for RHEL and RHEL derivatives running on ARM. Please use a different OS for the Load Balancers VMs (or disable them and create your own load balancer).

Usage

Prerequisites

Tool	Version	Description
furyctl	>=0.32.0	The recommended tool to download and manage SD 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.32.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.