在 macOS 上安装和设置 kubectl

准备工作

您必须使用与您的集群版本相差不超过一个次要版本的 kubectl 版本。例如，v1.30 客户端可以与 v1.29、v1.30 和 v1.31 控制平面通信。使用最新的兼容版本的 kubectl 有助于避免意外问题。

在 macOS 上安装 kubectl

以下是在 macOS 上安装 kubectl 的方法

在 macOS 上安装 kubectl
验证 kubectl 配置
可选的 kubectl 配置和插件
- 启用 Shell 自动补全
- 安装 kubectl convert 插件

在 macOS 上使用 curl 安装 kubectl 二进制文件

下载最新版本

英特尔
Apple 芯片


   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl"


   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl"

注意

要下载特定版本，请将命令中的 $(curl -L -s https://dl.k8s.io/release/stable.txt) 部分替换为特定版本。

例如，要在英特尔 macOS 上下载 1.30.0 版本，请键入

curl -LO "https://dl.k8s.io/release/v1.30.0/bin/darwin/amd64/kubectl"

对于 Apple 芯片上的 macOS，请键入

curl -LO "https://dl.k8s.io/release/v1.30.0/bin/darwin/arm64/kubectl"

验证二进制文件（可选）

下载 kubectl 校验和文件

英特尔
Apple 芯片


   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl.sha256"


   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl.sha256"

根据校验和文件验证 kubectl 二进制文件

echo "$(cat kubectl.sha256)  kubectl" | shasum -a 256 --check

如果有效，输出为

kubectl: OK

如果检查失败，shasum 将以非零状态退出并打印类似于以下内容的输出

kubectl: FAILED
shasum: WARNING: 1 computed checksum did NOT match

注意

下载相同版本的二进制文件和校验和。

使 kubectl 二进制文件可执行。
```
chmod +x ./kubectl
```
将 kubectl 二进制文件移动到系统 PATH 上的文件位置。
```
sudo mv ./kubectl /usr/local/bin/kubectl
sudo chown root: /usr/local/bin/kubectl
```
注意
确保 /usr/local/bin 在您的 PATH 环境变量中。
测试以确保您安装的版本是最新的
```
kubectl version --client
```
或者使用以下命令获取详细的版本信息
```
kubectl version --client --output=yaml
```
安装并验证 kubectl 后，删除校验和文件
```
rm kubectl.sha256
```

在 macOS 上使用 Homebrew 安装

如果您在 macOS 上并使用 Homebrew 包管理器，则可以使用 Homebrew 安装 kubectl。

运行安装命令

brew install kubectl

或

brew install kubernetes-cli

测试以确保您安装的版本是最新的
```
kubectl version --client
```

在 macOS 上使用 Macports 安装

如果您在 macOS 上并使用 Macports 包管理器，则可以使用 Macports 安装 kubectl。

运行安装命令

sudo port selfupdate
sudo port install kubectl

测试以确保您安装的版本是最新的
```
kubectl version --client
```

验证 kubectl 配置

为了让 kubectl 找到并访问 Kubernetes 集群，它需要一个 kubeconfig 文件，该文件在您使用 kube-up.sh 创建集群或成功部署 Minikube 集群时自动创建。默认情况下，kubectl 配置位于 ~/.kube/config。

通过获取集群状态来检查 kubectl 是否已正确配置

kubectl cluster-info

如果您看到 URL 响应，则表示 kubectl 已正确配置以访问您的集群。

如果您看到类似于以下内容的消息，则表示 kubectl 配置不正确或无法连接到 Kubernetes 集群。

The connection to the server <server-name:port> was refused - did you specify the right host or port?

例如，如果您打算在笔记本电脑（本地）上运行 Kubernetes 集群，则需要先安装 Minikube 之类的工具，然后再重新运行上述命令。

如果 kubectl cluster-info 返回 url 响应但您无法访问您的集群，请使用以下命令检查它是否已正确配置

kubectl cluster-info dump

对“未找到身份验证提供程序”错误消息进行故障排除

在 Kubernetes 1.26 中，kubectl 移除了一些云提供商的托管 Kubernetes 产品的内置身份验证。这些提供商已经发布了 kubectl 插件来提供云特定的身份验证。有关说明，请参阅以下提供商文档

Azure AKS：kubelogin 插件
Google Kubernetes Engine：gke-gcloud-auth-plugin

（也可能由于其他原因看到相同的错误消息，与该更改无关。）

可选的 kubectl 配置和插件

启用 Shell 自动补全

kubectl 为 Bash、Zsh、Fish 和 PowerShell 提供自动补全支持，可以为您节省大量输入时间。

以下是为 Bash、Fish 和 Zsh 设置自动补全的步骤。

简介

可以使用 kubectl completion bash 生成 Bash 的 kubectl 补全脚本。在您的 Shell 中加载此脚本将启用 kubectl 补全。

但是，kubectl 补全脚本依赖于 bash-completion，因此您必须事先安装它。

警告

bash-completion 有两个版本，v1 和 v2。V1 用于 Bash 3.2（macOS 上的默认版本），v2 用于 Bash 4.1+。kubectl 补全脚本在 bash-completion v1 和 Bash 3.2 下无法正常工作。它需要bash-completion v2 和Bash 4.1+。因此，为了能够在 macOS 上正确使用 kubectl 补全，您必须安装并使用 Bash 4.1+（说明）。以下说明假设您使用的是 Bash 4.1+（即 4.1 或更高版本的任何 Bash 版本）。

升级 Bash

此处的说明假设您使用的是 Bash 4.1+。您可以通过运行以下命令检查您的 Bash 版本

echo $BASH_VERSION

如果版本太旧，您可以使用 Homebrew 安装/升级它

brew install bash

重新加载您的 Shell 并验证是否正在使用所需的版本

echo $BASH_VERSION $SHELL

Homebrew 通常将其安装在 /usr/local/bin/bash。

安装 bash-completion

注意

如前所述，这些说明假设您使用的是 Bash 4.1+，这意味着您将安装 bash-completion v2（与 Bash 3.2 和 bash-completion v1 不同，在这种情况下 kubectl 补全将无法工作）。

您可以使用 type _init_completion 测试是否已经安装了 bash-completion v2。如果没有，您可以使用 Homebrew 安装它

brew install bash-completion@2

如该命令的输出中所述，将以下内容添加到您的 ~/.bash_profile 文件中

brew_etc="$(brew --prefix)/etc" && [[ -r "${brew_etc}/profile.d/bash_completion.sh" ]] && . "${brew_etc}/profile.d/bash_completion.sh"

重新加载您的 Shell 并使用 type _init_completion 验证 bash-completion v2 是否已正确安装。

启用 kubectl 自动补全

您现在必须确保在所有 Shell 会话中都加载了 kubectl 补全脚本。有多种方法可以实现这一点

在您的 ~/.bash_profile 文件中加载补全脚本

echo 'source <(kubectl completion bash)' >>~/.bash_profile

将补全脚本添加到 /usr/local/etc/bash_completion.d 目录

kubectl completion bash >/usr/local/etc/bash_completion.d/kubectl

如果您为 kubectl 设置了别名，则可以扩展 Shell 补全以使用该别名

echo 'alias k=kubectl' >>~/.bash_profile
echo 'complete -o default -F __start_kubectl k' >>~/.bash_profile

如果您使用 Homebrew 安装了 kubectl（如此处所述），则 kubectl 补全脚本应该已经在 /usr/local/etc/bash_completion.d/kubectl 中。在这种情况下，您不需要做任何事情。
注意
Homebrew 安装的 bash-completion v2 会加载 BASH_COMPLETION_COMPAT_DIR 目录中的所有文件，这就是后两种方法有效的原因。

无论如何，在重新加载您的 Shell 后，kubectl 补全应该可以工作了。

注意

Fish 的自动补全需要 kubectl 1.23 或更高版本。

可以使用 kubectl completion fish 命令生成 Fish 的 kubectl 补全脚本。在您的 Shell 中加载补全脚本将启用 kubectl 自动补全。

要在所有 Shell 会话中都这样做，请将以下行添加到您的 ~/.config/fish/config.fish 文件中

kubectl completion fish | source

在重新加载您的 Shell 后，kubectl 自动补全应该可以工作了。

可以使用 kubectl completion zsh 命令生成 Zsh 的 kubectl 补全脚本。在您的 Shell 中加载补全脚本将启用 kubectl 自动补全。

要在所有 Shell 会话中都这样做，请将以下内容添加到您的 ~/.zshrc 文件中

source <(kubectl completion zsh)

如果您为 kubectl 设置了别名，kubectl 自动补全将自动与其一起使用。

在重新加载您的 Shell 后，kubectl 自动补全应该可以工作了。

如果您收到类似 2: command not found: compdef 的错误，请将以下内容添加到您的 ~/.zshrc 文件的开头

autoload -Uz compinit
compinit

安装 `kubectl convert` 插件

Kubernetes 命令行工具 kubectl 的插件，允许您在不同 API 版本之间转换清单。这对于将清单迁移到具有更新 Kubernetes 版本的非弃用 API 版本特别有用。有关更多信息，请访问迁移到非弃用 API

使用以下命令下载最新版本

英特尔
Apple 芯片


   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert"


   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert"

验证二进制文件（可选）

下载 kubectl-convert 校验和文件

英特尔
Apple 芯片


   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert.sha256"


   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert.sha256"

根据校验和文件验证 kubectl-convert 二进制文件

echo "$(cat kubectl-convert.sha256)  kubectl-convert" | shasum -a 256 --check