Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.
Installing eksctl
This topic covers eksctl
, a simple command line utility for creating and
managing Kubernetes clusters on Amazon EKS. The eksctl
command line utility provides
the fastest and easiest way to create a new cluster with nodes for Amazon EKS. For more
information and to see the official documentation, visit https://eksctl.io/.
This topic helps you to download and install eksctl
binaries for macOS,
Linux, and Windows operating systems.
Prerequisite
The kubectl
command line tool is installed on your computer or
Amazon CloudShell. The version can be the same as or up to one minor version earlier or later than
the Kubernetes version of your cluster. For example, if your cluster version is 1.21
, you can use kubectl
version 1.20
,1.21
, or 1.22
with it. To
install or upgrade kubectl
, see Installing kubectl.
Installing or upgrading eksctl
This section helps you install or upgrade to the latest version of the
eksctl
command line utility. Complete the procedure for your operating
system.
- macOS
To install or upgrade eksctl
on macOS
The easiest way to get started with Amazon EKS and macOS is by installing
eksctl
with Homebrew, an open-source tool that can be installed using these instructions. The eksctl
Homebrew recipe installs
eksctl
and any other dependencies that are required for
Amazon EKS, such as kubectl
. The recipe also installs the aws-iam-authenticator, which is required if
you don't have the Amazon CLI version 1.16.156
or
higher installed.
-
If you do not already have Homebrew installed on macOS, install it with the
following command.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
-
Install the Weaveworks Homebrew tap.
brew tap weaveworks/tap
-
Install or upgrade eksctl
.
-
Install eksctl
with the following command:
brew install weaveworks/tap/eksctl
-
If eksctl
is already installed, run the following command
to upgrade:
brew upgrade eksctl && brew link --overwrite eksctl
-
Test that your installation was successful with the following command.
eksctl version
- Linux
To install or upgrade eksctl
on Linux
-
Download and extract the latest release of eksctl
with the
following command.
curl --silent --location "https://github.com/weaveworks/eksctl/releases/latest/download/eksctl_$(uname -s)_amd64.tar.gz" | tar xz -C /tmp
-
Move the extracted binary to /usr/local/bin
.
sudo mv /tmp/eksctl /usr/local/bin
-
Test that your installation was successful with the following command.
eksctl version
The GitTag
version should be at least
0.103.0
. If not, check your terminal output
for any installation or upgrade errors, or replace the address in step 1
with https://github.com/weaveworks/eksctl/releases/download/v0.103.0/eksctl_Linux_amd64.tar.gz
and complete steps 1-3
again.
- Windows
To install or upgrade
eksctl
on Windows
-
If you do not already have Chocolatey installed on your Windows system, see
Installing
Chocolatey.
-
Install or upgrade eksctl
.
-
Install the binaries with the following command:
choco install -y eksctl
-
If they are already installed, run the following command to
upgrade:
choco upgrade -y eksctl
-
Test that your installation was successful with the following command.
eksctl version