Skip to main content
Skip table of contents

Install Kommander in a Pre-provisioned, Air-gapped Environment

Prerequisites

Create and Customize your Kommander Installer Configuration File

  1. Set the environment variable for your cluster:

    CODE
    export CLUSTER_NAME=<your-management-cluster-name>
  2. Copy the kubeconfig file of your Management cluster to your local directory:

    CODE
    dkp get kubeconfig -c ${CLUSTER_NAME} > ${CLUSTER_NAME}.conf
  3. Create a configuration file for the deployment:

    CODE
    dkp install kommander --init --airgapped > kommander.yaml
  4. Edit the kommander.yaml file to include configuration overrides for the rook-ceph-cluster. DKP’s default configuration ships Ceph with PVC based storage which requires your CSI provider to support PVC with type volumeMode: Block. As this is not possible with the default local static provisioner, you can install Ceph in host storage mode.

    You can choose whether Ceph’s object storage daemon (osd) pods should consume all or just some of the devices on your nodes. Include one of the following Overrides:

    1. To automatically assign all raw storage devices on all nodes to the Ceph cluster:

      CODE
      ...
      rook-ceph-cluster:
          enabled: true
          values: |
            cephClusterSpec:
              storage:
                storageClassDeviceSets: []
                useAllDevices: true
                useAllNodes: true
                deviceFilter: "<<value>>"
      ...
    2. To assign specific storage devices on all nodes to the Ceph cluster:

      CODE
      ...
      rook-ceph-cluster:
          enabled: true
          values: |
            cephClusterSpec:
              storage:
                storageClassDeviceSets: []
                useAllNodes: true
                useAllDevices: false
                deviceFilter: "^sdb."
      ...

      (info) Note: If you want to assign specific devices to specific nodes using the deviceFilter option, refer to Specific Nodes and Devices. For general information on the deviceFilter value, refer to Storage Selection Settings.

  5. If required: Customize your kommander.yaml.
    (info) See Kommander Customizations for customization options. Some of them include:
    Custom Domains and Certificates, HTTP proxy, External Load Balancer, GPU utilization, etc.

  6. If required: If your cluster uses a custom AWS VPC and requires an internal load-balancer, set the traefik annotation to create an internal-facing ELB:

    CODE
    ...
    apps:
      traefik:
        enabled: true
        values: |
          service:
            annotations:
              service.beta.kubernetes.io/aws-load-balancer-internal: "true
    ...
  7. Expand one of the following sets of instructions, depending on your license and application environments:

 

Essential License: Install Kommander in a Pre-provisioned, Air-Gapped Environment

Essential License: Install Kommander in an Air-gapped Environment

Use the customized kommander.yaml to install DKP in a pre-provisioned, air-gapped environment:

CODE
dkp install kommander --installer-config kommander.yaml --kubeconfig=${CLUSTER_NAME}.conf \
--kommander-applications-repository ./application-repositories/kommander-applications-v2.7.2.tar.gz \
--charts-bundle ./application-charts/dkp-kommander-charts-bundle-v2.7.2.tar.gz 

  

Enterprise License: Install Kommander in a Pre-provisioned, Air-gapped Environment with DKP Catalog Applications

Enterprise License: Install Kommander in an Air-gapped Environment with DKP Catalog Applications

If you want to enable DKP Catalog applications AFTER installing DKP, see Enable DKP Catalog Applications after Installing DKP.

  1. In the same kommander.yaml of the previous section, add the following values to enable DKP Catalog Applications:

    CODE
    ...
    catalog:
      repositories:
        - name: dkp-catalog-applications
          labels:
            kommander.d2iq.io/project-default-catalog-repository: "true"
            kommander.d2iq.io/workspace-default-catalog-repository: "true"
            kommander.d2iq.io/gitapps-gitrepository-type: "dkp"
          path: ./dkp-catalog-applications-v2.7.2.tar.gz
    ...

    (warning) If you only want to enable catalog applications to an existing configuration, add these values to an existing installer configuration file to maintain your Management cluster’s settings.

  2. Use the customized kommander.yaml to install DKP:

    CODE
    dkp install kommander --installer-config kommander.yaml --kubeconfig=${CLUSTER_NAME}.conf \
    --kommander-applications-repository ./application-repositories/kommander-applications-v2.7.2.tar.gz \
    --charts-bundle ./application-charts/dkp-kommander-charts-bundle-v2.7.2.tar.gz \
    --charts-bundle ./application-charts/dkp-catalog-applications-charts-bundle-v2.7.2.tar.gz

Next Step:

Verify Kommander Installation

See Install DKP Insights if you want to enable a solution that detects current and future anomalies in workload configurations or Kubernetes clusters.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.