Install

Install a DKP cluster

When installing DKP for a project, line-of-business, or enterprise, the first step is to determine the infrastructure on which you want to deploy.

For example, you can:

  • Install on a public cloud infrastructure, such as Amazon Web Services (AWS) or Azure.
  • Install on an internal network on-premises with a physical (bare metal) or virtual infrastructure.
  • Install on air-gapped Edge.

IMPORTANT: The infrastructure you select then determines the specific requirements for a successful installation.

DKP is a tool for provisioning Kubernetes clusters with a suite of pre-selected [Cloud Native Computing Foundation CNCF and community-contributed tools. By combining a native Kubernetes cluster as its foundation with a default set of cluster extensions, DKP provides a complete out-of-the-box solution for organizations that want to deploy production-ready Kubernetes.

As an example, this Installation guide provides simplified instructions to get your DKP cluster up and running with minimal configuration requirements on an Amazon Web Services (AWS) public cloud instance. For information about installing on a different platform, see Choose Infrastructure.

Before you begin

Before installing DKP, ensure you have the following.

Installing DKP

  1. 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 the aws command-line utility by running the following command:

    brew install kubernetes-cli awscli

  2. 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:

    kubectl version --short=true

  3. To download DKP, see the Download Konvoy topic for information. You will need to download and extract the DKP binary package tarball.

  4. Verify you have valid cloud provider security credentials to deploy the cluster on that platform. This step 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.

  5. Deploy with all of the default settings depending on which infrastructure you have. Go to the Choose Infrastructure section of the documentation for further steps on creating a cluster on your Cloud platform. Choose Infrastructure

  6. Lastly, you will want to Install Kommander

Next steps

Now that you have a basic Konvoy 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: