|Reading time:||5 min|
|Last updated:||5 Oct 2023|
|5 Oct 2023|
This guide is intended to get you up and running with this tool quickly with the most common settings. For a thorough review of all options, refer to the official documentation.
The Amazon EKS CLI,
eksctl, is a command line tool to create and manage Kubernetes clusters in Amazon Kubernetes Service (EKS). It simplifies cluster creation and saves time compared to using the AWS console. For additional information refer to the
EKS CLI official documentation
The EKS CLI is available for a variety of operating systems and Linux distributions and there are multiple ways to install it. It runs on both Arm Linux distributions and Windows on Arm.
This install guide provides a quick solution to install
eksctl on Arm Linux and Windows on Arm.
For Linux, confirm you are using an Arm machine by running:
The output should be:
If you see a different result, you are not using an Arm computer running 64-bit Linux.
For Windows, confirm the Arm architecture by typing “Settings” in the Windows search box.
When the settings appear, click System on the left side and then About at the bottom.
In the Device specifications section look for “ARM-based processor” in the System type area.
Install the Kubernetes command-line tool,
kubectl, using the
Kubectl install guide
curl -sLO "https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_Linux_arm64.tar.gz"
tar -xzf eksctl_Linux_arm64.tar.gz -C /tmp && rm eksctl_Linux_arm64.tar.gz sudo mv /tmp/eksctl /usr/local/bin
The output will be similar to:
Use a browser to download the EKS CLI latest release .
Unzip the downloaded file.
eksctl.exe is installed:
The output will be similar to:
eksctl relies on the AWS CLI being installed and configured. Use the
AWS CLI install guide to install the AWS CLI. The CLI provides the
You will also need to configure the AWS CLI using the
aws configure or the
aws configure sso command. There are multiple ways to configure the CLI, including environment variables, command-line options, and credentials files. Refer to the
Configure the AWS CLI
for more details.
With your AWS account configured, run
eksctl to create a cluster with 2 nodes with AWS Graviton processors:
eksctl create cluster \ --name cluster-1 \ --region us-east-1 \ --node-type t4g.small \ --nodes 2 \ --nodegroup-name node-group-1
Use the AWS console to look at the resources associated with the cluster and monitor progress of cluster creation.
When the cluster is created, use
kubectl to get the status of the nodes in the cluster.
kubectl get nodes -o wide
The output is similar to:
NAME STATUS ROLES AGE VERSION INTERNAL-IP EXTERNAL-IP OS-IMAGE KERNEL-VERSION CONTAINER-RUNTIME ip-192-168-38-144.ec2.internal Ready <none> 2m31s v1.25.13-eks-43840fb 192.168.38.144 22.214.171.124 Amazon Linux 2 5.10.192-183.736.amzn2.aarch64 containerd://1.6.19 ip-192-168-4-142.ec2.internal Ready <none> 2m31s v1.25.13-eks-43840fb 192.168.4.142 126.96.36.199 Amazon Linux 2 5.10.192-183.736.amzn2.aarch64 containerd://1.6.19
To delete the resources associated with the cluster run:
eksctl delete cluster --region=us-east-1 --name=cluster-1
You can now use
eksctl to create, manage, and delete more complex infrastructures.
How would you rate the overall quality of this tool quick-install guide?