Skip to content

Commit f6b65d9

Browse files
pareenavermapareenaverma
authored
Merge pull request #3168 from anupras-mohapatra-arm/eksctl
Refreshing content in the eksctl install guide
2 parents a89ecb8 + 4e72347 commit f6b65d9

1 file changed

Lines changed: 38 additions & 27 deletions

File tree

‎content/install-guides/eksctl.md‎

Lines changed: 38 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -9,25 +9,26 @@ layout: installtoolsall
99
minutes_to_complete: 5
1010
multi_install: false
1111
multitool_install_part: false
12-
official_docs: https://docs.aws.amazon.com/eks/latest/userguide/eksctl.html
12+
official_docs: https://docs.aws.amazon.com/eks/latest/eksctl/what-is-eksctl.html
13+
description: Install eksctl (Amazon EKS CLI) on Arm Linux and Windows on Arm to create and manage Kubernetes clusters on Amazon EKS.
1314
test_images:
1415
- ubuntu:latest
1516
test_link: null
1617
test_maintenance: true
17-
title: AWS EKS CLI (eksctl)
18+
title: eksctl (Amazon EKS CLI)
1819
tool_install: true
1920
weight: 1
2021
---
2122

22-
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](https://eksctl.io/).
23+
`eksctl` is a command line tool to create and manage Kubernetes clusters in [Amazon Elastic Kubernetes Service (Amazon EKS)](https://docs.aws.amazon.com/eks/latest/userguide/what-is-eks.html). It simplifies cluster creation and saves time compared to using the Amazon Web Services (AWS) console. For additional information, see [eksctl official documentation](https://docs.aws.amazon.com/eks/latest/eksctl/what-is-eksctl.html).
2324

24-
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.
25+
`eksctl` is available for a variety of operating systems and Linux distributions. It runs on both Arm Linux distributions and Windows on Arm. The following steps show how you can install `eksctl` and verify the installation by creating a simple Amazon EKS cluster.
2526

26-
## What should I do before installing eksctl on Arm Linux and Windows on Arm?
27+
## Before you begin
2728

28-
This install guide provides a quick solution to install `eksctl` on Arm Linux and Windows on Arm.
29+
Before installing `eksctl`, follow these steps:
2930

30-
1. Confirm you have an Arm machine
31+
### Confirm you have an Arm machine
3132

3233
For Linux, confirm you are using an Arm machine by running:
3334

@@ -43,25 +44,39 @@ aarch64
4344

4445
If you see a different result, you are not using an Arm computer running 64-bit Linux.
4546

46-
For Windows, confirm the Arm architecture by typing "Settings" in the Windows search box.
47+
For Windows, follow these steps:
4748

48-
When the settings appear, click System on the left side and then About at the bottom.
49+
1. Right-click **Start** and choose **Windows Settings**.​​​​​​
50+
2. When the settings appear, select **System** on the left side and then select **About**.
51+
3. Under **Device specifications**, look for **System type**. You should see **ARM-based processor** listed for your computer.
4952

50-
In the Device specifications section look for "ARM-based processor" in the System type area.
53+
If you see a different result, you are not using an Arm computer running Windows.
5154

52-
2. Install `kubectl`
55+
### Install kubectl
5356

54-
Install the Kubernetes command-line tool, `kubectl`, using the [Kubectl install guide](/install-guides/kubectl/).
57+
Install the Kubernetes command-line tool `kubectl` by following the steps in the [Kubectl install guide](/install-guides/kubectl/).
5558

56-
## How do I download and install eksctl on Arm Linux?
59+
### Configure the AWS CLI
60+
61+
`eksctl` relies on the AWS CLI being installed and configured. Use the [AWS CLI install guide](/install-guides/aws-cli/) to install the AWS CLI. The CLI provides the `aws` command.
62+
63+
You'll 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 [Configuring settings for the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) for more details.
64+
65+
## Download and install eksctl
66+
67+
The steps for downloading and installing `eksctl` depend on your operating system.
68+
69+
### Arm Linux
70+
71+
To download and install `eksctl` on Arm Linux, follow these steps:
5772

5873
1. Download the `eksctl` package using `curl`:
5974

6075
```bash { target="ubuntu:latest" }
6176
curl -sLO "https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_Linux_arm64.tar.gz"
6277
```
6378

64-
2. Install `eksctl` with:
79+
2. Install `eksctl`:
6580

6681
```bash { target="ubuntu:latest" }
6782
tar -xzf eksctl_Linux_arm64.tar.gz -C /tmp && rm eksctl_Linux_arm64.tar.gz
@@ -74,13 +89,15 @@ sudo mv /tmp/eksctl /usr/local/bin
7489
eksctl version
7590
```
7691

77-
The output will be similar to:
92+
The output is similar to:
7893

7994
```output
8095
0.160.0
8196
```
8297

83-
## How do I download and install eksctl on Windows?
98+
### Windows on Arm
99+
100+
To download and install `eksctl` on Windows, follow these steps:
84101

85102
1. Use a browser to download the [EKS CLI latest release](https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_Windows_arm64.zip).
86103

@@ -92,21 +109,15 @@ The output will be similar to:
92109
eksctl.exe version
93110
```
94111

95-
The output will be similar to:
112+
The output is similar to:
96113

97114
```output
98115
0.160.0
99116
```
100117

101-
## How do I configure the AWS CLI?
102-
103-
`eksctl` relies on the AWS CLI being installed and configured. Use the [AWS CLI install guide](/install-guides/aws-cli/) to install the AWS CLI. The CLI provides the `aws` command.
104-
105-
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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) for more details.
106-
107-
## How do I use eksctl to create a simple EKS cluster?
118+
## Verify eksctl installation by creating a simple EKS cluster
108119

109-
With your AWS account configured, run `eksctl` to create a cluster with 2 nodes with AWS Graviton processors:
120+
With your AWS account configured, run `eksctl` to create a cluster with two nodes with AWS Graviton processors:
110121

111122
```console
112123
eksctl create cluster \
@@ -117,7 +128,7 @@ eksctl create cluster \
117128
--nodegroup-name node-group-1
118129
```
119130

120-
Use the AWS console to look at the resources associated with the cluster and monitor progress of cluster creation.
131+
Use the AWS console to look at the resources associated with the cluster and monitor the progress of cluster creation.
121132

122133
When the cluster is created, use `kubectl` to get the status of the nodes in the cluster.
123134

@@ -133,7 +144,7 @@ ip-192-168-38-144.ec2.internal Ready <none> 2m31s v1.25.13-eks-43840fb
133144
ip-192-168-4-142.ec2.internal Ready <none> 2m31s v1.25.13-eks-43840fb 192.168.4.142 54.175.254.219 Amazon Linux 2 5.10.192-183.736.amzn2.aarch64 containerd://1.6.19
134145
```
135146

136-
## How do I use eksctl to delete the cluster?
147+
## Use eksctl to delete the cluster
137148

138149
To delete the resources associated with the cluster, run:
139150

0 commit comments

Comments
 (0)