You can configure the Kommander component of DKP during the initial installation, and also post-installation using the DKP CLI.

Review the Management cluster application requirements and Workspace platform application requirements to ensure that your cluster has sufficient resources.

Initialize a Configuration File

To begin configuring Kommander, run the following command to initialize a default configuration file:

dkp install kommander --init > kommander.yaml
CODE

Configure Applications

After you have a default configuration file, you can then configure each app either inline or by referencing another YAML file. The configuration values for each app correspond to the Helm Chart values for the application.

After the initial deployment of Kommander, you can find the application Helm Charts by checking the spec.chart.spec.sourceRef field of the associated HelmRelease:

kubectl get helmreleases <application> -o yaml -n kommander
CODE

Inline configuration (using values)

In this example, you configure the centralized-grafana application with resource limits by defining the Helm Chart values in the Kommander configuration file.

apiVersion: config.kommander.mesosphere.io/v1alpha1
kind: Installation
apps:
  centralized-grafana:
    values: |
      grafana:
        resources:
          limits:
            cpu: 150m
            memory: 100Mi
          requests:
            cpu: 100m
            memory: 50Mi
...
CODE

Reference another YAML file (using valuesFrom)

Alternatively, you could create another YAML file containing the configuration for centralized-grafana and reference that using valuesFrom. Point to this file by using either a relative path (from the configuration file location) or by using an absolute path.

cat > centralized-grafana.yaml <<EOF
grafana:
  resources:
    limits:
      cpu: 150m
      memory: 100Mi
    requests:
      cpu: 100m
      memory: 50Mi
EOF
CODE
apiVersion: config.kommander.mesosphere.io/v1alpha1
kind: Installation
apps:
  centralized-grafana:
    valuesFrom: centralized-grafana.yaml
...
CODE

Minimal Kommander Installation

You can install Kommander with a bare minimum of applications on a small environment with smaller memory, storage, and CPU requirements for testing and demo purposes. Refer to the Install DKP on a Small Environment documentation for more information.

Install with Configuration File

Add the --installer-config flag to the kommander install command to use a custom configuration file. To reconfigure applications, you can also run this command after the initial installation.

An alternative to using the --kubeconfig=<cluster-config> flag is to initialize the KUBECONFIG environment variable. You can do this by running export KUBECONFIG=<cluster-config>. Setting your KUBECONFIG (either by flag or by environment variable) ensures that Kommander is installed on the workload cluster.

dkp install kommander --installer-config kommander.yaml --kubeconfig=<cluster-kubeconfig>
CODE

Verify Installation

Once the Konvoy cluster is built and Kommander has been installed, you will want to verify your installation of Kommander in that section of documentation.

Then you will be able to log in in to Kommander UI.