Install Kaptain on an on-premises cluster

Install Kaptain on an on-premises cluster

On-Premise Installation

Kaptain natively supports the installation on an on-premise cluster. Before installing Kaptain, please follow the Konvoy On-Premises Installation Guide or Kommander Installation Guide in a networked environment to set up the on-prem cluster. The cluster admin is responsible for configuring the cluster correctly and ensuring the requisite cluster-level applications are enabled.

Please note that the IP address of the Kaptain UI will come from the IP address range that is configured in the MetalLB load balancer.

Konvoy 1.x

The steps to install Kaptain on an on-premises cluster are as follows:

  • Follow the Konvoy On-Premises Installation Guide to configure the cluster.yaml. An example is shown below.

  • Ensure the following base addons that are needed by Kaptain are enabled:

    - configRepository: https://github.com/mesosphere/kubernetes-base-addons
      configVersion: stable-1.20-4.3.0
      addonsList:
        - name: istio
          enabled: true
        - name: dex
          enabled: true
        - name: cert-manager
          enabled: true
        - name: prometheus
          enabled: true
    
  • Ensure the Knative and NFS addons that are needed by Kaptain are enabled:

    - configRepository: https://github.com/mesosphere/kubeaddons-kaptain
      configVersion: stable-1.20-1.4.0
      addonsList:
        - name: knative
          enabled: true
    
  • Spin up the Konvoy cluster:

    konvoy up
    

DKP 2

For DKP 2.x, ensure the following applications are enabled in Kommander:

  apiVersion: config.kommander.mesosphere.io/v1alpha1
  kind: Installation
  apps:
    ...
    dex:
    dex-k8s-authenticator:
    kube-prometheus-stack:
    istio:
    knative:
    minio-operator:
    traefik:
    nvidia:  # to enable GPU support
    ...   

Install Kaptain

When the Konvoy cluster is ready, install Kaptain.