在 Linux 上安装和设置 kubectl

开始之前

您必须使用与您的集群版本差异在一个次版本之内的 kubectl 版本。例如，v1.35 客户端可以与 v1.34、v1.35 和 v1.36 控制平面通信。使用最新兼容版本的 kubectl 有助于避免预料之外的问题。

在 Linux 上安装 kubectl

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

使用 curl 在 Linux 上安装 kubectl 二进制文件
使用原生包管理器安装
使用其他包管理器安装

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

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

x86-64
ARM64


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


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

说明

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

例如，要在 Linux x86-64 上下载版本 1.35.0，请键入

curl -LO https://dl.k8s.io/release/v1.35.0/bin/linux/amd64/kubectl

对于 Linux ARM64，请键入

curl -LO https://dl.k8s.io/release/v1.35.0/bin/linux/arm64/kubectl

验证二进制文件（可选）

下载 kubectl 校验和文件

x86-64
ARM64


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


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

使用校验和文件验证 kubectl 二进制文件

echo "$(cat kubectl.sha256)  kubectl" | sha256sum --check

如果有效，输出为

kubectl: OK

如果检查失败，sha256 以非零状态退出并打印类似以下的输出

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

说明

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

安装 kubectl

sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl

说明

如果您在目标系统上没有 root 访问权限，仍然可以将 kubectl 安装到 ~/.local/bin 目录

chmod +x kubectl
mkdir -p ~/.local/bin
mv ./kubectl ~/.local/bin/kubectl
# and then append (or prepend) ~/.local/bin to $PATH

测试以确保您安装的版本是最新的
```
kubectl version --client
```
或者使用此命令查看详细版本信息
```
kubectl version --client --output=yaml
```

使用原生包管理器安装

更新 apt 包索引并安装使用 Kubernetes apt 仓库所需的包

sudo apt-get update
# apt-transport-https may be a dummy package; if so, you can skip that package
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

下载 Kubernetes 包仓库的公共签名密钥。所有仓库都使用相同的签名密钥，因此您可以忽略 URL 中的版本

# If the folder `/etc/apt/keyrings` does not exist, it should be created before the curl command, read the note below.
# sudo mkdir -p -m 755 /etc/apt/keyrings
curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.35/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
sudo chmod 644 /etc/apt/keyrings/kubernetes-apt-keyring.gpg # allow unprivileged APT programs to read this keyring

说明

在 Debian 12 和 Ubuntu 22.04 之前的版本中，文件夹 /etc/apt/keyrings 默认情况下不存在，并且在 curl 命令之前应创建它。

添加适当的 Kubernetes apt 仓库。如果您想使用 Kubernetes 版本不同于 v1.35，请在下面的命令中将 v1.35 替换为所需的次版本

# This overwrites any existing configuration in /etc/apt/sources.list.d/kubernetes.list
echo 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.35/deb/ /' | sudo tee /etc/apt/sources.list.d/kubernetes.list
sudo chmod 644 /etc/apt/sources.list.d/kubernetes.list   # helps tools such as command-not-found to work correctly

说明

要将 kubectl 升级到另一个次版本，您需要在运行 apt-get update 和 apt-get upgrade 之前，先在 /etc/apt/sources.list.d/kubernetes.list 中更新版本。此过程在更改 Kubernetes 包仓库中有更详细的描述。

更新 apt 包索引，然后安装 kubectl

sudo apt-get update
sudo apt-get install -y kubectl

添加 Kubernetes yum 仓库。如果您想使用 Kubernetes 版本不同于 v1.35，请在下面的命令中将 v1.35 替换为所需的次版本。

# This overwrites any existing configuration in /etc/yum.repos.d/kubernetes.repo
cat <<EOF | sudo tee /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://pkgs.k8s.io/core:/stable:/v1.35/rpm/
enabled=1
gpgcheck=1
gpgkey=https://pkgs.k8s.io/core:/stable:/v1.35/rpm/repodata/repomd.xml.key
EOF

说明

要将 kubectl 升级到另一个次版本，您需要在运行 yum update 之前，先在 /etc/yum.repos.d/kubernetes.repo 中更新版本。此过程在更改 Kubernetes 包仓库中有更详细的描述。

使用 yum 安装 kubectl
```
sudo yum install -y kubectl
```

添加 Kubernetes zypper 仓库。如果您想使用 Kubernetes 版本不同于 v1.35，请在下面的命令中将 v1.35 替换为所需的次版本。

# This overwrites any existing configuration in /etc/zypp/repos.d/kubernetes.repo
cat <<EOF | sudo tee /etc/zypp/repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://pkgs.k8s.io/core:/stable:/v1.35/rpm/
enabled=1
gpgcheck=1
gpgkey=https://pkgs.k8s.io/core:/stable:/v1.35/rpm/repodata/repomd.xml.key
EOF

说明

要将 kubectl 升级到另一个次版本，您需要在运行 zypper update 之前，先在 /etc/zypp/repos.d/kubernetes.repo 中更新版本。此过程在更改 Kubernetes 包仓库中有更详细的描述。

更新 zypper 并确认新的仓库添加

sudo zypper update

当出现此消息时，按 't' 或 'a'

New repository or package signing key received:

Repository:       Kubernetes
Key Fingerprint:  1111 2222 3333 4444 5555 6666 7777 8888 9999 AAAA
Key Name:         isv:kubernetes OBS Project <isv:kubernetes@build.opensuse.org>
Key Algorithm:    RSA 2048
Key Created:      Thu 25 Aug 2022 01:21:11 PM -03
Key Expires:      Sat 02 Nov 2024 01:21:11 PM -03 (expires in 85 days)
Rpm Name:         gpg-pubkey-9a296436-6307a177

Note: Signing data enables the recipient to verify that no modifications occurred after the data
were signed. Accepting data with no, wrong or unknown signature can lead to a corrupted system
and in extreme cases even to a system compromise.

Note: A GPG pubkey is clearly identified by its fingerprint. Do not rely on the key's name. If
you are not sure whether the presented key is authentic, ask the repository provider or check
their web site. Many providers maintain a web page showing the fingerprints of the GPG keys they
are using.

Do you want to reject the key, trust temporarily, or trust always? [r/t/a/?] (r): a

使用 zypper 安装 kubectl
```
sudo zypper install -y kubectl
```

如果您在 Ubuntu 或其他支持 snap 包管理器的 Linux 发行版上，kubectl 可作为 snap 应用程序提供。

snap install kubectl --classic
kubectl version --client

如果您在 Linux 上使用 Homebrew 包管理器，kubectl 可用于安装。

brew 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

解决“未找到 Auth Provider”错误消息

在 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 生成 kubectl 的 Bash 补全脚本。在 shell 中引用补全脚本可启用 kubectl 自动补全。

但是，补全脚本依赖于 bash-completion，这意味着您必须先安装此软件（您可以通过运行 type _init_completion 来测试是否已安装 bash-completion）。

安装 bash-completion

bash-completion 由许多包管理器提供（请参见此处）。您可以使用 apt-get install bash-completion 或 yum install bash-completion 等命令进行安装。

上述命令创建 /usr/share/bash-completion/bash_completion，这是 bash-completion 的主脚本。根据您的包管理器，您必须手动将此文件添加到您的 ~/.bashrc 文件中。

要弄清楚，重新加载您的 shell 并运行 type _init_completion。如果命令成功，您已经准备就绪，否则将以下内容添加到您的 ~/.bashrc 文件

source /usr/share/bash-completion/bash_completion

重新加载您的 shell 并通过键入 type _init_completion 验证是否正确安装了 bash-completion。

启用 kubectl 自动补全

Bash

现在您需要确保在所有 shell 会话中引用 kubectl 补全脚本。您可以通过以下两种方式做到这一点

用户
系统


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


kubectl completion bash | sudo tee /etc/bash_completion.d/kubectl > /dev/null
sudo chmod a+r /etc/bash_completion.d/kubectl

如果您有 kubectl 的别名，您可以扩展 shell 补全以使用该别名

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

说明

bash-completion 会引用 /etc/bash_completion.d 中的所有补全脚本。

两种方法是等效的。重新加载您的 shell 后，kubectl 自动补全应该可以工作。要在当前 shell 会话中启用 bash 自动补全，请引用 ~/.bashrc 文件

source ~/.bashrc

说明

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

可以使用命令 kubectl completion fish 生成 kubectl 的 Fish 补全脚本。在 shell 中引用补全脚本可启用 kubectl 自动补全。

要在所有 shell 会话中执行此操作，请将以下行添加到您的 ~/.config/fish/config.fish 文件

kubectl completion fish | source

重新加载 shell 后，kubectl 自动补全应该就可以正常工作了。

可以使用命令 kubectl completion zsh 生成 kubectl 的 Zsh 补全脚本。在 shell 中引用补全脚本可启用 kubectl 自动补全。

要在所有 shell 会话中执行此操作，请将以下内容添加到您的 ~/.zshrc 文件

source <(kubectl completion zsh)

如果您有 kubectl 的别名，kubectl 自动补全将自动与之配合使用。

重新加载 shell 后，kubectl 自动补全应该就可以正常工作了。

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

autoload -Uz compinit
compinit

配置 kuberc

有关更多信息，请参阅 kuberc。

安装 `kubectl convert` 插件

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