Add Kaptain to DKP Catalog Applications in air-gapped environments before deploying to clusters

Ensure that your kubectl configuration references the cluster on which you must execute the commands.

WARNING: Ensure the cluster that you want to use to deploy Kaptain is the only cluster in its workspace. Kaptain is meant to be deployed on workspaces with a single cluster.

Requirements

For reference values of the required number of worker nodes, CPU, RAM, and storage resources, refer to the requirements section.

Prerequisites

Ensure you have reviewed and executed all steps in the prerequisites section.

Air-gapped Installation

Refer to networked install instructions, if you want to deploy Kaptain in a networked environment.

Kaptain supports installation on an air-gapped (a.k.a. offline or private) DKP managed cluster. Before installing Kaptain, please follow the air-gapped installation guide to set up the air-gapped DKP managed cluster. The cluster admin is responsible for configuring the DKP cluster correctly and ensuring container images have been pre-loaded to the private registry before installing Kaptain.

Add Kaptain to your Kommander Install

Add the Kaptain catalog to the Kommander install configuration file along with the DKP applications catalog:

catalog:
---
repositories:
  - name: dkp-catalog-applications
    labels:
      kommander.d2iq.io/gitapps-gitrepository-type: dkp
      kommander.d2iq.io/workspace-default-catalog-repository: "true"
    path: ./dkp-catalog-applications
  - name: kaptain-catalog-applications
    labels:
      kommander.d2iq.io/gitapps-gitrepository-type: dkp
      kommander.d2iq.io/workspace-default-catalog-repository: "true"
    path: ./kaptain-catalog-applications
CODE

If you added Kaptain after installing DKP, you must make it available by rerunning the Kommander installation with the updated configuration file.

Load all necessary artifacts for air-gapped installation

  1. Download the image bundle files from the support portal:

    • Download kaptain-air-gapped-2.2.0.tar that will contain the required artifacts to perform an air-gapped installation.

    • (Optional) Download the custom image artifacts kaptain-air-gapped-2.2.0_cpu.tar or kaptain-air-gapped-2.2.0_gpu.tar based on whether you need CPU or GPU for your workloads.

  2. Extract the image bundle archive and other files within a location where you can load and push the images to your private Docker registry.

  3. Ensure you set the REGISTRY_URL and AIRGAPPED_TAR_FILE variable appropriately, then use the following script to load the air-gapped image bundle and the cpu or gpu bundle:

    dkp push image-bundle --image-bundle ${AIRGAPPED_TAR_FILE} --to-registry ${REGISTRY_URL}
    CODE

    Note: this command is new in DKP 2.2.

    Based on the network latency between the environment of script execution, the Docker registry, and the disk speed, this can take a while to upload all the images to your image registry.

  4. Download the application bundles and chart archive from the support portal.

  5. Extract the application bundle to the location referenced in the Kommander configuration file above.

    mkdir kaptain-catalog-applications
    tar -xvf kaptain-catalog-applications.tar.gz --strip-components 1 -C kaptain-catalog-applications
    CODE
  6. Load the Kaptain chart archive after the Kommander installation:

    dkp push chart kaptain-2.2.0.tgz
    CODE