Configure an Enterprise catalog
.png?inst-v=05e554dd-7f37-428d-998c-6bc1adf6543b)
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.3.3
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
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 |
---|---|
| Indicates this acts as a Catalog Repository in all projects |
| Indicates this acts as a Catalog Repository in all workspaces |
| 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:
CODEapiVersion: 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:CODEdkp 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.