Kubernetes(k8s)手册 Kubernetes 添加Windows节点

2024-02-25 开发教程 Kubernetes(k8s)手册匿名 4℃

添加 Windows 节点

FEATURE STATE: Kubernetes v1.18 [beta]

你可以使用 Kubernetes 来混合运行 Linux 和 Windows 节点，这样你就可以混合使用运行于 Linux 上的 Pod 和运行于 Windows 上的 Pod。本页面展示如何将 Windows 节点注册到你的集群。

在开始之前

您的 Kubernetes 服务器的版本必须为 1.17 或更高版本。要检查版本，请输入 kubectl version。

获取 Windows Server 2019 或更高版本的授权以便配置托管 Windows 容器的 Windows 节点。如果你在使用 VXLAN/覆盖（Overlay）联网设施，则你还必须安装 KB4489899。
一个利用 kubeadm 创建的基于 Linux 的 Kubernetes 集群；你能访问该集群的控制面。

目标

将一个 Windows 节点注册到集群上
配置网络，以便 Linux 和 Windows 上的 Pod 和 Service 之间能够相互通信。

开始行动：向你的集群添加一个 Windows 节点

联网配置

一旦你有了一个基于 Linux 的 Kubernetes 控制面节点，你就可以为其选择联网方案。出于简单考虑，本指南展示如何使用 VXLAN 模式的 Flannel。

配置 Flannel

为 Flannel 准备 Kubernetes 的控制面

在我们的集群中，建议对 Kubernetes 的控制面进行少许准备处理。建议在使用 Flannel 时为 iptables 链启用桥接方式的 IPv4 流处理，必须在所有 Linux 节点上执行如下命令：

sudo sysctl net.bridge.bridge-nf-call-iptables=1

下载并配置 Linux 版本的 Flannel

下载最新的 Flannel 清单文件：

wget https://raw.githubusercontent.com/coreos/flannel/master/Documentation/kube-flannel.yml

修改 Flannel 清单中的 net-conf.json 部分，将 VNI 设置为 4096，并将 Port 设置为 4789。结果看起来像下面这样：

net-conf.json: |
    {
      "Network": "10.244.0.0/16",
      "Backend": {
         "Type": "vxlan",
         "VNI": 4096,
         "Port": 4789
    }
}

Note: 在 Linux 节点上 VNI 必须设置为 4096，端口必须设置为 4789，这样才能令其与 Windows 上的 Flannel 互操作。关于这些字段的详细说明，请参见 VXLAN 文档。

Note: 如要使用 L2Bridge/Host-gateway 模式，则可将 Type 值设置为 "host-gw"，并忽略 VNI 和 Port 的设置。

应用 Flannel 清单并验证

首先应用 Flannel 配置：

kubectl apply -f kube-flannel.yml

几分钟之后，如果 Flannel Pod 网络被正确部署，你应该会看到所有 Pods 都处于运行中状态。

kubectl get pods -n kube-system

输出中应该包含处于运行中状态的 Linux Flannel DaemonSet：

NAMESPACE     NAME                                      READY        STATUS    RESTARTS   AGE
...
kube-system   kube-flannel-ds-54954                     1/1          Running   0          1m

添加 Windows Flannel 和 kube-proxy DaemonSet

现在你可以添加 Windows 兼容版本的 Flannel 和 kube-proxy。为了确保你能获得兼容版本的 kube-proxy，你需要替换镜像中的标签。下面的例子中展示的是针对 Kubernetes v1.24.0 版本的用法，不过你应该根据你自己的集群部署调整其中的版本号。

curl -L https://github.com/kubernetes-sigs/sig-windows-tools/releases/latest/download/kube-proxy.yml | sed 's/VERSION/v1.24.0/g' | kubectl apply -f -
kubectl apply -f https://github.com/kubernetes-sigs/sig-windows-tools/releases/latest/download/flannel-overlay.yml

Note: 如果你在使用 host-gateway 模式，则应该使用 https://github.com/kubernetes-sigs/sig-windows-tools/releases/latest/download/flannel-host-gw.yml这一清单。

Note:
如果你在 Windows 节点上使用的不是以太网（即，"Ethernet0 2"）接口，你需要修改 flannel-host-gw.yml 或 flannel-overlay.yml 文件中的下面这行：

wins cli process run --path /k/flannel/setup.exe --args "--mode=overlay --interface=Ethernet"

在其中根据情况设置要使用的网络接口。

# Example
curl -L https://github.com/kubernetes-sigs/sig-windows-tools/releases/latest/download/flannel-overlay.yml | sed 's/Ethernet/Ethernet0 2/g' | kubectl apply -f -

加入 Windows 工作节点

Note:
Windows 节的所有代码片段都需要在 PowerShell 环境中执行，并且要求在 Windows 工作节点上具有提升的权限（Administrator）。

CRI-containerD

安装 containerD

curl.exe -LO https://github.com/kubernetes-sigs/sig-windows-tools/releases/latest/download/Install-Containerd.ps1
.\Install-Containerd.ps1

Note:
要安装特定版本的 containerD，使用参数 -ContainerDVersion 指定版本。

# Example
.\Install-Containerd.ps1 -ContainerDVersion 1.4.1

如果你在 Windows 节点上使用了与 Ethernet 不同的接口（例如 "Ethernet0 2"），使用参数 -netAdapterName 指定名称。

# Example
.\Install-Containerd.ps1 -netAdapterName "Ethernet0 2"

安装 wins、kubelet 和 kubeadm

curl.exe -LO https://raw.githubusercontent.com/kubernetes-sigs/sig-windows-tools/master/kubeadm/scripts/PrepareNode.ps1
.\PrepareNode.ps1 -KubernetesVersion v1.24.0 -ContainerRuntime containerD

从 cri-tools 项目安装 crtctl。 crictl 是必需的，kubeadm 使用它与 CRI 端点通信。

运行 kubeadm 添加节点

使用当你在控制面主机上运行 kubeadm init 时得到的命令。如果你找不到这个命令，或者命令中对应的令牌已经过期，你可以（在一个控制面主机上）运行 kubeadm token create --print-join-command 来生成新的令牌和 join 命令。

Docker Engine

安装 Docker Engine

安装 Containers 功能特性

Install-WindowsFeature -Name containers

安装 Docker

操作指南在 Install Docker Engine - Enterprise on Windows Servers。

安装 cri-dockerd。kubelet 可以通过 cri-dockerd 在 CRI 兼容的节点上与 Docker 通信。

Note:
Docker Engine 没有实现 CRI，而 CRI 是容器运行时能够与 Kubernetes 一起工作的要求。出于这个原因，必须安装一个额外的服务 cri-dockerd。 cri-dockerd 是一个基于原来的内置 Docker Engine 支持的项目，而这一支持在 1.24 版本的 kubelet 中已被移除。

从 cri-tools 项目安装 crictl。 kubeadm 需要 crictl 才能与 CRI 端点通信。

安装 wins、kubelet 和 kubeadm

curl.exe -LO https://raw.githubusercontent.com/kubernetes-sigs/sig-windows-tools/master/kubeadm/scripts/PrepareNode.ps1
.\PrepareNode.ps1 -KubernetesVersion v1.24.0

运行 kubeadm 添加节点

当你在控制面主机上运行 kubeadm init 时，输出了一个命令。现在运行这个命令。如果你找不到这个命令，或者命令中对应的令牌已经过期，你可以（在一个控制面主机上）运行 kubeadm token create --print-join-command 来生成新的令牌和 join 命令。

检查你的安装

你现在应该能够通过运行下面的命令来查看集群中的 Windows 节点了：

kubectl get nodes -o wide

如果你的新节点处于 NotReady 状态，很可能的原因是系统仍在下载 Flannel 镜像。你可以像之前一样，通过检查 kube-system 名字空间中的 Flannel Pods 来了解安装进度。

kubectl -n kube-system get pods -l app=flannel

一旦 Flannel Pod 运行起来，你的节点就应该能进入 Ready 状态并可用来处理负载。

上一节： Kubernetes 升级kubeadm集群

下一节： Kubernetes 升级Windows节点

"Kubernetes(k8s)手册"的目录

Kubernetes(k8s)手册 Kubernetes 添加Windows节点

添加 Windows 节点

在开始之前

目标

开始行动：向你的集群添加一个 Windows 节点

联网配置

配置 Flannel

加入 Windows 工作节点

安装 containerD

安装 wins、kubelet 和 kubeadm

运行 kubeadm 添加节点

安装 Docker Engine

安装 wins、kubelet 和 kubeadm

运行 kubeadm 添加节点

检查你的安装