AWS Cluster Creation Customization Choices

Below are a some methods to customize your cluster during creation. If none of these choices apply, skip this page and proceed to either section:

Section Topics

When creating clusters, many options are available such as those listed in this section of the documentation. Familiarize yourself with the flags required to apply these customizations during cluster creation.

AWS Naming Cluster — In AWS it is critical that the name is unique, as no two clusters in the same AWS account can have the same name.

AWS Customizing CAPI Clusters — Familiarize yourself with Cluster API before editing the cluster objects because edits can prevent the cluster from deploying successfully.

AWS Custom AMI — To use a custom AMI when creating your cluster, you must create that AMI using Konvoy Image Builder(KIB) first.

AWS Registry Mirrors — In an air-gapped environment, you need a local repository to store Helm charts, Docker images, and other artifacts. In an environment with access to the Internet, you can retrieve artifacts from specialized repositories dedicated to them, such as Docker images contained in DockerHub and Helm Charts that come from a dedicated Helm Chart repository.

AWS Loading the Registry — Because air-gapped environments do not have direct access to the Internet, you must download, extract and load several required images to your local container registry, before installing DKP. Refer to Registry Mirror Tools for specific information.

AWS Registry Configuration — Configure your cluster to use an existing local registry when attempting to pull images by adding the flag(s) to the dkp create cluster command to pull images from your local registry.

AWS HTTP Proxy — When creating a DKP cluster in environments that use an HTTP/HTTPS proxy, you must provide proxy details. The proxy values are strings that list a set of proxy servers, URLs, or wildcard addresses that is specific to your environment.

AWS Output Directory YAML — You can create individual files with different smaller manifests for ease in editing using the --output-directory flag used with --output=json|yaml. You create the directory of where to output resources to files.

AWS Provision on the Flatcar Linux OS — Flatcar default network interface name might require specifying. It is most likely to be ens192 requiring passing the parameter --virtual-ip-interface ens192 to the dkp create cluster aws command. Otherwise, the cluster creation might fail because kube-vip can not configure the first control-plane virtual IP.

Next Step

After you make decisions about customization choices, proceed to either the non-air-gapped or air-gapped environment instructions: