• v0.3.0-rc.0
    Release / publish-lb-agent (push) Successful in 1m52s
    Release / publish-image (push) Successful in 6m24s
    Pre-Release

    panxiao81 released this 2026-11-03 09:39:21 +00:00 | 169 commits to main since this release

    v0.3.0-rc.0:LoadBalancer 进入 main(预发布)

    这是 LoadBalancer 的第一个候选版本,用于在 Dev 验证。部署 role 不配置 ayatori_loadbalancer 时,行为与 v0.2.0 相同。

    LoadBalancer(ADR-0012、0017、0018)

    • 新增 network.ayatori.ddupan.top/v1alpha1 的三种资源:
      • LoadBalancer:VIP 从地址池分配,复用内置的 IPAddress。
      • Backend:端点集合,包括 PROXY protocol、drainTimeout 和健康检查。端口通过 backendRef 引用它;引用的 Backend 不存在时,ResolvedRefs=False/BackendNotFound。
      • LoadBalancerHost:一台 LB 主机。它取代了 --loadbalancer-host 参数,并报告 AgentReady。(#39、#71、#73)
    • controller 按主机分别收敛配置:
      • 通过 HAProxy Data Plane API 收敛代理配置。
      • endpoint 变化通过 runtime API 生效,不 reload。
      • 移除的 endpoint 按 drainTimeout 排空。
      • Data Plane API 的客户端证书会热加载。(#42、#47、#52、#54、#66)
    • VIP 改由 LB 主机上的 lb-agent 宣告(进程内 GoBGP):
      • agent 读取本机 HAProxy 的状态,决定是否宣告某个 VIP,并在 GET /status 报告每个 VIP 宣告或不宣告的原因。
      • LoadBalancer 的 Attachment 以 agent 的报告为准。
      • manager 不再直接控制 BGP,gobgpd adapter 已移除。(#61、#69、#72)
    • 可选:同时设置 --loadbalancer-dns-url 和 --loadbalancer-dns-zone 后,controller 会在 Ayatori 独占的 PowerDNS zone 里维护 Hostname 的 A 记录。(#49)
    • 新增 Release 附件 lb-agent(linux/amd64),带 checksums。homelab-cookbooks v0.4.7 起,homelab_loadbalancer 会按 checksums 校验后安装它,并替换 gobgpd。

    部署 role

    • 新增可选变量 ayatori_loadbalancer: {address_pool, hosts: [{name, data_plane_url, agent_url}]},配置后启用 LoadBalancer:
      • role 根据 hosts 创建或更新 LoadBalancerHost;从 inventory 中删掉的主机,role 会删除对应对象。
      • Flux 同步 deploy/flux/loadbalancer。ESO 从 OpenBao 读取凭据并写入 ayatori-system/loadbalancer-credentials:
        • Data Plane API 客户端证书,由 pki-loadbalancer-<env> 签发;
        • 服务端 CA;
        • Basic 凭据,路径 kv/infra/loadbalancer/<env>。(#64)
    • SecretStore 的 OpenBao 地址改为由部署方注入(openbao_address),不再写死。(#58)
    • 镜像拉取改用 zot.lab.ddupan.top,CI 推送改用 zot-push.lab.ddupan.top。(#55、#56)

    其他

    • Go 1.27.2(#60)。CI 依赖全部走 Artifact Keeper 的内网缓存(#67)。
    • 集成测试改为先编译、再串行运行。API server、PostgreSQL、OpenBao、HAProxy、PowerDNS 都移到 go test 之外,并且只启动一次。只改 LB 代码时不再跑 Database 集成测试。(#74、#75)
    • 文档:
      • 新增 KaaS 计算后端 ADR-0014 至 0016 与 PoC 记录(#65)。
      • 消费方应读取应用凭据的最新版本,不再建议固定 credentialVersion(#57)。

    部署注意

    • 启用 LoadBalancer 之前,OpenBao 里要先有:
      • pki-loadbalancer-<env>,带 ayatori 角色;
      • kv/infra/loadbalancer/<env>;
      • ESO 角色读取以上两项的策略。
      • LB 主机要先用 homelab-cookbooks v0.4.7 收敛,agent.version 为 0.3.0-rc.0。
    • agent_url 是 agent 的 metricsAddress(默认端口 9641),manager 必须能访问到它。
    • 删除 LoadBalancerHost 是异步的:controller 先清掉该主机上的全部 LoadBalancer 配置,再放行删除。主机不可达时,对象会一直停在删除中。
    • 部署 role 目前不传 DNS 参数,所以通过 role 部署时不会维护 Hostname。

    制品

    • manager 镜像:zot.lab.ddupan.top/panxiao81/ayatori-manager@sha256:19497aedd35c6a42e74cf44bfdbccabbf53500af5c32fa1de2a56c6107a8ee0e
    • 部署 role:git+https://git.ddupan.top/panxiao81/ayatori.git#/deploy/ansible,version v0.3.0-rc.0
    • LB agent:ayatori-lb-agent_0.3.0-rc.0_linux_amd64.tar.gz(二进制 lb-agent),校验和见 ayatori_0.3.0-rc.0_checksums.txt
    Downloads