-
v0.4.0
Stablereleased this
2026-11-12 04:58:58 +00:00 | 25 commits to main since this releasev0.4.0:LB agent 可选开启 BGP graceful restart
- LB agent 新增配置项 gracefulRestartTime(ADR-0025),为零时关闭,行为与 v0.3.x 相同。
开启后:- SIGTERM(systemctl stop、restart 与关机)发出 NOTIFICATION,路由器立即撤回本机路径;
- SIGKILL、OOM、崩溃时路由器保留本机路径,直到 agent 重连并发出 End-of-RIB,或 restart time
到期; - 主机失联仍由 hold timer 决定。
启动时先按 HAProxy 现状填好本地 RIB,再连接邻居。
- 部署:homelab_loadbalancer 0.4.3 的 agent.graceful_restart_time。agent 严格解析配置,v0.3.x
的 agent 不认识该键,必须先升级 agent 或同时升级。设置后 Cinc 以 SIGKILL 重启 agent。 - 文档:ADR-0024(组件共用版本号,允许有限的版本偏差)、ADR-0025。
- 依赖:Go 1.27.4,pgx v5.13.0,oapi-codegen/runtime v1.9.0。
本版 LB agent 有改动。manager 与 CRD 相对 v0.3.1 不变,但按 ADR-0024 仍须先升级 manager,再升级 agent。
制品
- manager 镜像:
zot.lab.ddupan.top/panxiao81/ayatori-manager@sha256:8ec7f7b6deb62c7e26f95c881f0a3a7d34333fb79564fd23c1f51132d31409c9 - Flux 清单:本 tag 的
deploy/flux
Downloads
- LB agent 新增配置项 gracefulRestartTime(ADR-0025),为零时关闭,行为与 v0.3.x 相同。
-
v0.3.1
Stablereleased this
2026-11-09 16:27:39 +00:00 | 46 commits to main since this releasev0.3.1:PostgreSQLInstance 的 hostaddr 改为可选
- spec.endpoint.hostaddr 不再必填;未声明时连接按 host 解析,TLS 仍按 host 校验。
入口放在 Ayatori LoadBalancer 后时不必把 VIP 写进 Instance。 - 应用凭据未声明 hostaddr 时不写该键;去掉已声明的 hostaddr 时,凭据以同一密码改写。
- 依赖:golang.org/x/sys v0.50.0。
LB agent 相对 v0.3.0 没有代码改动,Dev/Prod 无需升级 agent。
制品
- manager 镜像:
zot.lab.ddupan.top/panxiao81/ayatori-manager@sha256:fa57838cda328b14e6e90f934b17db520d35ab539d20db5e6521369cdd2863b5 - Flux 清单:本 tag 的
deploy/flux
Downloads
- spec.endpoint.hostaddr 不再必填;未声明时连接按 host 解析,TLS 仍按 host 校验。
-
v0.3.0
Stablereleased this
2026-11-09 10:56:10 +00:00 | 53 commits to main since this releasev0.3.0:LB agent 加入控制面并在本机收敛(ADR-0022)
- LB agent 以 CSR 证书加入控制面,注册 LoadBalancerHost,以 Lease 作心跳,自己写 status。
- agent watch LoadBalancer 与 Backend,经本机 Data Plane API 收敛 HAProxy,按 digest 逐个上报。
- manager 增加 --loadbalancer-agent-convergence:只汇总各主机报告,删除 LoadBalancerHost 等待 Purged。
- status 呈现后端成员的健康检查结论(ADR-0023)。
- 控制面客户端证书以 CSR 签发与自行续签(ADR-0021);节点 agent 共用的身份与注册。
- 依赖:Kubernetes 0.37、controller-runtime 0.25,修复 Trivy 报告的已知漏洞(x/net、otel、go-jose)。
升级注意:LoadBalancerHost 的 spec.agentURL 已删除,需同时从 GitOps 清单中去掉;agent join 之前
LoadBalancer status 显示 AgentStale(只影响状态,不影响流量)。远程收敛仍保留,默认行为不变,
切换顺序见 ADR-0022。制品
- manager 镜像:
zot.lab.ddupan.top/panxiao81/ayatori-manager@sha256:2d68a8e50c33806aa3569fbba376ca96ad66201a4ff1e76e33b410eec8ad77a8 - Flux 清单:本 tag 的
deploy/flux
Downloads
-
v0.3.0-rc.3
Pre-Releasereleased this
2026-11-03 16:53:12 +00:00 | 149 commits to main since this releasev0.3.0-rc.3:控制面客户端证书以 CSR 签发与自行续签(预发布)
制品
- manager 镜像:
zot.lab.ddupan.top/panxiao81/ayatori-manager@sha256:931825920487c5d292e152163af3bb46cc95d3f52b418f40dbb1fe60eeb35053 - 部署 role:
git+https://git.ddupan.top/panxiao81/ayatori.git#/deploy/ansible,versionv0.3.0-rc.3
Downloads
- manager 镜像:
-
v0.3.0-rc.2
Pre-Releasereleased this
2026-11-03 16:11:35 +00:00 | 158 commits to main since this releasev0.3.0-rc.2:GitOps 可以声明 LoadBalancer(预发布)
ayatori_gitops同步的部署方目录现在可以声明 LoadBalancer 与 Backend;loadbalancerhosts仍由部署 role 按 inventory 登记。(#84)- manager 与 lb-agent 的代码相对 rc.1 没有变化。
制品
- manager 镜像:
zot.lab.ddupan.top/panxiao81/ayatori-manager@sha256:feb22b453d225d8624825ee68f210816b27c25b5c9f6655276fbde2e81aa15da - 部署 role:
git+https://git.ddupan.top/panxiao81/ayatori.git#/deploy/ansible,versionv0.3.0-rc.2
Downloads
-
v0.3.0-rc.1
Pre-Releasereleased this
2026-11-03 12:34:15 +00:00 | 162 commits to main since this releasev0.3.0-rc.1:LoadBalancer 可接入 PowerDNS(预发布)
-
部署 role 新增可选的
ayatori_loadbalancer.dns: {url, zone}。声明后,manager 会在 PowerDNS 中由 Ayatori 独占的 zone 里维护 LoadBalancer Hostname 对应的 A 记录。ESO 把 PowerDNS API key 写入凭据 Secret 的powerdns-api-key,key 的位置由loadbalancer_dns_api_key指定,默认是 Baokv/k8s/powerdns的api_key。(#82) -
发布:推送与拉取统一使用
zot.lab.ddupan.top(#79)。Release 正文不再包含 tag 的签名块,带-的 tag 会被标为 prerelease(#83)。 -
manager 与 lb-agent 的代码相对 rc.0 没有变化。
-
不声明
dns时,ESO 同样会读取 PowerDNS API key,所以 ESO 角色必须有这个 key 的读权限。 -
已部署 rc.0 的环境升级时,LB 凭据 Secret 会多出一个字段,manager 只有在声明了
dns后才会用到它。
制品
- manager 镜像:
zot.lab.ddupan.top/panxiao81/ayatori-manager@sha256:da2af9f41ba7634d7d1c3fd466ab086abc154c31a1f273c6097b22e7480ecc95 - 部署 role:
git+https://git.ddupan.top/panxiao81/ayatori.git#/deploy/ansible,versionv0.3.0-rc.1
Downloads
-
-
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
- 新增
-
released this
2026-10-09 10:50:38 +00:00 | 269 commits to main since this releasev0.2.0:凭据连接信息随 Instance 改写;k0s 日志降噪
-
凭据的身份是 database 与 loginRole;host、hostaddr、port、sslmode 是 Instance 的可变连接信息。Instance
spec.endpoint变化时,controller 以确认版本为 CAS 前提、用同一密码写入只更新连接信息的下一版本并回读核对,更新credentialVersion,Tenant status 公布新版本;database/loginRole 不一致仍为 Conflict。管理员显式声明凭据位置的导入资源同样受管:首次登记只读,登记后改写。CRD 中确认版本由"不可更改"改为"不可回退或移除"。(#50) -
k0s controller 增加
--logging=etcd=warn --verbose=false,控制面日志量从约 1.5 MiB/分钟降到几乎为零;k0s 安装参数变化时以k0s install controller --force重新生成 unit 并重启。(#48) -
CI:golangci-lint 改用上游二进制,结构化日志检查改用内置 loggercheck(#51);Database 集成测试按路径触发(#46)。
-
升级会重启一次 k0s(unit 参数变化),API 短暂不可用,manager、ESO、Flux 自动重连。
-
修改 Instance 连接信息(如迁到
pg-*.lab.ddupan.top)后,已有 Database 的凭据版本加一;固定credentialVersion的消费方(ExternalSecret)需改用新版本,旧版本中的密码仍有效。
制品
- manager 镜像:
zot.ad.ddupan.top/panxiao81/ayatori-manager@sha256:dae1d61d72dc37c28ff63da94cdc8950e508f5347e356009c11a0d7b7da3eba7 - 部署 role:
git+https://git.ddupan.top/panxiao81/ayatori.git#/deploy/ansible,versionv0.2.0
Downloads
-
-
released this
2026-10-05 17:57:06 +00:00 | 279 commits to main since this releasev0.1.4:证书到期指标与自动发布说明
-
部署 role 新增
ayatori-cert-metrics.timer(每小时,部署时立即运行):把/var/lib/k0s/pki下证书与各身份 kubeconfig 客户端证书的到期时间写入 node_exporter textfile(ayatori_certificate_not_after_timestamp_seconds,source=k0s-pki带path,source=kubeconfig带identity)。kubeconfig 客户端证书不会自动轮换,k0s 服务端证书只在重启时轮换。(#41、#43) -
Release 工作流在推送镜像后自动创建(同名重发时更新)Gitea Release,正文取自 annotated tag 说明。(#40)
-
manager 代码未变化。
-
证书到期告警规则在 homelab-infra
platform/observability/metrics/rules/ayatori.yaml(30 天 warning、7 天 critical),需在本版本部署后启用。 -
轮换:删除
/etc/ayatori-control-plane/<identity>/kubeconfig后重跑部署重签客户端证书;重启k0scontroller轮换 PKI 服务端证书。
制品
- manager 镜像:
zot.ad.ddupan.top/panxiao81/ayatori-manager@sha256:6a3fa9fece8e669371e87a2238a2e7c41216365e5366f9528e9efbea74dc64a5 - 部署 role:
git+https://git.ddupan.top/panxiao81/ayatori.git#/deploy/ansible,versionv0.1.4
Downloads
-
-
released this
2026-10-05 13:59:28 +00:00 | 287 commits to main since this release部署 role 导出控制面监控指标。
内容
- node_exporter(9100,systemd 二进制)只开启 LXC 内可信的 collector:cpu、meminfo、pressure、filesystem(
/与备份卷)、netdev、systemd(控制面服务)、textfile(备份成功时间戳)、time;loadavg、vmstat、hwmon 在非特权 LXC 中是宿主数据,不采集。 - kube-state-metrics(8085,quadlet)只导出 CR 状态:
gotk_resource_info(Flux)、ayatori_eso_resource_info(ExternalSecret/SecretStore)、ayatori_resource_info(Instance/Database/Tenant 的 Ready、原因与阶段)。 - ESO、Flux、manager 的 metrics 改为监听 LXC 地址(8180/8280/8281/8080)。(#38)
- manager 代码未变化。
部署注意
- 中央采集与告警规则在 homelab-infra
platform/observability(scrapes/ayatori.yaml、rules/ayatori.yaml)。
制品
- manager 镜像:
zot.ad.ddupan.top/panxiao81/ayatori-manager@sha256:6bf930d91c73328f4897f545b8c216d3d802a04be325d97aa7567b71f69a9b57 - 部署 role:
git+https://git.ddupan.top/panxiao81/ayatori.git#/deploy/ansible,versionv0.1.3
Downloads
- node_exporter(9100,systemd 二进制)只开启 LXC 内可信的 collector:cpu、meminfo、pressure、filesystem(