Configure an Enterprise catalog

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:

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

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

CODE

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

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.

Download the DKP catalog application Git repository archive:

CODE

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

Update the configuration file with:

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

Use this configuration when installing or reconfiguring DKP by passing it to the dkp install kommander command:
CODE
```
dkp install kommander --installer-config <config_file>.yaml
```

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.