跳至主要内容

設定永久儲存(PV / PVC)

為什麼需要​

K8s Sentinel 官方 manifest 中的資料目錄 /data/sentinel 預設掛載的是 emptyDir:

volumes:
- name: data
emptyDir: {}

emptyDir 的生命週期跟著 Pod 走,只要 Pod 重啟或被重新調度,以下資料就會全部歸零:

  • 使用者帳號與密碼(回到預設 admin / admin)
  • Alerts 告警規則與 Syslog 轉送設定
  • 自訂 Policy Templates
  • Security Events / Admission Events 歷史事件
  • Registry 掃描的 Registry 設定(含認證)與掃描結果(registries.json 與 registry-scans/,v0.62+)
  • Session Timeout 等系統設定

正式環境請務必將 /data/sentinel 改掛 PersistentVolume。

權限需求

K8s Sentinel 以非 root 身分執行(runAsUser: 10001),Deployment 已設定 fsGroup: 10001。只要儲存後端支援 Kubernetes 的 fsGroup 權限調整(多數 CSI 驅動、local、hostPath 皆支援),掛載時會自動將卷的群組改為 10001,無需手動處理;NFS 為例外,見下方說明。


方式一:StorageClass 動態供應(建議)​

若叢集已有 StorageClass(例如 Longhorn、Rook-Ceph、雲端供應商的 CSI),只需建立 PVC:

sentinel-data-pvc.yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: sentinel-data
namespace: sentinel-system
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 2Gi
# 省略 storageClassName 則使用叢集預設 StorageClass
# storageClassName: longhorn
kubectl apply -f sentinel-data-pvc.yaml

事件資料庫有筆數上限與 TTL 控管(見 Event Retention),2Gi 對多數環境已相當充裕。


方式二:靜態 PV(Local Volume,單節點 / 測試環境)​

沒有 StorageClass 時,可手動建立 local 類型的 PV,將資料固定存在某個節點的目錄:

sentinel-data-local.yaml
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: sentinel-local
provisioner: kubernetes.io/no-provisioner
volumeBindingMode: WaitForFirstConsumer
---
apiVersion: v1
kind: PersistentVolume
metadata:
name: sentinel-data-pv
spec:
capacity:
storage: 2Gi
accessModes:
- ReadWriteOnce
persistentVolumeReclaimPolicy: Retain
storageClassName: sentinel-local
local:
path: /opt/sentinel-data # 節點上的實體目錄,需事先建立
nodeAffinity:
required:
nodeSelectorTerms:
- matchExpressions:
- key: kubernetes.io/hostname
operator: In
values:
- w1 # 替換為實際的節點名稱
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: sentinel-data
namespace: sentinel-system
spec:
accessModes:
- ReadWriteOnce
storageClassName: sentinel-local
resources:
requests:
storage: 2Gi

先在目標節點上建立目錄,再套用:

# 在 w1 節點上執行
sudo mkdir -p /opt/sentinel-data

# 在管理機上執行
kubectl apply -f sentinel-data-local.yaml
警告

local PV 透過 nodeAffinity 將 K8s Sentinel Pod 綁定在該節點上。若該節點故障,Pod 將無法在其他節點重新調度。正式環境建議改用方式一的網路儲存。


方式三:靜態 PV(NFS,多節點共用)​

sentinel-data-nfs.yaml
apiVersion: v1
kind: PersistentVolume
metadata:
name: sentinel-data-pv
spec:
capacity:
storage: 2Gi
accessModes:
- ReadWriteOnce
persistentVolumeReclaimPolicy: Retain
storageClassName: sentinel-nfs
nfs:
server: 192.168.10.60 # NFS 伺服器位址
path: /export/sentinel-data # NFS 匯出路徑
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: sentinel-data
namespace: sentinel-system
spec:
accessModes:
- ReadWriteOnce
storageClassName: sentinel-nfs
resources:
requests:
storage: 2Gi
NFS 權限注意

NFS 不支援 Kubernetes 的 fsGroup 自動調整,請在 NFS 伺服器上手動將匯出目錄的擁有者設為 UID 10001:

sudo chown -R 10001:10001 /export/sentinel-data

否則 K8s Sentinel 會因無法寫入資料庫而啟動失敗。


將 PVC 掛載至 K8s Sentinel Deployment​

PVC 建立完成後(kubectl get pvc -n sentinel-system 顯示 Bound,使用 WaitForFirstConsumer 時會停在 Pending 直到 Pod 掛載,屬正常現象),將 Deployment 的 data volume 從 emptyDir 改為 PVC:

kubectl -n sentinel-system patch deployment sentinel --patch '
spec:
template:
spec:
volumes:
- name: data
emptyDir: null
persistentVolumeClaim:
claimName: sentinel-data
'

或直接編輯 manifest(deploy/sentinel.yaml)後重新 apply:

volumes:
- name: data
persistentVolumeClaim: # 原本的 emptyDir: {} 改為這兩行
claimName: sentinel-data
- name: tmp
emptyDir: {}
備註

tmp volume 只存放暫存檔,維持 emptyDir 即可,不需要持久化。

Patch 後 Deployment 會自動滾動重啟 Pod 並掛上新的儲存卷。


驗證​

確認 Pod 正常啟動且 PVC 已綁定:

kubectl get pods,pvc -n sentinel-system

確認資料庫檔案已寫入永久儲存:

kubectl -n sentinel-system exec deploy/sentinel -- ls -la /data/sentinel

最後做一次實際測試:登入 K8s Sentinel 修改任意設定(例如變更 admin 密碼或新增一條 Alert 規則),接著重啟 Pod:

kubectl -n sentinel-system rollout restart deployment sentinel

Pod 重啟後重新登入,若剛才的變更仍然存在,代表永久儲存設定成功。

注意

掛上 PVC 的當下,先前存在 emptyDir 中的資料不會自動搬移,K8s Sentinel 會以全新狀態啟動(帳號回到 admin/admin)。建議在完成初始設定(修改密碼、建立使用者與告警規則)之前就先設定好永久儲存。


只想讓 Session 不因重啟登出?(JWT_SECRET)​

Session 簽署金鑰預設存在 /data/sentinel/.jwt-secret。未掛 PV 時每次 Pod 重啟金鑰都會重生,所有使用者被強制登出。v0.53 起可改用 JWT_SECRET 環境變數(至少 32 字元)固定金鑰,從 Kubernetes Secret 注入:

kubectl -n sentinel-system create secret generic sentinel-jwt \
--from-literal=jwt-secret="$(openssl rand -hex 32)"
env:
- name: JWT_SECRET
valueFrom:
secretKeyRef:
name: sentinel-jwt
key: jwt-secret
  • 值太短會拒絕啟動,不會默默弱化 Session 安全
  • 未設定則維持原本的 .jwt-secret 檔案行為;已掛 PV 的部署不需要此設定
  • 注意:JWT_SECRET 只解決 Session 存續,帳號、規則與事件資料仍需 PV 才能保留