跳至主要内容

架構說明

系統架構圖​

下圖說明 K8s Sentinel 各元件之間的部署關係與通訊路徑:

元件說明​

元件技術說明
FrontendTypeScript + React + Vite + shadcn/ui網頁操作介面,以 SPA 形式提供 TracingPolicy 管理、事件檢視與叢集監控等功能
BackendGo 1.x + HTTP Server (port 8080)提供 RESTful API 服務,內建 Kubernetes 客戶端,負責與叢集溝通並處理使用者驗證
Cilium TetragoneBPF DaemonSet部署於每個 Kubernetes Node 的安全觀測代理程式,透過 eBPF 技術於 kernel 層捕捉系統呼叫與檔案存取事件;K8s Sentinel 以 gRPC(GetEvents)逐節點串流收集事件
Hubble RelayCilium 元件將所有節點的網路 flow 彙整在單一 gRPC 端點,供 K8s Sentinel 以 GetFlows 串流讀取,作為 Network Topology 的資料來源
Trivy Operator選用元件(Helm,安裝於 sentinel-system)掃描執行中工作負載的 Image 並寫出 VulnerabilityReport;K8s Sentinel 只讀取報告,不自行掃描工作負載(v0.60+)
Trivy 掃描 PodKubernetes Job(sentinel-system)Registry 掃描時由 K8s Sentinel 啟動,每個 Image 一個短命 Pod(v0.62+)
TracingPolicyKubernetes CRD (cilium.io/v1alpha1)定義 Tetragon 所要追蹤的 kprobe 規則與安全策略的自訂資源定義
Persistent Storage/data/sentinel/本機持久化路徑:使用者帳號、JWT 簽署金鑰、Alerts 與 Syslog 設定、自訂範本、事件歷史與 Audit Log、Registry 設定與掃描結果

資料流說明​

以下循序圖說明使用者透過 K8s Sentinel 建立一條新 TracingPolicy 的完整流程:

部署架構​

K8s Sentinel 採用單一 binary 部署模式,大幅簡化安裝流程:

Go backend 在編譯時透過 embed.go 將前端 React SPA 的靜態檔案(HTML、JavaScript、CSS)完整內嵌至 binary 中。部署時只需複製並執行單一可執行檔,無需額外的 Web 伺服器或靜態檔案服務。

持久化資料存放於以下路徑:

路徑用途
/data/sentinel/users.json使用者帳號與密碼雜湊
/data/sentinel/.jwt-secretJWT Token 簽署金鑰,首次啟動時自動產生;v0.53 起可被 JWT_SECRET 環境變數覆蓋
/data/sentinel/(其餘)Alerts / Syslog 設定、自訂 Policy Templates、Security / Admission 事件歷史、Audit Log
/data/sentinel/registries.jsonRegistry 掃描的 Registry 設定(含認證)
/data/sentinel/registry-scans/Registry 掃描結果,每個 Registry 一個目錄