跳至主要内容

本機腳本安裝

安裝原理說明​

install.sh 是一個互動式 bash 腳本,會依序執行以下操作:

  1. 偵測並安裝 Helm(若本機尚未安裝)
  2. 使用 Helm 安裝 Tetragon 至叢集(若叢集尚未部署)
  3. 透過 kubectl apply 將 K8s Sentinel 部署至 sentinel-system namespace
  4. 使用 Helm 安裝 Trivy Operator 至 sentinel-system(v0.61+,若叢集尚未部署)

整個安裝流程在本機執行,每個步驟均會輸出進度訊息,方便直接觀察安裝狀態,適合快速試用或開發測試環境。


步驟一:Clone 原始碼​

git clone https://github.com/cooloo9871/K8s_Sentinel.git
cd K8s_Sentinel/deploy

取得原始碼後,進入 deploy/ 目錄,安裝腳本 install.sh 即位於此目錄下。


步驟二:賦予執行權限​

chmod +x install.sh

原理:Linux 系統預設不允許直接執行從網路下載的腳本,需明確使用 chmod +x 賦予執行位元(execute bit),才能以 ./install.sh 方式執行。這是一種安全機制,防止意外執行未知腳本。


步驟三:執行安裝腳本​

./install.sh

原理:腳本依序執行以下流程:

  1. 準備 Helm:安裝 Tetragon 或 Trivy Operator 需要用到時,若本機未偵測到 helm 指令,腳本會自動下載最新穩定版到暫存目錄使用(不會安裝到系統,腳本結束時自動清除)
  2. 部署 Tetragon:叢集任一 Namespace 已有 Tetragon DaemonSet 時跳過(v0.69 起不限於 kube-system);否則以 Cilium 官方 Helm Chart 安裝為 Helm release(v0.64.1 起使用 helm install,之後可直接 helm upgrade),設定 hostNetwork=false 與 tetragon.grpc.address=0.0.0.0:54321。無論 Tetragon 是否為本次安裝,腳本都會套用 tetragon-grpc-policy.yaml,讓 gRPC 埠只有 K8s Sentinel 能連(原因見 安裝 Tetragon)
  3. kubectl apply 部署 K8s Sentinel 清單:建立 Namespace、ServiceAccount、ClusterRole、ClusterRoleBinding、Deployment 和 Service 等所需資源
  4. 部署 Trivy Operator:叢集任一 Namespace 已有 Trivy Operator 的 Deployment 時跳過;否則以 helm install 安裝至 sentinel-system,套用同目錄下的 trivy-operator-values.yaml(詳見 安裝 Trivy Operator)

步驟四:觀察安裝輸出​

安裝過程中,腳本會輸出各階段的進度訊息,主要區段說明如下:

輸出訊息階段說明
[helm] not found, downloading to temp dir...本機沒有 Helm,下載到暫存目錄(僅在需要時出現)
[tetragon] already installed, skipping叢集已有 Tetragon,跳過
[tetragon] not found, installing latest version...部署 Tetragon 並等待 DaemonSet 就緒,完成後輸出 [tetragon] ready
[sentinel] applying manifests...套用 K8s Sentinel 相關 Kubernetes 資源,並等待 Deployment 就緒
[trivy-operator] already installed, skipping叢集已有 Trivy Operator,跳過
[trivy-operator] not found, installing latest version...安裝 Trivy Operator 並等待 Deployment 就緒,完成後輸出 [trivy-operator] ready
Done. Access via:所有步驟完成

安裝完成後,腳本最後會顯示建議的 port-forward 指令:

kubectl port-forward -n sentinel-system svc/sentinel 8080:80

可複製此指令並在本機執行,即可透過瀏覽器開啟 K8s Sentinel 管理介面。


步驟五:確認部署狀態​

kubectl get all -n sentinel-system

預期結果:

  • Pod 狀態為 Running
  • Service 類型為 ClusterIP,已取得內部 IP
NAME READY STATUS RESTARTS AGE
pod/sentinel-7d9f8b6c4-xxxxx 1/1 Running 0 2m

NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
service/sentinel ClusterIP 10.96.123.45 <none> 80/TCP 2m

NAME READY UP-TO-DATE AVAILABLE AGE
deployment.apps/sentinel 1/1 1 1 2m

若 Pod 未能進入 Running 狀態,可透過以下指令查看詳細錯誤訊息:

kubectl describe pod -n sentinel-system
kubectl logs -n sentinel-system deployment/sentinel

正式環境注意事項

腳本執行過程中會自動下載 Helm 並修改叢集設定(新增 Tetragon 與 Trivy Operator、建立 RBAC 資源等)。在正式環境中,這類自動化操作可能繞過變更審查流程,建議改用 Kubernetes Job 安裝 方式,以保有更好的操作透明度與控制性。