本节介绍如何使用 OpenYurt 边缘运行时添加边缘节点。

前提条件

您需要加入一个边缘集群并在集群中具有节点管理权限。有关更多信息，请参阅“边缘集群角色”和“边缘集群成员”。

准备工作

执行节点配置命令前，需要在边缘节点上安装必要的系统软件包。

  1. 安装依赖项。若边缘节点使用的是 Ubuntu 操作系统，执行以下命令为边缘节点安装依赖项：

    sudo apt-get update
sudo apt install wireguard wireguard-tools socat conntrack -y

    若边缘节点使用其他操作系统，请将 apt 替换为操作系统对应的软件包管理工具。

  2. 安装 docker 20.10

    curl -fsSL https://get.docker.com -o install-docker.sh && sh install-docker.sh --version 20.10

  3. 修改 cgroupdriver

    cat > /etc/docker/daemon.json <<EOF
{
 "exec-opts": ["native.cgroupdriver=systemd"]
}
EOF

  4. 重启 docker

    service docker restart

  5. 启用 IP 转发。

    cat <<EOF | sudo tee /etc/sysctl.d/k8s.conf
net.ipv4.ip_forward                 = 1
EOF
sysctl --system

添加边缘节点

  1. 以具有节点管理权限的用户登录 KubeSphere 企业版 Web 控制台并进入您的边缘集群。

  2. 在左侧导航栏选择边缘节点 > 节点管理。

  3. 在页面右侧点击添加。

  4. 在添加边缘节点对话框，设置边缘节点的参数。

    参数 描述

    容器运行时

    选择当前集群的容器运行时：Docker 或 Containerd

    镜像仓库地址

    使用默认镜像地址时，无需输入。若要使用非默认的镜像地址，请参阅配置镜像地址。

    名称

    边缘节点的名称。系统会自动为边缘节点生成名称，您也可以手动设置边缘节点的名称。

    添加默认污点

    是否为边缘节点添加污点以阻止容器组调度到边缘节点上。

  5. 点击验证生成边缘节点配置命令。

    • 若该边缘集群为物理集群，yurtadm join 为该物理集群的 IP 地址或者可以直接访问的域名。

      physical cluster add node

    • 若该边缘集群为虚拟集群，yurtadm join 为边缘集群名+部署集群时设置的域名（如：openyurt2.edgewize.io）。在边缘节点上需要修改 hosts 或者 DNS 使其能够解析到 host 集群的 IP 地址上。

      vcluster add node

      vi /etc/hosts
      <host-node-ip> openyurt2.edgewize.io

  6. 登录边缘节点并执行上一步生成的命令。

  7. 刷新 KubeSphere 企业版 Web 控制台的边缘节点页面。如果添加成功，边缘节点将显示在边缘节点列表。

配置镜像地址

使用 OpenYurt 添加节点时，若要使用非默认的镜像仓库地址，需将配置字典 yurt-static-set-yurt-hub 中的镜像地址改为变量，这时在添加边缘节点对话框中配置的镜像地址才能生效。

  1. 进入将使用 OpenYurt 添加节点的边缘集群页面。

  2. 在左侧导航栏选择配置 > 配置字典。

  3. 搜索 yurt-static-set-yurt-hub，点击进入详情页面。

  4. 点击更多操作 > 编辑 YAML。

  5. 修改 image 配置如下，点击确定。

    change image

  6. 在添加边缘节点对话框中输入实际的镜像地址，点击验证生成新的边缘节点配置命令。

    openyurt change image

重置边缘节点

重置节点将清除边缘节点上因执行节点配置命令而创建的资源。

./yurtadm reset -f