On Premises

Configure a cluster for On Premises operation

To create a cluster on your on premises infrastructure, follow the procedure that describes creating a Konvoy cluster on a pre-provisioned infrastructure using SSH access.

Cluster API (CAPI) has a concept of an Infrastructure Providers, a set of controllers tasked with managing provider-specific resources for cluster infrastructure and machines via an API. In an on premises environments, there may not be a programmatic API to create and delete infrastructure, or other teams or departments may be responsible for pre-provisioning this infrastructure. In these cases, Konvoy uses its own pre-provisioned infrastructure provider that relies on having SSH access to the machines and executes the bootstrap steps through SSH.

To use the pre-provisioned infrastructure provider, use Konvoy Image Builder to ensure that the correct versions of kubeadm, kubelet, and containerd are installed with their relevant configurations to enable Konvoy to run on your infrastructure. Then use the dkp CLI to create a Konvoy cluster on your infrastructure.

Completing this procedure produces a Kubernetes cluster, including a Container Networking Interface (CNI) and a Local Persistence Volume Static Provisioner, that is ready for workload deployment.

Before moving to a production environment, you may want to add applications for logging and monitoring, storage, security, and other functions. You can use Kommander to select and deploy applications, or deploy your own.

To get started, follow the procedure that describes creating a Konvoy cluster on a pre-provisioned infrastructure.