本機腳本安裝
安裝原理說明
install.sh 是一個互動式 bash 腳本,會依序執行以下操作:
- 偵測並安裝 Helm(若本機尚未安裝)
- 使用 Helm 安裝 Tetragon 至叢集(若叢集尚未部署)
- 透過
kubectl apply將 K8s Sentinel 部署至sentinel-systemnamespace - 使用 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
原理:腳本依序執行以下流程:
- 準備 Helm:安裝 Tetragon 或 Trivy Operator 需要用到時,若本機未偵測到
helm指令,腳本會自動下載最新穩定版到暫存目錄使用(不會安裝到系統,腳本結束時自動清除) - 部署 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) - kubectl apply 部署 K8s Sentinel 清單:建立 Namespace、ServiceAccount、ClusterRole、ClusterRoleBinding、Deployment 和 Service 等所需資源
- 部署 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 安裝 方式,以保有更好的操作透明度與控制性。