Skip to main content
Skip table of contents

AWS Air-gapped FIPS: Install Kommander

You have installed the Konvoy component and created a cluster. Now it is time to Install Kommander which will allow you to access the UI and attach new or existing clusters to monitor.

Prerequisites

Create 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. If required, customize your kommander.yaml.
    (info) See Kommander Customizations for customization options. Some of them include:

  5. 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
    ...
  6. Expand one of the following sets of instructions, depending on your license and application environments:

Enable DKP Catalog Applications and Install Kommander in an Air-gapped Environment

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
    apiVersion: config.kommander.mesosphere.io/v1alpha1
    kind: Installation
    ...
    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.8.1.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.8.1.tar.gz \
    --charts-bundle ./application-charts/dkp-kommander-charts-bundle-v2.8.1.tar.gz \
    --charts-bundle ./application-charts/dkp-catalog-applications-charts-bundle-v2.8.1.tar.gz

Tips and recommendations

  • The --kubeconfig=${CLUSTER_NAME}.conf flag ensures that you install Kommander on the correct cluster. For alternatives, see Provide Context for Commands with a kubeconfig File.

  • Applications can take longer to deploy, and time out the installation. Add the --wait-timeout <time to wait> flag and specify a period of time (for example, 1h) to allocate more time to the deployment of applications.

  • If the Kommander installation fails, or you wish to reconfigure applications, rerun the install command to retry.

Next Step:

AWS Air-gapped FIPS: Verify Install and Log in the UI

JavaScript errors detected

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

If this problem persists, please contact our support.