Configure an Enterprise catalog

ENTERPRISE

Configure an Enterprise catalog for Kommander

Kommander supports configuring default catalogs for clusters with Enterprise license.

Configure a default Enterprise catalog

To configure Kommander to use a default catalog repository, create the following yaml file:

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"
      gitRepositorySpec:
        url: https://github.com/mesosphere/dkp-catalog-applications
        ref:
          tag: v2.2.1

Use this configuration when installing or reconfiguring Kommander by passing it to the dkp install kommander command:

NOTE: To ensures Kommander is installed on the workload cluster, use the --kubeconfig=cluster_name.conf flag as an alternative to KUBECONFIG.

dkp install kommander --installer-config <config_file.yaml>

NOTE: When configuring the catalog repository post-upgrade, run dkp install kommander --init > install.yaml and update it accordingly with any custom configuration. This ensures you are using the proper default configuration values for the new Kommander version.

The following section describes each label:

Label Description
kommander.d2iq.io/project-default-catalog-repository Indicates this acts as a Catalog Repository in all projects
kommander.d2iq.io/workspace-default-catalog-repository Indicates this acts as a Catalog Repository in all workspaces
kommander.d2iq.io/gitapps-gitrepository-type Indicates this Catalog Repository (and all its Applications) are certified to run on DKP

Air-gapped Catalog Configuration

When running in air-gapped environments, update the configuration by replacing gitRepositorySpec with the path field pointing to a local path of the DKP catalog applications git repository.

  1. Download the DKP catalog application Git repository archive:

    wget "https://downloads.d2iq.com/dkp/v2.2.1/dkp-catalog-applications-v2.2.1.tar.gz" -O dkp-catalog-applications.tar.gz
    

NOTE: This docker image includes code from the MinIO Project (“MinIO”), which is © 2015-2021 MinIO, Inc. MinIO is made available subject to the terms and conditions of the GNU Affero General Public License 3.0. Complete source code for MinIO is available here, here, and here

  1. Update the Kommander configuration file with:

    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.tar.gz
    

    NOTE: When configuring the catalog repository post-upgrade, run dkp install kommander --init > install.yaml and update it accordingly with any custom configuration. This ensures you are using the proper default configuration values for the new Kommander version.

  2. Use this configuration when installing or reconfiguring Kommander by passing it to the dkp install kommander command:

    dkp install kommander --installer-config <config_file.yaml>