Files
homelab-infra/platform/openebs/README.md
T
panxiao81 f000301864
yaml / yaml (pull_request) Successful in 30s
feat(flux): 分阶段接管 OpenEBS
2026-09-10 11:01:21 +00:00

2.2 KiB
Raw Blame History

OpenEBS — 本地 ZFS 存储

OpenEBS umbrella chart 为单节点 k3s 提供 zfs-localpv CSI provisioner,并保留 chart 自带的 local PV、Loki、Alloy 与 MinIO 组件。业务 PVC 使用独立声明的 localpv-zfs-ceph StorageClass,在宿主机 ZFS pool data/ceph 上创建 dataset/zvol。

当前版本与引擎

  • release:openebs,namespace:openebs
  • chart/app:4.4.0
  • ZFS LocalPV:启用
  • LVM LocalPV、RawFile LocalPV、Mayastor:显式禁用
  • bundled Loki SingleBinary:单副本

不要在 chart 升级时顺带启用其他存储引擎。localpv-zfs-ceph 当前承载 SeaweedFS、 shared PostgreSQL、NetBox、VictoriaMetrics、VictoriaLogs、VictoriaTraces、Grafana 与 RustFS 的持久卷;删除 StorageClass 不会删除已有 PV,但误删/重建 chart 资源可能中断 provisioner,因此 brownfield 接管期间保持 prune: false。

Flux 接管状态

现有 Helm release revision 为 3,保存的 user-supplied values 与本目录 values.yaml 一致。Git 中先登记固定 4.4.0 且 suspend: true 的 HelmRelease;阶段一仅让 Flux 管理 Helm source、release 声明、values ConfigMap 和现有 StorageClass,不运行 Helm upgrade。确认 source Ready、Helm revision、OpenEBS Pod UID、PV/PVC 与 ZFS volume 健康后,再通过独立 PR 解除暂停。

CRD 在 install/upgrade 时使用 CreateReplace,但绝不通过删除 CRD 迁移。接管和升级 是两个独立动作;首次激活不得改变 chart、values、StorageClass 或存储引擎。

Break-glass 手工恢复

正常变更应提交 Git。Flux 不可用时可暂时执行:

helm upgrade --install openebs openebs/openebs --version 4.4.0 \
  -n openebs --create-namespace -f platform/openebs/values.yaml
kubectl apply -f platform/openebs/storageclasses.yaml

恢复 Flux 后,应以 Git 为准并确认 HelmRelease 没有 drift。

验证

kubectl -n openebs get pods
kubectl get storageclass localpv-zfs-ceph
kubectl get pv | grep localpv-zfs-ceph
kubectl get pvc -A
zfs list -r data/ceph

所有既有 PV 必须保持 Bound。验证新 provisioner 时只创建单独的临时 PVC,不要修改 或删除业务 PVC,也不要用 helm uninstall 验证接管。