9.5 KiB
| title | content_type | weight | card | ||||||
|---|---|---|---|---|---|---|---|---|---|
| 在 Windows 上安装 kubectl | task | 10 |
|
{{% heading "prerequisites" %}}
kubectl 版本和集群版本之间的差异必须在一个小版本号内。 例如：v{{< skew currentVersion >}} 版本的客户端能与 v{{< skew currentVersionAddMinor -1 >}}、 v{{< skew currentVersionAddMinor 0 >}} 和 v{{< skew currentVersionAddMinor 1 >}} 版本的控制面通信。 用最新兼容版的 kubectl 有助于避免不可预见的问题。
在 Windows 上安装 kubectl
在 Windows 系统中安装 kubectl 有如下几种方法：
用 curl 在 Windows 上安装 kubectl
-
下载 [最新发行版 {{< param "fullversion" >}}](https://dl.k8s.io/release/{{< param "fullversion" >}}/bin/windows/amd64/kubectl.exe)。
如果你已安装了
curl,也可以使用此命令：curl -LO "https://dl.k8s.io/release/{{< param "fullversion" >}}/bin/windows/amd64/kubectl.exe"{{< note >}} 要想找到最新稳定的版本（例如：为了编写脚本），可以看看这里 https://dl.k8s.io/release/stable.txt。 {{< /note >}}
- 验证该可执行文件（可选步骤）
下载
kubectl校验和文件：curl -LO "https://dl.k8s.io/{{< param "fullversion" >}}/bin/windows/amd64/kubectl.exe.sha256"基于校验和文件，验证
kubectl的可执行文件：- 在命令行环境中，手工对比
CertUtil命令的输出与校验和文件：
CertUtil -hashfile kubectl.exe SHA256 type kubectl.exe.sha256- 用 PowerShell 自动验证，用运算符
-eq来直接取得True或False的结果：
$($(CertUtil -hashfile .\kubectl.exe SHA256)[1] -replace " ", "") -eq $(type .\kubectl.exe.sha256)- 将
kubectl二进制文件夹追加或插入到你的PATH环境变量中。
-
测试一下，确保此
kubectl的版本和期望版本一致：kubectl version --client或者使用下面命令来查看版本的详细信息：
kubectl version --client --output=yaml
{{< note >}}
Windows 版的 Docker Desktop
将其自带版本的 kubectl 添加到 PATH。
如果你之前安装过 Docker Desktop，可能需要把此 PATH 条目置于 Docker Desktop 安装的条目之前，
或者直接删掉 Docker Desktop 的 kubectl。
{{< /note >}}
在 Windows 上用 Chocolatey 或 Scoop 安装
-
要在 Windows 上安装 kubectl，你可以使用包管理器 Chocolatey 或是命令行安装器 Scoop。
{{< tabs name="kubectl_win_install" >}} {{% tab name="choco" %}}
choco install kubernetes-cli{{% /tab %}} {{% tab name="scoop" %}}
scoop install kubectl{{% /tab %}} {{< /tabs >}}
- 测试一下，确保安装的是最新版本：
kubectl version --client- 导航到你的 home 目录：
# 当你用 cmd.exe 时，则运行： cd %USERPROFILE% cd ~- 创建目录
.kube：
mkdir .kube- 切换到新创建的目录
.kube
cd .kube- 配置 kubectl，以接入远程的 Kubernetes 集群：
New-Item config -type file
{{< note >}} 编辑配置文件，你需要先选择一个文本编辑器，比如 Notepad。 {{< /note >}}
验证 kubectl 配置
{{< include "included/verify-kubectl.md" >}}
kubectl 可选配置和插件
启用 shell 自动补全功能
kubectl 为 Bash、Zsh、Fish 和 PowerShell 提供自动补全功能，可以为你节省大量的输入。
下面是设置 PowerShell 自动补全功能的操作步骤。
{{< include "included/optional-kubectl-configs-pwsh.md" >}}
安装 kubectl convert 插件
{{< include "included/kubectl-convert-overview.md" >}}
-
用以下命令下载最新发行版：
curl -LO "https://dl.k8s.io/release/{{< param "fullversion" >}}/bin/windows/amd64/kubectl-convert.exe"
-
验证该可执行文件（可选步骤）
下载
kubectl-convert校验和文件：curl -LO "https://dl.k8s.io/{{< param "fullversion" >}}/bin/windows/amd64/kubectl-convert.exe.sha256"基于校验和，验证
kubectl-convert的可执行文件：-
用提示的命令对
CertUtil的输出和下载的校验和文件进行手动比较。CertUtil -hashfile kubectl-convert.exe SHA256 type kubectl-convert.exe.sha256
- 使用 PowerShell
-eq操作使验证自动化，获得True或者False的结果：
$($(CertUtil -hashfile .\kubectl-convert.exe SHA256)[1] -replace " ", "") -eq $(type .\kubectl-convert.exe.sha256) -
-
将
kubectl-convert二进制文件夹附加或添加到你的PATH环境变量中。 -
验证插件是否安装成功
kubectl convert --help如果你没有看到任何错误就代表插件安装成功了。
{{% heading "whatsnext" %}}
{{< include "included/kubectl-whats-next.md" >}}