安装或更新 kubectl
Kubectl
是一个命令行工具,用于与 Kubernetes API 服务器进行通信。很多操作系统程序包管理器中都提供 kubectl
二进制文件。使用程序包管理器进行安装通常比手动下载并安装这一过程更简单。
本主题将帮助您下载并安装或更新设备上的 kubectl
二进制文件。该二进制文件与上游社区版本
注意
您必须使用与您的 Amazon EKS 集群控制层面不同的一个次要版本内的 kubectl
版本。例如,1.24
kubectl
客户端使用 Kubernetes 1.23
、1.24
和 1.25
集群。
要安装或更新 kubectl
-
确定您是否已将
kubectl
安装在设备上。kubectl version --short --client
如果您已将
kubectl
安装在设备路径中,示例输出包括以下行。您可以忽略说明--short
将在未来成为默认设置的消息。如果要使用更高版本更新当前已安装的版本,请完成下一步,确保将新版本安装在当前版本所在的位置。Client Version: v
1.25.X-eks-1234567
如果您没有收到任何输出,则可能尚未安装
kubectl
,或者未安装在设备路径中的位置。 -
在
macOS
、Linux 和 Windows 操作系统上安装或更新kubectl
。- macOS
-
要在
macOS
上安装或更新kubectl
-
从 Amazon S3 为集群的 Kubernetes 版本下载二进制文件。
-
Kubernetes
1.25
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.25.7/2023-03-17/bin/darwin/amd64/kubectl
-
Kubernetes
1.24
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.24.11/2023-03-17/bin/darwin/amd64/kubectl
-
Kubernetes
1.23
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.23.17/2023-03-17/bin/darwin/amd64/kubectl
-
Kubernetes
1.22
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.22.17/2023-03-17/bin/darwin/amd64/kubectl
-
Kubernetes
1.21
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.21.14/2023-01-30/bin/darwin/amd64/kubectl
-
Kubernetes
1.20
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.20.15/2022-10-31/bin/darwin/amd64/kubectl
-
-
(可选)使用二进制文件的
SHA-256
校验和验证下载的二进制文件。-
下载集群 Kubernetes 版本的
SHA-256
校验和。-
Kubernetes
1.25
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.25.7/2023-03-17/bin/darwin/amd64/kubectl.sha256
-
Kubernetes
1.24
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.24.11/2023-03-17/bin/darwin/amd64/kubectl.sha256
-
Kubernetes
1.23
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.23.17/2023-03-17/bin/darwin/amd64/kubectl.sha256
-
Kubernetes
1.22
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.22.17/2023-03-17/bin/darwin/amd64/kubectl.sha256
-
Kubernetes
1.21
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.21.14/2023-01-30/bin/darwin/amd64/kubectl.sha256
-
Kubernetes
1.20
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.20.15/2022-10-31/bin/darwin/amd64/kubectl.sha256
-
-
检查下载的二进制文件的
SHA-256
校验和。openssl sha1 -sha256 kubectl
-
确保输出中生成的校验和与下载的
kubectl.sha256
文件中的校验和相匹配。
-
-
将执行权限应用于二进制文件。
chmod +x ./kubectl
-
将二进制文件复制到您的
PATH
中的文件夹。如果您已经安装了某个版本的kubectl
,建议您创建一个$HOME/bin/kubectl
并确保$HOME/bin
先出现在您的$PATH
中。mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
-
(可选) 将
$HOME/bin
路径添加到 shell 初始化文件,以便在打开 shell 时配置此路径。echo 'export PATH=$PATH:$HOME/bin' >> ~/.bash_profile
-
安装
kubectl
后,您可以验证其版本。kubectl version --short --client
您可以忽略说明
--short
将在未来成为默认设置的消息。
-
- Linux
-
要在 Linux 上安装或更新
kubectl
-
使用适用于您的设备硬件平台的命令从 Amazon S3 为集群的 Kubernetes 版本下载
kubectl
二进制文件。每个版本的第一个链接对应的是amd64
,第二个链接对应的是arm64
。-
Kubernetes
1.25
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.25.7/2023-03-17/bin/linux/amd64/kubectl
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.25.7/2023-03-17/bin/linux/arm64/kubectl
-
Kubernetes
1.24
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.24.11/2023-03-17/bin/linux/amd64/kubectl
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.24.11/2023-03-17/bin/linux/arm64/kubectl
-
Kubernetes
1.23
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.23.17/2023-03-17/bin/linux/amd64/kubectl
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.23.17/2023-03-17/bin/linux/arm64/kubectl
-
Kubernetes
1.22
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.22.17/2023-03-17/bin/linux/amd64/kubectl
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.22.17/2023-03-17/bin/linux/arm64/kubectl
-
Kubernetes
1.21
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.21.14/2023-01-30/bin/linux/amd64/kubectl
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.21.14/2023-01-30/bin/linux/arm64/kubectl
-
Kubernetes
1.20
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.20.15/2022-10-31/bin/linux/amd64/kubectl
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.20.15/2022-10-31/bin/linux/arm64/kubectl
-
-
(可选)使用二进制文件的
SHA-256
校验和验证下载的二进制文件。-
使用适用于您的设备硬件平台的命令从 Amazon S3 为集群的 Kubernetes 版本下载
SHA-256
校验和。每个版本的第一个链接对应的是amd64
,第二个链接对应的是arm64
。-
Kubernetes
1.25
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.25.7/2023-03-17/bin/linux/amd64/kubectl.sha256
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.25.7/2023-03-17/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.24
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.24.11/2023-03-17/bin/linux/amd64/kubectl.sha256
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.24.11/2023-03-17/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.23
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.23.17/2023-03-17/bin/linux/amd64/kubectl.sha256
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.23.17/2023-03-17/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.22
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.22.17/2023-03-17/bin/linux/amd64/kubectl.sha256
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.22.17/2023-03-17/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.21
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.21.14/2023-01-30/bin/linux/amd64/kubectl.sha256
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.21.14/2023-01-30/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.20
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.20.15/2022-10-31/bin/linux/amd64/kubectl.sha256
curl -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.20.15/2022-10-31/bin/linux/arm64/kubectl.sha256
-
-
使用下面的命令之一检查下载的二进制文件的
SHA-256
校验和。-
sha256sum -c kubectl.sha256
使用此命令时,请确保看到以下输出:
kubectl: OK
-
openssl sha1 -sha256 kubectl
使用此命令时,请确保输出中生成的校验和与下载的
kubectl.sha256
文件中的校验和相匹配。
-
-
-
将执行权限应用于二进制文件。
chmod +x ./kubectl
-
将二进制文件复制到您的
PATH
中的文件夹。如果您已经安装了某个版本的kubectl
,建议您创建一个$HOME/bin/kubectl
并确保$HOME/bin
先出现在您的$PATH
中。mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$PATH:$HOME/bin
-
(可选) 将
$HOME/bin
路径添加到 shell 初始化文件,以便在打开 shell 时配置此路径。注意
这一步假设您使用 Bash Shell;如果使用其他 Shell,请将命令更改为使用您的特定 Shell 的初始化文件。
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc
-
安装
kubectl
后,您可以验证其版本。kubectl version --short --client
您可以忽略说明
--short
将在未来成为默认设置的消息。
-
- Windows
-
要在 Windows 上安装或更新
kubectl
-
打开 PowerShell 终端。
-
从 Amazon S3 为集群的 Kubernetes 版本下载
kubectl
二进制文件。-
Kubernetes
1.25
curl.exe -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.25.7/2023-03-17/bin/windows/amd64/kubectl.exe
-
Kubernetes
1.24
curl.exe -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.24.11/2023-03-17/bin/windows/amd64/kubectl.exe
-
Kubernetes
1.23
curl.exe -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.23.17/2023-03-17/bin/windows/amd64/kubectl.exe
-
Kubernetes
1.22
curl.exe -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.22.17/2023-03-17/bin/windows/amd64/kubectl.exe
-
Kubernetes
1.21
curl.exe -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.21.14/2023-01-30/bin/windows/amd64/kubectl.exe
-
Kubernetes
1.20
curl.exe -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.20.15/2022-10-31/bin/windows/amd64/kubectl.exe
-
-
(可选)使用二进制文件的
SHA-256
校验和验证下载的二进制文件。-
为 Windows 的集群的 Kubernetes 版本下载
SHA-256
校验和。-
Kubernetes
1.25
curl.exe -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.25.7/2023-03-17/bin/windows/amd64/kubectl.exe.sha256
-
Kubernetes
1.24
curl.exe -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.24.11/2023-03-17/bin/windows/amd64/kubectl.exe.sha256
-
Kubernetes
1.23
curl.exe -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.23.17/2023-03-17/bin/windows/amd64/kubectl.exe.sha256
-
Kubernetes
1.22
curl.exe -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.22.17/2023-03-17/bin/windows/amd64/kubectl.exe.sha256
-
Kubernetes
1.21
curl.exe -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.21.14/2023-01-30/bin/windows/amd64/kubectl.exe.sha256
-
Kubernetes
1.20
curl.exe -O https://s3.cn-north-1.amazonaws.com.cn/amazon-eks/1.20.15/2022-10-31/bin/windows/amd64/kubectl.exe.sha256
-
-
检查下载的二进制文件的
SHA-256
校验和。Get-FileHash kubectl.exe
-
确保输出中生成的校验和与下载的
kubectl.sha256
文件中的校验和相匹配。PowerShell 的输出应为等效的大写字符串。
-
-
将二进制文件复制到您的
PATH
中的文件夹。如果PATH
中有现有目录可用于命令行实用程序,请将二进制文件复制到该目录。否则,请完成以下步骤。-
为命令行二进制文件创建一个新目录,例如
C:\bin
。 -
将
kubectl.exe
二进制文件复制到新目录。 -
编辑用户或系统
PATH
环境变量,将新目录添加到PATH
中。 -
关闭 PowerShell 终端并打开一个新的终端来选取新的
PATH
变量。
-
-
安装
kubectl
后,您可以验证其版本。kubectl version --short --client
您可以忽略说明
--short
将在未来成为默认设置的消息。
-