feat(flux): 分阶段接管 OpenEBS

2026-09-10 11:01:21 +00:00
parent abf3be0eae
commit f000301864
7 changed files with 128 additions and 0 deletions
@@ -0,0 +1,54 @@
+# 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 不可用时可暂时执行：
+
+```bash
+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。
+
+## 验证
+
+```bash
+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` 验证接管。
@@ -0,0 +1,35 @@
+apiVersion: helm.toolkit.fluxcd.io/v2
+kind: HelmRelease
+metadata:
+  name: openebs
+  namespace: openebs
+spec:
+  # 存储控制面先只登记；解除暂停必须使用独立 PR 并保留 live PV/PVC 基线。
+  suspend: true
+  chart:
+    spec:
+      chart: openebs
+      interval: 1h
+      sourceRef:
+        kind: HelmRepository
+        name: openebs
+      version: 4.4.0
+  driftDetection:
+    mode: enabled
+  install:
+    crds: CreateReplace
+    strategy:
+      name: RetryOnFailure
+      retryInterval: 5m
+  interval: 30m
+  releaseName: openebs
+  targetNamespace: openebs
+  timeout: 15m
+  upgrade:
+    crds: CreateReplace
+    strategy:
+      name: RetryOnFailure
+      retryInterval: 5m
+  valuesFrom:
+    - kind: ConfigMap
+      name: openebs-values
@@ -0,0 +1,8 @@
+apiVersion: source.toolkit.fluxcd.io/v1
+kind: HelmRepository
+metadata:
+  name: openebs
+  namespace: openebs
+spec:
+  interval: 1h
+  url: https://openebs.github.io/openebs
@@ -0,0 +1,15 @@
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+generatorOptions:
+  disableNameSuffixHash: true
+  labels:
+    reconcile.fluxcd.io/watch: Enabled
+configMapGenerator:
+  - name: openebs-values
+    namespace: openebs
+    files:
+      - values.yaml=values.yaml
+resources:
+  - helmrepository.yaml
+  - helmrelease.yaml
+  - storageclasses.yaml