在Kubernetes上安装

本教程展示了如何手动部署 OpenYurt 集群。我们假设用户已经安装好一个 Kubernetes 集群。

1 Kubernetes 集群环境

用户需要先自行准备好一个 Kubernetes 集群(可以通过kubeadm工具搭建),本文档中以 1 节点的 Kubernetes 为例。

  1. $ kubectl get nodes
  2. NAME STATUS ROLES AGE VERSION
  3. izwz9dohcv74iegqecp4axz Ready control-plane,master 6d1h v1.22.11

2 OpenYurt 安装前置条件

  1. 如果 Raven 开启节点转发模式,需要保证集群中所有节点 IP 不冲突。
  2. 如果采用 Docker 作为容器运行时则需要做以下调整,避免 Docker 修改 iptables FORWARD 链默认规则为 DROP,从而导致 Raven Gateway 节点流量转发失败:
  1. iptables -w -P FORWARD ACCEPT
  2. sed -i 's#^After=network-online.target firewalld.service$#After=network-online.target firewalld.service containerd.service#g' \
  3. /lib/systemd/system/docker.service
  1. 通过 Raven 提供的 VPN 隧道,边缘节点 pods 的域名解析将由主节点或云节点上的 CoreDNS 实例进行处理,因此可能引发解析延迟或者超时失败。如果您在意解析延迟或者超时失败,我们建议您根据CoreDNS 调整教程调整“CoreDNS 部署”。
  2. 为了适应边缘复杂的网络条件,我们需要关闭 k8s 原生的节点生命周期管理控制器,具体操作参考Kube-Controller-Manager 安装相关配置调整
  3. 我们建议通过Helm来安装 OpenYurt 组件,在进行安装之前,请确保helm CLI已经正确安装。

3 部署 OpenYurt 的控制面组件

接下来要用到的所有 helm charts 都可以在openyurt-helm 仓库中找到。请按照以下方式添加仓库:

  1. helm repo add openyurt https://openyurtio.github.io/openyurt-helm

您可以运行 helm search repo openyurt 来查看这些 helm charts,并且我们建议使用最新版本.

3.1 安装 yurt-manager

yurt-manager 应该在通过 yurtadm 命令加入节点之前启动,因为节点上的 yurthub 组件依赖于 yurt-manager 来批准 csr。所以请确保 yurt-manager 组件在主节点或任何其他没有 yurthub 组件的节点上运行。

  1. helm upgrade --install yurt-manager -n kube-system openyurt/yurt-manager

确保 yurt-manager 组件的 pod 和服务配置已被成功创建:

  1. kubectl get pod -n kube-system | grep yurt-manager
  2. kubectl get svc -n kube-system | grep yurt-manager

3.2 安装 yurthub 相关配置

yurthub 相关配置包括 yurtstaticset 模板,以及 yurthub 相关的 ConfigMap 和 ClusterRole。同时在安装 yurthub 配置时,我们需要将kubernetesServerAddr字段设置为 Kubernetes 服务器地址(使用kubectl config view来查找)。 以 Kubernetes 服务器地址https://1.2.3.4:6443为例。

  1. helm upgrade --install yurt-hub -n kube-system --set kubernetesServerAddr=https://1.2.3.4:6443 openyurt/yurthub

确保 yurthub yurtstaticset 和 yurthub cloud yurtstaticset 已经成功创建:

  1. kubectl get yss -n kube-system

3.3 安装跨网络域通信组件 Raven

Raven提供了云、边位于不同网络区域的网络通信能力, 可通过 Helm 安装:

  1. helm upgrade --install raven-agent -n kube-system openyurt/raven-agent

确认 Raven-Agent 组件的 pod 和 service 配置已经成功创建:

  1. kubectl get pod -n kube-system | grep raven-agent

如果您需要开启raven七层代理能力,需要参考Raven七层代理调整对集群进行配置

4. 注意

以上操作仅针对 Master 节点,如果集群中还有其他节点,还需要额外调整,操作方法可以参考: 在存量的 K8s 节点上安装 OpenYurt Node 组件