Enterprise Feature

Configure an Enterprise catalog for DKP

DKP supports configuring default catalogs for clusters with Enterprise license.

Configure a default Enterprise catalog

To configure DKP 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
CODE

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

dkp install kommander --installer-config <config_file.yaml
CODE
  • To ensure DKP is installed on the workload cluster, use the --kubeconfig=cluster_name.conf flag as an alternative to KUBECONFIG.

  • 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 DKP 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:

  2. wget "https://downloads.d2iq.com/dkp/v2.3.0/dkp-catalog-applications-v2.3.0.tar.gz"
    CODE
  3. Update the 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
    CODE
  4. Use this configuration when installing or reconfiguring DKP by passing it to the dkp install kommander command:

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

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 DKP version.

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. The complete source code for the versions of MinIO packaged with DKP/Kommander/Konvoy 2.3.0 are available at these URLs:
https://github.com/minio/minio/tree/RELEASE.2022-01-08T03-11-54Z
https://github.com/minio/minio/tree/RELEASE.2021-02-14T04-01-33Z