Windows 中 kubectl 配置详细指南

忘是亡心i 2024-02-19 12:01 108阅读 0赞

**目录**

前言

什么是 Chocolatey与Minikube

Chocolatey

Minikube

安装 Minikube

安装 Chocolatey（如果尚未安装）

Minikube

遇到的问题

通过获取集群状态的方法

kubectl 可选配置和插件

启用 shell 自动补全功能

安装 kubectl convert 插件

--------------------

### 前言 ###

如果你想在自己的笔记本上（本地）运行 Kubernetes 集群，你需要先安装一个 Minikube 这样的工具，然后再重新运行上面的命令。

### 什么是 Chocolatey与Minikube ###

#### Chocolatey ####

**包管理工具**：Chocolatey 是一个 Windows 上的包管理工具，它允许用户轻松地安装、更新和卸载各种软件包，类似于 Linux 上的包管理工具（如apt、yum等）。

**自动化软件安装**：Chocolatey 允许用户使用命令行或脚本自动化软件的安装和配置。

**软件包仓库**：Chocolatey 提供了一个中央仓库，其中包含数千个可用的软件包，涵盖了各种开源和商业应用程序。

**社区支持**：Chocolatey 社区积极维护和更新软件包，因此用户可以轻松获取最新的软件版本。

#### Minikube ####

**本地 Kubernetes 环境**：Minikube 是一个工具，用于在开发者的本地计算机上创建和管理一个小型的 Kubernetes 集群。这允许开发者在本地测试和开发容器化的应用程序，而无需连接到远程集群。

**容器化开发**：Minikube 允许开发者轻松地在本地运行和测试 Kubernetes 部署，以确保应用程序在生产环境中的行为。

**Kubernetes 版本管理**：Minikube 支持多个 Kubernetes 版本，开发者可以选择要在其本地集群中使用的版本。

**插件系统**：Minikube 提供了插件系统，允许扩展其功能以满足特定需求。

### 安装 Minikube ###

#### 安装 Chocolatey（如果尚未安装） ####

打开一个**管理员权限**的 PowerShell 或命令提示符窗口，然后运行以下命令以安装 Chocolatey：

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

这将安装 Chocolatey 包管理工具。

#### Minikube ####

**安装 Minikube**，一旦 Chocolatey 安装完成，你可以使用以下 Chocolatey 命令来安装 Minikube：

choco install minikube

Chocolatey 将自动下载并安装 Minikube。

![cf57f0a4f33bb096440cb33c8bf7a59b.png][]

**启动 Minikube**，安装完成后，你可以使用以下命令启动 Minikube 集群：

minikube start

Minikube 将在本地虚拟机中启动一个Kubernetes集群。第一次启动可能需要一些时间，因为它需要下载Kubernetes二进制文件和基本映像。

**检查 Minikube 是否在运行**

minikube status

确保 Minikube 的状态是 "Running"。

如果不是，请尝试重新启动它：

minikube stop

**验证 Minikube**：一旦Minikube启动完成，你可以运行以下命令来验证它：

kubectl get nodes

应该显示一个节点，表示Minikube集群正常运行。

![a493c9b78350b5137969a8ef32c09279.png][]

#### 遇到的问题 ####

**Hyper-V PowerShell 模块不可用：****minikube** 尝试使用 Hyper-V 驱动程序，但由于缺少 Hyper-V PowerShell 模块，无法创建虚拟机。错误消息建议你运行以下命令启用 Hyper-V PowerShell 模块：

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-Tools-All -All

运行此命令并确保 Hyper-V PowerShell 模块已成功启用后，尝试重新运行 **minikube start**。

### 通过获取集群状态的方法 ###

检查是否已恰当地配置了 kubectl：

kubectl cluster-info

如果返回一个 URL，则意味着 kubectl 成功地访问到了你的集群。

如果命令 kubectl cluster-info 返回了 URL，但你还不能访问集群，那可以用以下命令来检查配置是否妥当：

kubectl cluster-info dump

### kubectl 可选配置和插件 ###

#### 启用 shell 自动补全功能 ####

kubectl 为 Bash、Zsh、Fish 和 PowerShell 提供自动补全功能，可以为你节省大量的输入。

下面是设置 PowerShell 自动补全功能的操作步骤。

你可以使用命令 kubectl completion powershell 生成 PowerShell 的 kubectl 自动补全脚本。

如果需要自动补全在所有 Shell 会话中生效，请将以下命令添加到 $PROFILE 文件中：

kubectl completion powershell | Out-String | Invoke-Expression

此命令将在每次 PowerShell 启动时重新生成自动补全脚本。你还可以将生成的自动补全脚本添加到 $PROFILE 文件中。

如果需要将自动补全脚本直接添加到 $PROFILE 文件中，请在 PowerShell 命令行运行以下命令：

kubectl completion powershell >> $PROFILE

完成上述操作后重启 Shell，kubectl 的自动补全就可以工作了。

### 安装 kubectl convert 插件 ###

一个 Kubernetes 命令行工具 kubectl 的插件，允许你将清单在不同 API 版本间转换。 这对于将清单迁移到新的 Kubernetes 发行版上未被废弃的 API 版本时尤其有帮助。 更多信息请访问[迁移到非弃用 API][API]

用以下命令下载最新发行版：

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

验证该可执行文件（可选步骤）。下载 kubectl-convert 校验和文件：

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

基于校验和验证 kubectl-convert 的可执行文件：

用提示的命令对 CertUtil 的输出和下载的校验和文件进行手动比较。

使用 PowerShell -eq 操作使验证自动化，获得 True 或者 False 的结果：

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

$($(CertUtil -hashfile .\kubectl-convert.exe SHA256)[1] -replace " ", "") -eq $(type .\kubectl-convert.exe.sha256)

将 kubectl-convert 二进制文件夹附加或添加到你的 PATH 环境变量中。

验证插件是否安装成功。

kubectl convert --help

如果你没有看到任何错误就代表插件安装成功了。

安装插件后，清理安装文件：

del kubectl-convert.exe kubectl-convert.exe.sha256

[cf57f0a4f33bb096440cb33c8bf7a59b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/e4f5f15ca261459d8ad294747987389d.png
[a493c9b78350b5137969a8ef32c09279.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/b39f16d792e24445bc270cf516984194.png
[API]: https://kubernetes.io/zh-cn/docs/reference/using-api/deprecation-guide/#migrate-to-non-deprecated-apis