Install Overview
Before you begin
Before you create a DKP image and deploy the initial DKP cluster, the operator's machine is required to be either an OSX or Linux based machine of a supported version.
For DKP and Konvoy Image Builder to run, the operator machine requires:
Docker in latest version
CLI tooling of the cloud provider being used to deploy DKP commands:
kubectl in latest version
DKP expects permissions on the cloud provider being used. See Advanced Konvoy Configuration for more information on your provider permissions needed. Also see the Supported Operating Systems page for further setup requirements.
Installation:
Follow the steps below to install the basic DKP package before you can being any custom configuration based on your environment.
Install required packages. In most cases, you can install the required software using your preferred package manager. For example, on a macOS computer, you can use Homebrew to install
kubectl
and theaws
command-line utility by running the following command:CODEbrew install kubernetes-cli awscli
Check the Kubernetes client version. Many important Kubernetes functions do not work if your client is outdated. You can verify that the version of
kubectl
you have installed is supported by running the following command:CODEkubectl version --short=true
To download DKP, see the Download topic for information. You will need to download and extract the DKP binary package tarball.
Verify you have valid cloud provider security credentials to deploy the cluster on that platform.
NOTE: This step regarding provider security credentials is not required if you are installing DKP on an on-premises environment. For information about installing in an on-premises environment, see Install on-premises.
Deploy with all of the default settings depending on which infrastructure you have.
Proceed to the Advanced Konvoy Configuration section of the documentation for further steps on creating a cluster with the Konvoy component of DKP on your infrastructure provider listed in that section.
Now that you have a basic DKP cluster installed through Konvoy, you configure the Kommander component.
Last, continue with install configuration through sections of documentation under the Kommander component of DKP.
Next Step:
Now that you have a basic DKP cluster installed and ready to use, you might want to test operations by deploying a simple, sample application, customizing the cluster configuration, or checking the status of cluster components.
For more details, see the following topics: