Non-air-gapped environment: Prepare the Kommander Installer Configuration File
You MUST modify the Kommander installer configuration file (<kommander.yaml>
) before installing the Kommander component of DKP in a pre-provisioned environment.
Prepare the installer file and install Kommander:
Edit the installer file to include configuration overrides for the
rook-ceph-cluster
. DKP default configuration ships ceph with PVC based storage which requires your CSI provider to support PVC with typevolumeMode: Block
. As this is not possible with the default local static provisioner, you can install ceph in host storage mode.
You can choose whether Ceph’s object storage daemon (osd) pods should consume all or just some of the devices on your nodes. Include one of the following Overrides:To automatically assign all raw storage devices on all nodes to the Ceph cluster:
CODErook-ceph-cluster: enabled: true values: | cephClusterSpec: storage: storageClassDeviceSets: [] useAllDevices: true useAllNodes: true deviceFilter: "<<value>>"
To assign specific storage devices on all nodes to the Ceph cluster:
CODErook-ceph-cluster: enabled: true values: | cephClusterSpec: storage: storageClassDeviceSets: [] useAllNodes: true useAllDevices: false deviceFilter: "^sdb."
Note: If you want to assign specific devices to specific nodes using the
deviceFilter
option, refer to Specific Nodes and Devices. For general information on thedeviceFilter
value, refer to Storage Selection Settings.
Optional: You can add other configuration overrides to your Kommander installer configuration file, for example:
If you are using GPU nodes, append the values required for the usage of a GPU Toolkit.
If you want to customize your cluster’s domain or certificate, review Custom Domains and Certificates during the Kommander installation.
If you require an Enterprise catalog, review Configure an Enterprise Catalog.
If you require an HTTPS proxy, review Configure HTTP Proxy.
Other configurations available at: Kommander Additional Install Configurations
Run the following command by replacing the placeholder
<kommander.yaml>
with the name of your Kommander installer configuration file:CODEdkp install kommander --installer-config <kommander.yaml> --kubeconfig=${CLUSTER_NAME}.conf
If your environment uses HTTP/HTTPS proxies, you must include the flags
--http-proxy
,--https-proxy
, and--no-proxy
and their related values in this command for it to be successful. More information is available in Configuring an HTTP/HTTPS Proxy.
In the previous command, the--kubeconfig=${CLUSTER_NAME}.conf
flag ensures that you set the context to install Kommander on the right cluster. For alternatives and recommendations around setting your context, refer to Provide Context for Commands with a kubeconfig File.TIP: Sometimes, applications require a longer period of time to deploy, which causes the installation to time out. Add the
--wait-timeout <time to wait>
flag and specify a period of time (for example,1h
) to allocate more time to the deployment of applications.