Table of Contents | ||
---|---|---|
|
Kubectl
is a command line tool that you use to communicate with the Kubernetes API server. The kubectl
binary is available in many operating system package managers. Using a package manager for your installation is often easier than a manual download and install process.
Info |
---|
Note: You must use a |
To install or update kubectl
1. Determine whether you already have kubectl
installed on your device.
kubectl version --client
If you have kubectl
installed in the path of your device, the example output includes information similar to the following. If you want to update the version that you currently have installed with a later version, complete the next step, making sure to install the new version in the same location that your current version is in.
Client Version: v1.30.X-eks-1234567
If you receive no output, then you either don't have kubectl
installed, or it's not installed in a location that's in your device's path.
Install or update
kubectl
onmacOS
, Linux, and Windows operating systems.
To install or update kubectl
on Linux
Download the
kubectl
binary for your cluster's Kubernetes version from Amazon S3.Kubernetes
1.30
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/amd64/kubectl
Kubernetes
1.30
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/amd64/kubectl
Kubernetes
1.29
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/linux/amd64/kubectl
Kubernetes
1.28
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/linux/amd64/kubectl
Kubernetes
1.27
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/linux/amd64/kubectl
Kubernetes
1.26
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/linux/amd64/kubectl
Kubernetes
1.25
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/linux/amd64/kubectl
Kubernetes
1.24
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/linux/amd64/kubectl
Kubernetes
1.23
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/linux/amd64/kubectl
Kubernetes
1.22
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/linux/amd64/kubectl
Kubernetes
1.21
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/linux/amd64/kubectl
(Optional) Verify the downloaded binary with the
SHA-256
checksum for your binary.Download the
SHA-256
checksum for your cluster's Kubernetes version from Amazon S3 using the command for your device's hardware platform. The first link for each version is foramd64
and the second link is forarm64
.Kubernetes
1.30
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/amd64/kubectl.sha256
Kubernetes
1.30
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/amd64/kubectl.sha256
Kubernetes
1.29
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/linux/amd64/kubectl.sha256
Kubernetes
1.28
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/linux/amd64/kubectl.sha256
Kubernetes
1.27
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/linux/amd64/kubectl.sha256
Kubernetes
1.26
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/linux/amd64/kubectl.sha256
Kubernetes
1.25
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/linux/amd64/kubectl.sha256
Kubernetes
1.24
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/linux/amd64/kubectl.sha256
Kubernetes
1.23
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/linux/amd64/kubectl.sha256
Kubernetes
1.22
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/linux/amd64/kubectl.sha256
Kubernetes
1.21
Code Block curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/linux/amd64/kubectl.sha256
Check the
SHA-256
checksum for your downloaded binary with one of the following commands.Code Block sha256sum -c kubectl.sha256
When using this command, make sure that you see the following output:
Code Block kubectl: OK
Code Block openssl sha1 -sha256 kubectl
When using this command, make sure that the generated checksum in the output matches in the checksum in the downloaded
kubectl.sha256
file.
Apply execute permissions to the binary.
Code Block chmod +x ./kubectl
Copy the binary to a folder in your
PATH
. If you have already installed a version ofkubectl
, then we recommend creating a$HOME/bin/kubectl
and ensuring that$HOME/bin
comes first in your$PATH
.Code Block mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
(Optional) Add the
$HOME/bin
path to your shell initialization file so that it is configured when you open a shell.Note
This step assumes you are using the Bash shell; if you are using another shell, change the command to use your specific shell initialization file.
Code Block echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
After you install
kubectl
, you can verify its version.Code Block kubectl version --client
When first installing kubectl
, it isn't yet configured to communicate with any server. We will cover this configuration as needed in other procedures. If you ever need to update the configuration to communicate with a particular cluster, you can run the following command. Replace region-code
with the AWS Region that your cluster is in. Replace my-cluster
with the name of your cluster.
Code Block |
---|
aws eks update-kubeconfig --region region-code --name my- |
To install or update kubectl
on Windows
Open a PowerShell terminal.
Download the
kubectl
binary for your cluster's Kubernetes version from Amazon S3.Kubernetes
1.30
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/windows/amd64/kubectl.exe
Kubernetes
1.29
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/windows/amd64/kubectl.exe
Kubernetes
1.28
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/windows/amd64/kubectl.exe
Kubernetes
1.27
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/windows/amd64/kubectl.exe
Kubernetes
1.26
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/windows/amd64/kubectl.exe
Kubernetes
1.25
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/windows/amd64/kubectl.exe
Kubernetes
1.24
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/windows/amd64/kubectl.exe
Kubernetes
1.23
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/windows/amd64/kubectl.exe
Kubernetes
1.22
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/windows/amd64/kubectl.exe
Kubernetes
1.21
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/windows/amd64/kubectl.exe
(Optional) Verify the downloaded binary with the
SHA-256
checksum for your binary.Download the
SHA-256
checksum for your cluster's Kubernetes version for Windows.Kubernetes
1.30
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/windows/amd64/kubectl.exe.sha256
Kubernetes
1.29
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
Kubernetes
1.28
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
Kubernetes
1.27
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
Kubernetes
1.26
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
Kubernetes
1.25
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
Kubernetes
1.24
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
Kubernetes
1.23
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
Kubernetes
1.22
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
Kubernetes
1.21
Code Block curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
Check the
SHA-256
checksum for your downloaded binary.Code Block Get-FileHash kubectl.exe
Make sure that the generated checksum in the output matches in the checksum in the downloaded
kubectl.sha256
file. The PowerShell output should be an uppercase equivalent string of characters.
Copy the binary to a folder in your
PATH
. If you have an existing directory in yourPATH
that you use for command line utilities, copy the binary to that directory. Otherwise, complete the following steps.Create a new directory for your command line binaries, such as
C:\bin
.Copy the
kubectl.exe
binary to your new directory.Edit your user or system
PATH
environment variable to add the new directory to yourPATH
.Close your PowerShell terminal and open a new one to pick up the new
PATH
variable.
After you install
kubectl
, you can verify its version.Code Block kubectl version --client
When first installing kubectl
, it isn't yet configured to communicate with any server. We will cover this configuration as needed in other procedures. If you ever need to update the configuration to communicate with a particular cluster, you can run the following command. Replace region-code
with the AWS Region that your cluster is in. Replace my-cluster
with the name of your cluster.
Code Block |
---|
aws eks update-kubeconfig --region region-code --name my- |