在 Windows 上设置和使用 kubectl 的综合指南，包括处理代理、管理多个集群和升级 kubectl。
译自 Best Practices for Using kubectl on Windows，作者 Jim Angel。
Kubectl 是访问 Kubernetes 集群的核心。文档传统上专注于 Linux，此帖子提供了在 Windows 10 上使用 kubectl 的最佳实践，包括：
- 为 PowerShell 设置 kubectl
- 在公司代理后面使用 kubectl
- 向 kubectl 添加集群
- 常见的 kubectl 多集群命令
- 升级 kubectl
- 故障排除和提示
随着 Kubernetes 1.14 宣布完全支持 Windows 节点，现在有更多关于在 Windows 上运行 kubectl 的文档。此帖子将这些内容与实际经验相结合，以提供全面的指导。您可以根据组织的特定设置进行调整。
| 术语 | 说明 |
|---|---|
| kubectl | 用于对 Kubernetes 集群运行命令的 CLI |
| context | 一个友好名称下的访问参数组（集群、用户、命名空间） |
| kubeconfig | 包含 kubectl 用于身份验证的上下文的配置文件 |
| 代理 | 一个公司拥有的服务器，用于过滤和控制外部互联网访问 |
- 无需手动编辑 kubeconfig 文件
- 跨环境统一 kubectl 工作流
- 简化开发人员入职
- 每个集群和命名空间的自定义上下文
- Windows 10
- PowerShell v5.2+
- 互联网访问权限，用于下载 kubectl.exe
初始设置只需执行一次：
- 为 kubectl 二进制文件创建一个文件夹：
New-Item -ItemType directory -Path "C:\k"
- 将文件夹添加到您的 $PATH：
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\k", "User")
注意：更改在新 PowerShell 会话中生效
-
下载 kubectl.exe（版本应与您的集群匹配）并将其放在 C:\k 中
-
验证 kubectl 是否正常工作：
kubectl version --client
如果您的公司使用代理服务器，您可能需要配置 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY 环境变量，以便 kubectl 连接到您的集群。
代理旨在成为一种在大型环境中规范和保护出站流量的方法。正确配置您的 kubectl / PowerShell 基于两个重要参数：
- 用于 NO_PROXY 的内部 Kubernetes 集群 HTTPS API
- 用于 HTTP_PROXY 和 HTTPS_PROXY 的公司代理 URL:PORT
| 变量 | 说明 | 示例 |
|---|---|---|
| NO_PROXY | 应绕过代理的 IP/域（以逗号分隔） | "corp.com,10.0.0.0/8" |
| HTTP_PROXY | 用于 HTTP 流量的代理服务器 URL | "http://proxy.corp.com:80" |
| HTTPS_PROXY | 用于 HTTPS 流量的代理服务器 URL | "http://proxy.corp.com:443" |
我不应在何时设置 NO_PROXY？
- 如果您的集群是外部（公共）集群
我应在何时设置 NO_PROXY？
- 如果您的集群是内部（私有）集群
要在通过代理发送外部流量的同时直接路由所有内部 IP：
[Environment]::SetEnvironmentVariable("HTTP_PROXY", "http://proxy.corp.com:80", "User")
[Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://proxy.corp.com:443", "User")
[Environment]::SetEnvironmentVariable("NO_PROXY", "localhost,127.0.0.1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16", "User")
重新启动 PowerShell 以使更改生效
- 从您的管理员那里获取集群 API 服务器 URL 和身份验证详细信息
- 创建集群上下文：
kubectl config set-cluster mycluster --server=https://k8sapi.corp.com:6443 --certificate-authority=./ca.crt --embed-certs
- 为上下文设置凭据：
kubectl config set-credentials mycluster-admin --token="<bearer token here>"
- 创建一个将集群和用户联系在一起的上下文：
kubectl config set-context mycluster --cluster=mycluster --user=mycluster-admin
- 开始使用新上下文：
kubectl config use-context mycluster
# Show current context
kubectl config current-context
# Switch contexts
kubectl config use-context mycluster
# List available contexts
kubectl config get-contexts
# Set default namespace for a context
kubectl config set-context --current --namespace=dev
# Rename a context
kubectl config rename-context old-name new-name
# Delete a context
kubectl config delete-context mycluster
- 下载新的 kubectl.exe 二进制文件
- 替换 kubectl 目录中现有的文件（例如 C:\k）
缓慢通常是由 kubectl 使用网络驱动器作为缓存造成的。通过覆盖 $HOME 来修复：
[Environment]::SetEnvironmentVariable("HOME", $env:USERPROFILE, "User")警告：这将重置您的 kubectl 配置位置并删除现有配置
[Environment]::SetEnvironmentVariable("HTTP_PROXY", $null, "Machine")
[Environment]::SetEnvironmentVariable("HTTPS_PROXY", $null, "Machine")
[Environment]::SetEnvironmentVariable("NO_PROXY", $null, "Machine")- 使用
k别名而不是kubectl，方法是将二进制文件重命名为k.exe - 使用命令备份 kubeconfig：
$env:KUBECONFIG_SAVE=$env:KUBECONFIG - 使用命令还原 kubeconfig：
$env:KUBECONFIG=$env:KUBECONFIG_SAVE
通过此配置，您将在 Windows 上拥有一个健壮的 kubectl 设置，该设置可与公司代理和多个 Kubernetes 集群无缝协作。关键是利用上下文来组织对集群和命名空间的访问。将其与 PowerShell 环境变量结合使用以进行动态配置。