yurt-hub

更新时间:
复制为 MD 格式

yurt-hub是为ACK集群混合云节点池提供自治能力的节点组件。本文为您介绍yurt-hub组件,以及使用说明和相关内容的最新动态。

组件介绍

yurt-hub作为节点维度的流量代理,专为云边网络不稳定场景提供可用性与体验。

该组件的主要作用如下:

  • 提供数据缓存能力。当节点到云端API Server的链路不可用时,您的业务Pod和系统组件即使发生重启,也可以从yurt-hub的本地缓存读取关键资源数据,避免因“拿不到配置/状态”导致启动失败或长时间不可用。

  • 避免因访问API Server中断引发的连锁反应(驱逐/重启风暴)。在专线中断或不稳定时,yurt-hub作为节点本地代理承接访问请求,减少因 apiserver 不可达带来的超时与错误,降低节点上 Pod 被异常影响、频繁重启等风险,让边缘侧更“抗断连”。

  • 支持API Server访问链路自适应。集群内使用InClusterConfig的应用/组件,访问API Server时会自动经由yurt-hub代理转发,实现链路自适应;无需为网络不稳定场景专门改造应用。

  • 支持系统组件的镜像仓库自动适配,在专线或公网连接场景下,系统组件会自动切换为使用私网镜像或公网镜像。

image

使用说明

  • 仅支持 1.33 及以上版本的 ACK 托管集群使用,且仅支持混合云节点池部署使用。

  • 使用该组件前,需提前安装控制面组件yurt-hub-controlplane

  • yurt-hub安装说明:

    1. 在阿里云OpenAPI门户中调用OpenAPI InstallNodePoolComponents,填入需要安装yurt-hub的集群ID与混合云节点池ID,然后在组件名称中填入yurt-hub,组件版本选择0.15.0。可通过config.customConfig配置参数,当前支持配置"cacheAgents": {User-Agent} 以开启数据缓存能力,示例配置如下,其中 User-Agent通常是业务容器的启动命令。

      apiVersion: v1
      kind: Pod
      metadata:
        name: hybrid-app-pod
      spec:
        containers:
          - name: "hybrid-app"
            image: "xxx/hybrid-app-amd64:1.18.8"
            command:
              - /bin/sh
              - -ec
              - |
                # User-Agent 即为启动命令: hybrid-app。
                /usr/local/bin/hybrid-app --v=2

变更记录

2026 年 01 月

版本号

镜像地址

变更内容

变更时间

变更影响

v0.15.0

registry.cn-hangzhou.aliyuncs.com/acs/yurt-hub:v0.15.0

ACK 集群混合云节点池的首个 yurt-hub 版本。

2026 年 01 月 13 日

此次升级不会对业务造成影响。