Skip to main content
版本：Next

添加节点

本文档介绍了将节点加入 OpenYurt 集群的操作流程。根据节点的初始状态，有两种方法：

1. 从零加入新节点​

此方法适用于尚未加入任何 Kubernetes 集群的节点。yurtadm join 命令通过安装必要的组件并将节点连接到 OpenYurt 集群来简化此过程。

前置条件​

在加入节点之前，请确保节点满足以下条件：

  • 已安装并运行容器运行时（如 containerd 或 Docker）。
  • 已关闭 Swap 分区。
  • 节点具有到 Kubernetes API Server 的网络连通性。

1.1 使用 yurtadm join​

yurtadm join 命令负责安装 kubeadm、kubelet 和 kube-proxy，然后将节点加入集群。

加入边缘节点：

  • 可从 OpenYurt Releases 页面下载 yurtadm 二进制文件。
  • 如何编译 yurtadm 二进制文件，请参阅此处。
yurtadm join <apiserver-address>:6443 --token=<apiserver-token> --node-type=edge --discovery-token-unsafe-skip-ca-verification --v=5

如果边缘节点使用 containerd 作为容器运行时，则必须指定 --cri-socket 参数：

yurtadm join <apiserver-address>:6443 --token=<token> --node-type=edge --discovery-token-unsafe-skip-ca-verification --cri-socket=/run/containerd/containerd.sock --v=5

加入云节点：

yurtadm join <apiserver-address>:6443 --token=<token> --node-type=cloud --discovery-token-unsafe-skip-ca-verification --v=5

参数说明：

  • <apiserver-address>:6443：API Server 的地址。
  • --token：用于向集群进行身份验证的 Bootstrap Token。有关如何生成 Token，请参阅 Kubernetes 文档。
  • --node-type：OpenYurt 节点类型，可选值为 cloud 或 edge。

1.2 组件和 CNI 处理​

yurtadm join 会自动处理组件安装。

  • Kubernetes 组件：它会安装 kubelet、kubeadm 等。你可以提前将特定版本的二进制文件放入 $PATH 中，但 yurtadm 会验证它们的主版本和次版本是否与集群的 Kubernetes 版本匹配。
  • CNI 二进制文件：加入过程会拉取经过特殊修改的 CNI 二进制文件（例如适用于 Flannel 的版本），以适应边缘环境。如果你已准备好自己的 CNI 二进制文件，请将其放置在 /opt/cni/bin 下，并在执行 yurtadm join 命令时使用 --reuse-cni-bin=true 参数。