跳至主要内容

前置需求

在部署 K8s Sentinel 之前,請確認您的環境已符合以下所有需求。

環境需求​

元件最低版本說明
Kubernetes1.32+叢集需正常運作,且能透過 kubeconfig 存取
Cilium1.14+作為叢集 CNI,需啟用 kube-proxy replacement、Hubble 與 Hubble Relay(安裝方式見 安裝與設定 Cilium)
Tetragon1.0+以 DaemonSet 形式部署,需將 gRPC 綁定至 Pod 網路(0.0.0.0:54321,安裝方式見 安裝 Tetragon)
Trivy Operator選用提供工作負載弱點掃描結果(v0.60+)。Job 與腳本安裝會一併安裝至 sentinel-system;未安裝時 K8s Sentinel 其餘功能照常運作(見 安裝 Trivy Operator)
kubectl1.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.io
  • tracingpoliciesnamespaced.cilium.io

若上述 CRD 不存在,表示 Tetragon 尚未完成安裝或 CRD 未正確套用,請先完成 Tetragon 的安裝程序後再繼續。

提示

若您的環境尚未安裝 Cilium 或 Tetragon,請依序參考本文件的 安裝與設定 Cilium 與 安裝 Tetragon 完成部署。