Trivy 教學手冊

Trivy 企業級 AI Agent 軟體開發安全掃描教學手冊 Version:1.1 Updated:2026-10-03 Applicable Trivy Version:v0.75.0(2026-10-01 發布,GitHub Release 標示為 Latest、Immutable Release) 相關元件版本:trivy-action v0.36.0(action.yaml 預設安裝 Trivy v0.70.0,必須以 version: v0.75.0 明確指定)、setup-trivy v0.3.1(安全下限 ≥ v0.2.6,避開 v0.3.0)、Trivy Operator v0.34.0(Helm Chart 0.36.0,內建 Trivy 0.74.0)、Trivy Server Helm Chart 0.27.0(Trivy 0.75.0)、trivy-aws plugin v0.15.1、trivy-mcp plugin v0.0.20 Audience:PM、SA、Software Architect、Frontend / Backend Developer、DevOps、DevSecOps、Security Engineer、AI Engineer、AI Agent Developer、Platform Team、Reviewer 文件狀態:所有 CLI、參數、Target、Scanner、報告格式皆對照 Trivy 官方文件(trivy.dev/docs/latest)、GitHub Release、CHANGELOG 與 Security Advisory 查證。官方文件未說明者一律標示「官方資料未說明」,不推測、不補完。 關於本手冊 這份手冊要解決的問題 市面上大部分 Trivy 文章只回答一個問題:「trivy image 怎麼下?」。這個問題花十分鐘就能學會。 本手冊要回答的是企業真正卡關的問題: ...

October 4, 2026 · 113 min · 24059 words · Eric Cheng

Kubernetes教學手冊

Kubernetes教學手冊 項目 內容 文件版本 2.0(企業標準技術白皮書版) 最後更新 2026-10-01 版本基準 Kubernetes v1.37.1(主線,所有範例的基準);1.34/1.35 的差異以 📌 1.34/1.35 差異 標示 周邊元件基準 containerd 2.4.1、etcd 3.7(kubeadm 預設)、Gateway API v1.6.2、Helm 4.3.0、Cilium 1.20.2/Calico 3.32.2、Prometheus 3.15、Argo CD 3.5 適用對象 後端工程師、DevOps/SRE、平台工程師、系統架構師、資安人員 定位 企業內部 Kubernetes 標準教材與導入參考 文件維護 內部技術團隊(Created by Eric Cheng) 🆕 v2.0 改版重點 版本基準從 1.29 改為 1.37.1:1.29 已於 2025-02-28 EOL。本版依 Kubernetes 1.37.1 原始碼與官方文件逐章查證,並註記 1.34/1.35 的差異。 重大生態系變化:Ingress NGINX 已於 2026-03-24 退役(第 4 章並列 Ingress 與 Gateway API,並提供遷移指南);cgroup v1 自 1.35 起預設拒絕啟動、1.36 起必須 containerd 2.x(第 2、11 章);Bitnami 免費映像下架、Helm 4 發布(第 12 章)。 修正 v1.0 的錯誤與過時內容:共 41 項,完整清單見附錄 D.2。 新增章節:第 8 章「安全強化」、第 15 章「疑難排解手冊」、第 16 章「1.29 → 1.37 版本演進」,以及附錄 B–F。 每章結尾新增「💡 本章實務建議」;新增段落標示 🆕,更正段落標示 ⚠️。 閱讀指引 讀者角色 建議閱讀順序 重點章節 初次接觸 Kubernetes 的工程師 1 → 3 → 4 → 5 → 7 1.3 核心物件概念、3.3 Deployment 與 ReplicaSet 後端/應用開發者 3 → 5 → 6 → 13 → 14 6.2 Health Check、13.5 優雅關機 平台/SRE 工程師 2 → 9 → 10 → 11 → 15 10.2 etcd 備份與還原、11.4 破壞性變更檢查 系統架構師 1 → 4 → 10.1 → 14 → 16 4.7 Gateway API、14.3 企業環境實務建議 資安人員 8 → 4.9 → 12.3 → 14.3 8.5 Admission 控制、8.10 供應鏈安全 從舊版升級的團隊 16 → 11 → 4.8 16.3 建議升級路徑、4.8 Ingress NGINX 遷移 📌 標示說明:🆕 v2.0 新增;⚠️ v2.0 更正或重要警示;📌 補充說明與版本差異;✅ 建議做法。功能成熟度標示為「x.y GA/Beta/Alpha」,以 Kubernetes 官方 feature gate 文件為準。 ...

January 30, 2026 · 98 min · 20736 words · Eric Cheng

Prometheus與Grafana教學手冊

Prometheus與Grafana教學手冊 文件資訊 項目 內容 文件版本 2.0 最後更新 2026-10-01 版本基準 Prometheus 3.15.0(2026-09-24)、Prometheus LTS 3.13.x(支援至 2027-07-31)、Alertmanager 0.34.1、Grafana 13.2.3(2026-09-29)、node_exporter 1.12.1;完整矩陣見 1.5 版本基準與相容性矩陣 文件定位 企業標準技術白皮書/內部標準教材:Prometheus+Alertmanager+Grafana 的規劃、安裝、設定、使用、告警、安全、高可用、維運與升級 適用對象 資深工程師、DevOps/SRE、系統管理員、系統架構師、資安與稽核人員 前置知識 Linux 系統管理(systemd、防火牆、檔案權限)、容器與 Kubernetes 基本概念、HTTP 與 TLS、YAML 姊妹文件 《Metrics Visualization 教學手冊》:指標設計、PromQL 分析、儀表板設計、SLO 與架構決策的深入探討;《OpenTelemetry教學手冊》:OTel SDK 與 Collector;《Logs Visualization 教學手冊》:日誌視覺化 前一版本 1.0(2026-01-27,以 Prometheus 2.48、Grafana 10.2 為基準) Created by Eric Cheng 📌 v2.0 改版重點:章節重新編排為 15 章與 7 個附錄,全面對齊 Prometheus 3.x、Alertmanager 0.34 與 Grafana 13。 修正錯誤:修正 v1.0 中已不適用或會造成故障的內容。例如 3.x 發行包已不含 consoles、apt-key 已棄用、Alertmanager /api/v1 已移除(回傳 410)、match/source_match 已棄用、Teams Office 365 connector 已停用、快照還原步驟會刪除快照本身、儲存估算重複折算壓縮率、Grafana 稽核設定鍵錯誤且為 Enterprise 限定、Istio istio-telemetry 已不存在等。 新增內容:容量規劃、Alertmanager 安裝、Compose 與 Kubernetes 部署、離線安裝、Service Discovery 與 relabel、抓取保護、Remote Write/Agent mode、OTLP、Grafana 資料庫與認證整合、原生直方圖、Dynamic dashboards、Grafana Alerting 決策、規則單元測試、安全強化、高可用、自我監控、Prometheus 2.x → 3.x 遷移、Grafana 13 升級、AI 輔助維運與臺灣法規對應。 追溯依據:所有差異見 E.2 v1.0 → v2.0 更正對照表,查證依據見 附錄 F:查證紀錄。 閱讀指引 讀者角色 建議閱讀章節 初次接觸 Prometheus/Grafana 第 1 章 → 第 2 章 → 4.5 → 第 7 章 → 第 8 章 系統管理員(VM/實體機) 第 3 章 → 4.1–4.4 → 第 5、6 章 → 第 12 章 → 第 13 章 Kubernetes 平台工程師 2.6 → 4.6 → 5.2–5.4 → 11.1–11.2 → 12.4 SRE/值班人員 第 7 章 → 第 9 章 → 12.1 → 12.6 → 第 15 章 應用程式開發人員 2.2–2.3 → 7.4 → 14.1–14.2 → 14.5 架構師 2.6–2.7 → 3.2 → 第 11 章 → 14.3–14.4 資安/稽核人員 第 10 章 → 14.6 → 15.3 技術主管/決策者 1.1–1.5 → 2.7 → 13.1 → 14.6 → 14.7 本文慣例 標記 意義 ✅/❌ 建議做法/不建議做法 ⚠️ 容易出錯或有風險的地方 💡 實務技巧 🧪 實驗性功能:需 --enable-feature 或 feature toggle,行為可能在後續版本變更,不納入 LTS 支援範圍 📌 版本差異或改版說明 🏢 只在 Grafana Enterprise 或 Grafana Cloud 提供的功能 $變數 Grafana 範本變數 <尖括號> 需依環境替換的值 example.internal 範例內部網域,請替換為實際網域 ⚠️ 本手冊的指令以 RHEL 9/10 與 Ubuntu 24.04 LTS 為例,設定檔與 PromQL 皆以 Prometheus 3.15、Alertmanager 0.34.1、Grafana 13.2.3 撰寫,並以官方二進位檔的 promtool/amtool 驗證(見 附錄 F:查證紀錄)。若仍在 Prometheus 2.x,請先閱讀 13.2 Prometheus 2.x → 3.x 遷移。 ...

January 29, 2026 · 87 min · 18519 words · Eric Cheng