用途:为 Kubernetes homelab 提供端到端应用部署编排,并集成监控。
主要能力:按阶段推进部署流程。调研阶段调用 kubesearch 查找真实配置,用 helm search hub 判断是否存在原生 Helm chart,决定使用原生 chart 还是 app-template,并通过 AskUserQuestion 确认方案。设置阶段用 task wt:new -- deploy-<app-name> 创建隔离 worktree。配置阶段修改 versions.env、namespaces.yaml、helm-charts.yaml,创建 charts/<app>.yaml 值文件,在 kustomization.yaml 注册,可选创建 config/<app>/ 下的 route、canary、prometheus-rules 等资源。
使用方式:依次执行 task k8s:validate 与 task renovate:validate 校验;在开发集群用 helm install 直接部署并等待 Pod Ready,用 hubble observe 检查网络策略,用脚本检查部署健康、ServiceMonitor、告警与 Canary;随后 helm uninstall、task k8s:reconcile-validate 验证 Flux 收敛,最后 git push 与 gh pr create 提交 PR。
适用场景:向该 homelab 添加新应用、需要网络策略与监控接入、需要 Garage S3 存储或 PostgreSQL 数据库、需要 Renovate 版本跟踪的部署。
限制:依赖该仓库的 task 命令、Flux、Cilium、Istio 网关、Garage 等既有环境;task k8s:validate 不检测 PodSecurity 违规,需在受限命名空间手动补全安全上下文;Garage S3 需同时配置 GarageBucket、GarageKey 与平台级 GarageReferenceGrant,否则 admission webhook 会拒绝。具体版本、收费与平台支持暂未提供。