-
v0.3.0-rc.0
Pre-Releasereleased this
2026-11-03 09:39:21 +00:00 | 169 commits to main since this releasev0.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)
- agent 读取本机 HAProxy 的状态,决定是否宣告某个 VIP,并在
- 可选:同时设置
--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)
- Data Plane API 客户端证书,由
- 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,versionv0.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
- 新增