• v0.4.0 7aed0299b2

    v0.4.0
    Release / publish-image (push) Successful in 5m47s
    Release / publish-lb-agent (push) Successful in 6m30s
    Stable

    panxiao81 released this 2026-11-12 04:58:58 +00:00 | 25 commits to main since this release

    v0.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
  • v0.3.1 e507d864f0

    v0.3.1
    Release / publish-image (push) Successful in 2m27s
    Release / publish-lb-agent (push) Successful in 3m48s
    Stable

    panxiao81 released this 2026-11-09 16:27:39 +00:00 | 46 commits to main since this release

    v0.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
  • v0.3.0 c2c2abc9c6

    v0.3.0
    Release / publish-image (push) Successful in 2m27s
    Release / publish-lb-agent (push) Successful in 2m15s
    Stable

    panxiao81 released this 2026-11-09 10:56:10 +00:00 | 53 commits to main since this release

    v0.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
    Release / publish-image (push) Successful in 7m43s
    Release / publish-lb-agent (push) Successful in 37s
    Pre-Release

    panxiao81 released this 2026-11-03 16:53:12 +00:00 | 149 commits to main since this release

    v0.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,version v0.3.0-rc.3
    Downloads
  • v0.3.0-rc.2
    Release / publish-image (push) Successful in 7m6s
    Release / publish-lb-agent (push) Successful in 40s
    Pre-Release

    panxiao81 released this 2026-11-03 16:11:35 +00:00 | 158 commits to main since this release

    v0.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,version v0.3.0-rc.2
    Downloads
  • v0.3.0-rc.1
    Release / publish-image (push) Successful in 9m59s
    Release / publish-lb-agent (push) Successful in 38s
    Pre-Release

    panxiao81 released this 2026-11-03 12:34:15 +00:00 | 162 commits to main since this release

    v0.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 指定,默认是 Bao kv/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,version v0.3.0-rc.1
    Downloads
  • v0.3.0-rc.0
    Release / publish-image (push) Successful in 6m24s
    Release / publish-lb-agent (push) Successful in 1m52s
    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
  • v0.2.0 58d36e6112

    v0.2.0
    Release / publish-image (push) Successful in 6m15s
    Stable

    panxiao81 released this 2026-10-09 10:50:38 +00:00 | 269 commits to main since this release

    v0.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,version v0.2.0
    Downloads
  • v0.1.4 1d57f5fc4b

    v0.1.4
    Release / publish-image (push) Successful in 8m9s
    Stable

    panxiao81 released this 2026-10-05 17:57:06 +00:00 | 279 commits to main since this release

    v0.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,version v0.1.4
    Downloads
  • v0.1.3 8d04b7bf5a

    v0.1.3
    Release / publish-image (push) Successful in 20m5s
    Stable

    panxiao81 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,version v0.1.3
    Downloads