前置需求
在部署 K8s Sentinel 之前,請確認您的環境已符合以下所有需求。
環境需求
| 元件 | 最低版本 | 說明 |
|---|---|---|
| Kubernetes | 1.32+ | 叢集需正常運作,且能透過 kubeconfig 存取 |
| Cilium | 1.14+ | 作為叢集 CNI,需啟用 kube-proxy replacement、Hubble 與 Hubble Relay(安裝方式見 安裝與設定 Cilium) |
| Tetragon | 1.0+ | 以 DaemonSet 形式部署,需將 gRPC 綁定至 Pod 網路(0.0.0.0:54321,安裝方式見 安裝 Tetragon) |
| Trivy Operator | 選用 | 提供工作負載弱點掃描結果(v0.60+)。Job 與腳本安裝會一併安裝至 sentinel-system;未安裝時 K8s Sentinel 其餘功能照常運作(見 安裝 Trivy Operator) |
| kubectl | 1.32+ | 用於本機操作叢集,需已設定有效的 kubeconfig |
| 存取權限 | cluster-admin 或具 TracingPolicy RBAC | 安裝 K8s Sentinel 及操作 TracingPolicy CRD 均需要足夠的叢集權限 |
確認 Cilium 安裝
執行以下指令確認 Cilium DaemonSet 已正常運行:
kubectl get pods -n kube-system -l k8s-app=cilium
預期所有 Pod 均顯示 Running 狀態,且 READY 欄位顯示完整就緒(例如 1/1)。
原理:Cilium 以 DaemonSet 形式部署於 Kubernetes 叢集的每個 Node 上,負責載入 eBPF 程式至 Linux kernel。確認 Pod 處於 READY 狀態,代表對應 Node 上的 eBPF 程式已成功載入,是 Tetragon 正常運作的基礎前提。
確認 Tetragon 安裝
執行以下指令確認 Tetragon DaemonSet 已正常運行(依安裝方式,命名空間可能有所不同):
kubectl get pods -n kube-system -l app.kubernetes.io/name=tetragon
# 或
kubectl get pods -n tetragon -l app.kubernetes.io/name=tetragon
預期輸出中每個 Node 均有對應的 Tetragon Pod,且狀態為 Running。
原理:Tetragon DaemonSet 在每個 Node 上部署一個 Agent,負責透過 eBPF hook 捕捉 kprobe 安全事件(如系統呼叫、網路連線、檔案存取),並將事件資料轉發至 K8s Sentinel 後端進行彙整與呈現。
確認 kubectl 連線
確認本機 kubectl 已正確設定並能與目標叢集通訊:
kubectl cluster-info
kubectl get nodes
kubectl cluster-info 應顯示 Kubernetes control plane 的端點位址;kubectl get nodes 應列出叢集中所有節點,且狀態均為 Ready。
確認 TracingPolicy CRD
Tetragon 安裝完成後會自動在叢集中註冊 TracingPolicy 相關的 CRD,執行以下指令確認已存在:
kubectl get crd | grep tetragon
預期輸出中應包含以下兩筆 CRD 資源:
tracingpolicies.cilium.iotracingpoliciesnamespaced.cilium.io
若上述 CRD 不存在,表示 Tetragon 尚未完成安裝或 CRD 未正確套用,請先完成 Tetragon 的安裝程序後再繼續。
若您的環境尚未安裝 Cilium 或 Tetragon,請依序參考本文件的 安裝與設定 Cilium 與 安裝 Tetragon 完成部署。