EKS Prerequisites and Permissions

Konvoy Prerequisites

Before you begin using Konvoy, you must have:

• An x86_64-based Linux or macOS machine.

• The dkp binary for Linux, or macOS.

• A Container engine/runtime installed is required to install DKP:

  • Version Docker® container engine version 18.09.2 or higher installed for Linux or MacOS - On macOS, Docker runs in a virtual machine which needs configured with at least 8 GB of memory.

  • Version 4.0 of Podman or higher for Linux. Host requirements found here: Host Requirements

• kubectl for interacting with the running cluster.

• A valid AWS account with credentials configured.

• For a local registry whether air-gapped or non-air-gapped environment, download and extract the bundle. Download the Complete DKP Air-gapped Bundle for this release (i.e. dkp-air-gapped-bundle_v2.7.0_linux_amd64.tar.gz) to load registry.

On macOS, Docker runs in a virtual machine. Configure this virtual machine with at least 8GB of memory.

Control Plane Nodes

You should have at least three control plane nodes. Each control plane node should have at least:

• 4 cores

• 16 GiB memory

• Approximately 80 GiB of free space for the volume used for /var/lib/kubelet and /var/lib/containerd.

• Disk usage must be below 85% on the root volume.

DKP on AWS defaults to deploying an m5.xlarge instance with an 80GiB root volume for control plane nodes, which meets the above requirements.

Worker Nodes

You should have at least four worker nodes. The specific number of worker nodes required for your environment can vary depending on the cluster workload and size of the nodes. Each worker node should have at least:

• 8 cores

• 32 GiB memory

• Around 80 GiB of free space for the volume used for /var/lib/kubelet and /var/lib/containerd.

• Disk usage must be below 85% on the root volume.

DKP on AWS defaults to deploying am5.2xlarge instance with an 80GiB root volume for worker nodes, which meets the above requirements.

If you use these instructions to create a cluster on AWS using the DKP default settings without any edits to configuration files or additional flags, your cluster is deployed on an Ubuntu 20.04 operating system image with 3 control plane nodes, and 4 worker nodes which match the requirements above.

AWS Prerequisites

Before you begin using Konvoy with AWS, you must:

• Create an IAM policy configuration.

• Create the Cluster IAM Policies in your AWS account.

• The user you delegate from your role must have a minimum set of permissions, see AWS Minimal Permissions and Role to Create Clusters page for AWS.

• Export the AWS region where you want to deploy the cluster:

  CODE

  export AWS_REGION=us-west-2

• Export the AWS profile with the credentials you want to use to create the Kubernetes cluster:

  CODE

  export AWS_PROFILE=<profile>

   

Related Topics:

AWS Using Konvoy Image Builder

Next Step:

Minimal User Permission for EKS Cluster Creation