Kubernetes kubectl 工具在 Linux 系统上的安装指南

Kubernetes kubectl 工具在 Linux 系统上的安装指南

website Kubernetes website and documentation repo: 项目地址: https://gitcode.com/gh_mirrors/webs/website

前言

kubectl 是 Kubernetes 集群管理的命令行工具，是与 Kubernetes API 交互的主要方式。本文将详细介绍在 Linux 系统上安装 kubectl 的多种方法，帮助开发者快速搭建 Kubernetes 开发环境。

版本兼容性说明

在安装 kubectl 前，必须了解版本兼容性原则：

• kubectl 客户端版本应与集群控制平面版本保持一个小版本的差异
• 例如，v1.28 客户端可以与 v1.27、v1.28 和 v1.29 控制平面通信
• 建议使用最新的兼容版本以避免潜在问题

安装方法概览

Linux 系统上安装 kubectl 主要有以下几种方式：

1. 使用 curl 下载二进制文件安装
2. 使用系统原生包管理器安装
3. 使用其他包管理工具安装

方法一：使用 curl 下载二进制文件安装

下载 kubectl 二进制文件

根据 CPU 架构选择对应命令：

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

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

如需下载特定版本，替换 URL 中的版本号即可。

验证文件完整性（可选但推荐）

下载校验和文件：

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

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

执行验证：

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

验证通过应显示 kubectl: OK。

安装 kubectl

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

若无 root 权限，可安装到用户目录：

chmod +x kubectl
mkdir -p ~/.local/bin
mv ./kubectl ~/.local/bin/kubectl
export PATH=$PATH:~/.local/bin

验证安装

kubectl version --client

方法二：使用系统原生包管理器安装

Debian/Ubuntu 系统

1. 更新包索引并安装依赖：

sudo apt-get update
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

2. 添加 Kubernetes 仓库密钥：

sudo mkdir -p -m 755 /etc/apt/keyrings
curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.28/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg

3. 添加仓库：

echo 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.28/deb/ /' | sudo tee /etc/apt/sources.list.d/kubernetes.list

4. 安装 kubectl：

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

RHEL/CentOS 系统

1. 添加仓库：

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

2. 安装 kubectl：

sudo yum install -y kubectl

openSUSE/SLES 系统

1. 添加仓库：

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

2. 刷新并安装：

sudo zypper refresh
sudo zypper install -y kubectl

方法三：使用其他包管理工具安装

Snap 安装

sudo snap install kubectl --classic

Homebrew 安装

brew install kubectl

验证 kubectl 配置

安装完成后，建议验证配置：

kubectl cluster-info

可选配置

启用 Shell 自动补全

Bash:

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

Zsh:

echo 'source <(kubectl completion zsh)' >> ~/.zshrc

Fish:

kubectl completion fish | source

安装 kubectl convert 插件

用于转换不同 API 版本间的配置文件：

curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert"
sudo install -o root -g root -m 0755 kubectl-convert /usr/local/bin/kubectl-convert

总结

本文详细介绍了在 Linux 系统上安装 kubectl 的多种方法，包括二进制安装、系统包管理器安装以及其他包管理工具安装。建议根据实际环境选择最适合的安装方式，并完成必要的验证和配置。

对于生产环境，建议使用系统包管理器安装，便于后续升级维护；开发环境则可选择更灵活的二进制安装方式。无论采用哪种方式，都应注意保持 kubectl 版本与集群版本的兼容性。

website Kubernetes website and documentation repo: 项目地址: https://gitcode.com/gh_mirrors/webs/website