Kubernetes 项目：Windows 系统安装 kubectl 完全指南

窦恺墩

于 2025-06-10 09:05:54 发布

阅读量352

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_01159/article/details/148550038

Kubernetes 项目：Windows 系统安装 kubectl 完全指南

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

前言

kubectl 是 Kubernetes 集群的命令行管理工具，是每个 Kubernetes 管理员和开发者的必备工具。本文将详细介绍在 Windows 系统上安装 kubectl 的多种方法，并包含验证安装、配置自动补全等实用技巧。

版本兼容性说明

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

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

安装方法一：直接下载二进制文件

这是最基础的安装方式，适合所有 Windows 版本：

下载 kubectl 可执行文件：
- 访问 Kubernetes 发布页面获取最新稳定版
- 选择对应体系结构的二进制文件（amd64/arm64）
- 或使用 curl 直接下载：
```
curl.exe -LO "https://dl.k8s.io/release/v1.28.0/bin/windows/amd64/kubectl.exe"
```

验证文件完整性（推荐）：

下载校验和文件：

curl.exe -LO "https://dl.k8s.io/v1.28.0/bin/windows/amd64/kubectl.exe.sha256"

验证方法：

CMD 命令提示符：

CertUtil -hashfile kubectl.exe SHA256
type kubectl.exe.sha256

PowerShell：

$(Get-FileHash -Algorithm SHA256 .\kubectl.exe).Hash -eq $(Get-Content .\kubectl.exe.sha256)

配置环境变量：
- 将 kubectl.exe 所在目录添加到系统 PATH 环境变量中
验证安装：
```
kubectl version --client
```

注意：如果安装了 Docker Desktop for Windows，它会在 PATH 中添加自己的 kubectl，可能需要调整 PATH 顺序或删除 Docker 的 kubectl。

安装方法二：使用包管理器

对于习惯使用包管理的用户，Windows 提供了多种选择：

1. Chocolatey（适合企业环境）

choco install kubernetes-cli

2. Scoop（适合开发者）

scoop install kubectl

3. Winget（Windows 11 原生支持）

winget install -e --id Kubernetes.kubectl

安装后同样需要验证版本：

kubectl version --client

基础配置

完成安装后，建议进行以下基础配置：

创建 kubectl 配置目录：
```
mkdir ~/.kube
cd ~/.kube
```
创建配置文件：
```
New-Item config -type file
```
使用文本编辑器配置集群连接信息

验证配置

使用以下命令验证配置是否正确：

kubectl cluster-info

如果能看到集群信息，说明配置成功。若出现错误，需检查：

配置文件位置和内容
网络连接
认证信息

高级配置技巧

1. 启用 PowerShell 自动补全

大幅提升命令行效率：

# 创建配置文件（如不存在）
if (!(Test-Path -Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force }

# 添加自动补全配置
Add-Content -Path $PROFILE -Value 'Set-ExecutionPolicy RemoteSigned -Scope CurrentUser'
Add-Content -Path $PROFILE -Value 'Register-ArgumentCompleter -CommandName kubectl -ScriptBlock { __kubectl_bash_autocomplete @args }'

# 重新加载配置
. $PROFILE

2. 安装 kubectl-convert 插件

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

curl.exe -LO "https://dl.k8s.io/release/v1.28.0/bin/windows/amd64/kubectl-convert.exe"

# 验证
$(Get-FileHash -Algorithm SHA256 .\kubectl-convert.exe).Hash -eq $(Get-Content .\kubectl-convert.exe.sha256)

# 添加到 PATH

验证插件：

kubectl convert --help

常见问题解决

版本不匹配错误：
- 确认客户端和服务端版本差异不超过一个小版本
- 使用 kubectl version --client --output=yaml 查看详细信息
证书验证失败：
- 检查系统时间是否正确
- 验证集群 CA 证书是否可信
命令补全不工作：
- 确认 PowerShell 执行策略设置
- 检查 profile 文件是否正确加载