Node.js生態系教學手冊

Node.js 生態系教學手冊 版本:2026.06 適用對象:具備基礎程式能力,準備參與 Web Application 或 Backend API 專案開發的工程師 定位:實務導向、架構導向、企業導向的內部技術文件 Node.js 版本基準:v26.1.0 LTS 最後更新:2026 年 6 月 目錄 第 1 章:Node.js 簡介 1.1 Node.js 是什麼 1.2 Runtime 架構與 V8 Engine 1.3 Event Loop 運作機制 1.4 Non-blocking I/O 模型 1.5 Node.js 適用場景與不適用場景 1.6 Node.js LTS 與 Current 版本策略 第 2 章:Node.js 生態系 2.1 npm 2.2 yarn 2.3 pnpm 2.4 npx 與 corepack 2.5 package.json 完整解析 2.6 package-lock.json 與依賴鎖定 2.7 Semantic Versioning(語意化版本) 第 3 章:Node.js 安裝與環境建立 3.1 Windows 環境安裝 3.2 Linux 環境安裝 3.3 macOS 環境安裝 3.4 nvm — Node Version Manager 3.5 fnm — Fast Node Manager 3.6 Volta — 可靠的 JavaScript 工具管理器 3.7 企業環境設定與內部 Registry 第 4 章:TypeScript 開發平台 4.1 為什麼企業專案必須使用 TypeScript 4.2 tsconfig.json 設計原則 4.3 ESM 與 CommonJS 互操作性 4.4 ts-node 與 tsx 開發工具 4.5 SWC 與 esbuild 高速編譯器 4.6 Node.js v26 原生 TypeScript 支援 4.7 型別設計與 Domain Model 最佳實務 第 5 章:Node.js 核心 API 5.1 fs(檔案系統) 5.2 path(路徑處理) 5.3 os(作業系統資訊) 5.4 process(程序管理) 5.5 buffer(二進位資料處理) 5.6 stream(串流處理) 5.7 crypto(加密與雜湊) 5.8 http / https(HTTP 伺服器與客戶端) 5.9 events(事件發射器) 5.10 timers(計時器) 5.11 worker_threads(工作執行緒) 5.12 cluster(叢集) 5.13 child_process(子程序) 5.14 diagnostics_channel(診斷通道) 5.15 新興 API:SQLite、FFI、Permissions 第 6 章:非同步程式設計 6.1 Callback 模式 6.2 Promise 與 Promise 組合器 6.3 async / await 最佳實務 6.4 Event Loop 深入解析 6.5 Microtask Queue 與 Macrotask Queue 6.6 並行控制與流量管控 第 7 章:Express 教學 7.1 建立 REST API 7.2 Middleware 機制 7.3 Routing 設計 7.4 Error Handling 7.5 JWT 身分驗證 7.6 Request Validation 7.7 File Upload 7.8 Express 效能最佳化 7.9 Express 安全強化 7.10 Express 與 Graceful Shutdown 第 8 章:Fastify 教學 8.1 高效能 API 建構 8.2 Plugin 架構 8.3 Schema Validation 與序列化 8.4 效能比較與調校 8.5 TypeBox Schema 驗證 8.6 Fastify Hooks 生命週期 8.7 Fastify 封裝性與裝飾器 8.8 Fastify Rate Limiting 與安全 8.9 Fastify 錯誤處理 第 9 章:NestJS 教學 9.1 Module 模組設計 9.2 Controller 控制器 9.3 Provider 與 Service 9.4 Dependency Injection 依賴注入 9.5 Guard 守衛 9.6 Interceptor 攔截器 9.7 Pipe 管道 9.8 CQRS 模式 9.9 NestJS 微服務模式 9.10 NestJS 排程任務 第 10 章:API 設計最佳實務 10.1 RESTful API 設計原則 10.2 OpenAPI / Swagger 文件化 10.3 API Versioning 策略 10.4 統一錯誤碼設計 10.5 Idempotency 冪等性設計 10.6 Pagination 分頁設計 10.7 GraphQL 簡介與對比 10.8 WebSocket 即時通訊 API 10.9 API 錯誤碼體系設計 10.10 API 限流與配額設計 第 11 章:資料庫整合 11.1 PostgreSQL 整合 11.2 MySQL 整合 11.3 MongoDB 整合 11.4 Redis 快取整合 11.5 Prisma ORM 11.6 TypeORM 11.7 Transaction、Migration 與連線池 11.8 Prisma 進階查詢模式 11.9 Redis 進階模式 第 12 章:測試 12.1 Node.js 內建 Test Runner(node:test) 12.2 Jest 測試框架 12.3 Vitest 測試框架 12.4 Supertest 整合測試 12.5 Playwright E2E 測試 12.6 Test Pyramid 與測試策略 12.7 Mock / Stub / Spy 使用時機 12.8 Coverage 工具(c8 / istanbul) 12.9 Contract Testing(契約測試) 12.10 測試資料管理 12.11 Snapshot Testing 第 13 章:專案架構設計 13.1 Clean Architecture 應用 13.2 Hexagonal Architecture 應用 13.3 Domain-Driven Design(DDD)實作 13.4 Monorepo 策略(Turborepo / Nx / pnpm workspace) 13.5 微服務架構設計 13.6 Error Handling 架構 13.7 Configuration Management 第 14 章:前端整合 14.1 Vue 整合模式 14.2 React 整合模式 14.3 Next.js 全端框架 14.4 Nuxt.js 全端框架 14.5 Server-Side Rendering(SSR)架構 14.6 BFF(Backend for Frontend)設計模式 14.7 Server-Sent Events(SSE)即時推送 14.8 Micro-Frontend 整合模式 14.9 API 狀態管理(TanStack Query) 第 15 章:Docker 化 15.1 Node.js Dockerfile 撰寫 15.2 Multi-stage Build 15.3 Docker Compose 開發環境 15.4 容器安全最佳實務 15.5 Docker Compose 完整開發環境 15.6 生產環境 Docker 最佳實務 第 16 章:Kubernetes 部署 16.1 Deployment 設定 16.2 Service 與 Ingress 16.3 ConfigMap 與 Secret 16.4 HPA 自動擴縮 16.5 Health Check 與 Readiness Probe 16.6 Helm Chart 管理 16.7 Namespace 與資源隔離策略 第 17 章:CI/CD 17.1 GitHub Actions 完整範例 17.2 GitLab CI 配置 17.3 Jenkins Pipeline 17.4 Build → Test → Security Scan → Docker Build → Deploy 流程 17.5 Semantic Versioning 自動化 17.6 Commit 規範與自動化 第 18 章:Logging 與 Monitoring 18.1 Winston 日誌框架 18.2 Pino 高效能日誌 18.3 OpenTelemetry 可觀測性 18.4 Prometheus 指標收集 18.5 Grafana 視覺化監控 18.6 分散式追蹤(OpenTelemetry) 18.7 ELK Stack 日誌架構 18.8 告警策略設計 第 19 章:Node.js 效能調校 19.1 Event Loop Lag 監控 19.2 Memory Leak 偵測 19.3 Heap Snapshot 分析 19.4 CPU Profile 分析 19.5 Benchmark 工具 19.6 效能最佳化清單 19.7 V8 引擎最佳化技巧 19.8 Worker Threads 平行運算 19.9 Stream 效能最佳化 19.10 JSON 序列化加速 第 20 章:安全性(SSDLC) 20.1 OWASP Top 10 for Node.js 20.2 npm 供應鏈攻擊防護 20.3 依賴掃描與 SAST/DAST 20.4 Secret 管理 20.5 JWT 安全最佳實務 20.6 Helmet、CORS 與 Rate Limiting 20.7 輸入驗證與 Injection 防護 20.8 SSRF 防護 20.9 密碼安全與雜湊 20.10 Content Security Policy(CSP) 20.11 安全 HTTP Headers 完整清單 第 21 章:AI 協作開發 21.1 GitHub Copilot 21.2 Claude Code 21.3 其他 AI 工具整合 21.4 Prompt Engineering for Coding 21.5 AI 輔助 Code Review 21.6 AI 輔助測試產生 21.7 AI 輔助文件產生 21.8 CLAUDE.md 專案規範範例 第 22 章:Node.js 維運 22.1 PM2 程序管理 22.2 Cluster 模式 22.3 部署策略 22.4 Graceful Shutdown 22.5 維運監控 Checklist 22.6 Node.js 生產環境設定 22.7 日誌輪替與管理 22.8 健康檢查與自我修復 第 23 章:企業級最佳實務 23.1 Coding Standard 與 Lint 23.2 Conventional Commits 23.3 Git Flow 與分支策略 23.4 Release 與版本策略 23.5 Code Review 流程 23.6 API 版本管理策略 23.7 Feature Flag 管理 23.8 國際化(i18n) 第 24 章:完整企業級範例專案 24.1 專案概覽 24.2 NestJS API 核心 24.3 認證模組 24.4 Prisma Schema 24.5 Redis 快取與 BullMQ 工作佇列 24.6 Docker Compose(完整開發環境) 24.7 GitHub Actions CI/CD 24.8 監控與 Logging 整合 24.9 Order Module 完整實作 24.10 完整測試範例 第 25 章:Appendix 25.1 CLI 常用指令速查表 25.2 Debug 技巧 25.3 VS Code 推薦設定 25.4 推薦套件與學習資源 附錄:檢查清單(Checklist) A. 新專案啟動檢查清單 B. Code Review 檢查清單 C. 上線前檢查清單 D. 日常維運檢查清單 E. 安全性檢查清單 第 1 章:Node.js 簡介 1.1 Node.js 是什麼 定義 Node.js 是一個基於 Chrome V8 引擎 的 JavaScript 執行環境(Runtime),讓 JavaScript 能夠脫離瀏覽器在伺服器端執行。它採用 事件驅動(Event-driven) 與 非阻塞 I/O(Non-blocking I/O) 模型,特別適合建構高併發、I/O 密集型的網路應用程式。 ...

February 4, 2026 · 144 min · 30582 words · Eric Cheng

JQuery教學手冊

jQuery 教學手冊 版本:jQuery 4.0+ 適用對象:具備 JavaScript 基礎的工程師 文件性質:企業內部技術文件 最後更新:2026 年 2 月 目錄 第一部分:基礎概念 jQuery 簡介與定位 1.1 jQuery 的核心理念 1.2 為何在現代系統中仍需要 jQuery 1.3 jQuery 與原生 JavaScript 的差異 1.4 jQuery 4.0 重大變更 環境準備與版本建議 2.1 jQuery 版本說明 2.2 CDN 安裝方式 2.3 本地安裝方式 2.4 專案目錄結構建議 2.5 與 HTML5 / ES6 的搭配 2.6 瀏覽器相容性 jQuery 核心語法與觀念 3.1 $() 選擇器原理 3.2 常用選擇器 3.3 Traversing(遍歷) 3.4 Chaining 設計模式 3.5 jQuery Object vs DOM Object 第二部分:核心操作 DOM 操作實戰 ...

February 4, 2026 · 30 min · 6189 words · Eric Cheng

C++語言教學手冊

C++ 語言教學手冊 版本: 1.0 最後更新: 2026年2月 適用對象: 主機系統開發團隊 技術層級: 基礎至進階 目錄 前言與學習指引 1.1 本手冊目的 1.2 學習路徑圖 1.3 主機系統開發的特殊考量 C++ 基礎語法與概念 2.1 程式結構 2.2 基本資料型別 2.3 變數與常數 2.4 運算子 2.5 控制流程 2.6 函式 2.7 實務案例:設定檔解析器 2.8 注意事項與最佳實踐 物件導向程式設計 (OOP) 3.1 類別基礎 3.2 繼承 3.3 多型 3.4 抽象類別與介面 3.5 組合優於繼承 3.6 實務案例:訂單處理系統 3.7 注意事項與最佳實踐 記憶體管理 4.1 記憶體模型概觀 4.2 指標基礎 4.3 智慧指標 4.4 RAII 原則 4.5 記憶體效能優化 4.6 實務案例:連線池 4.7 注意事項與最佳實踐 STL 標準模板庫 ...

February 3, 2026 · 91 min · 19179 words · Eric Cheng

Cobol教學手冊(2)

Cobol教學手冊(2) 版本:2.0 最後更新:2026 年 2 月 適用對象:具備基礎程式設計經驗的開發人員、需要轉換到主機 COBOL 開發的工程師、團隊新進成員 📚 目錄 第一章:COBOL 概述 1.1 COBOL 歷史與發展 1.2 COBOL 在現代企業系統中的角色 1.3 COBOL 與其他語言的比較 1.4 主機環境介紹 第二章:開發環境設置 2.1 主機連線與登入 2.2 TSO/ISPF 基本操作 2.3 JCL 基礎 2.4 開發工具介紹 2.5 現代開發環境設置 第三章:COBOL 語法基礎 3.1 程式結構 3.2 資料型別與變數宣告 3.3 PICTURE 子句詳解 3.4 LEVEL 編號系統 第四章:基本程式設計 4.1 資料處理 4.2 條件判斷 4.3 迴圈控制 4.4 字串處理 第五章:檔案處理 5.1 循序檔案(Sequential File) 5.2 索引檔案(INDEXED File / VSAM KSDS) 5.3 相對檔案(Relative File) 5.4 檔案操作 第六章:進階主題 6.1 COPYBOOK 的使用與管理 6.2 副程式呼叫 6.3 資料庫存取 6.4 CICS 交易處理基礎 6.5 錯誤處理與除錯技巧 第七章:最佳實踐 7.1 程式碼撰寫規範 7.2 命名慣例 7.3 註解撰寫標準 7.4 效能優化建議 7.5 維護性考量 第八章:實戰範例 8.1 簡單報表程式 8.2 檔案更新程式 8.3 批次處理程式 8.4 線上交易程式(CICS) 第九章:故障排除 9.1 常見編譯錯誤 9.2 執行時期錯誤 9.3 除錯技巧與工具 附錄 附錄 A:COBOL 保留字清單 附錄 B:常用 JCL 範例 附錄 C:錯誤訊息對照表 附錄 D:學習資源與參考文獻 檢查清單 第一章:COBOL 概述 學習目標 完成本章後,您將能夠: ...

February 3, 2026 · 51 min · 10862 words · Eric Cheng

C語言教學手冊

C 語言教學手冊 版本:1.0 最後更新:2026 年 2 月 適用對象:具備基礎程式設計概念,需進行系統層級開發的工程師 目錄 第一章:C 語言基礎 1.1 C 語言概述與開發環境 1.2 資料型別與變數 1.3 運算子與表達式 1.4 控制流程 1.5 函數定義與呼叫 第二章:記憶體管理 2.1 指標基礎與進階應用 2.2 動態記憶體配置 2.3 記憶體洩漏預防 2.4 常見陷阱與最佳實踐 第三章:資料結構 3.1 陣列與字串處理 3.2 結構體與聯合 3.3 鏈結串列 3.4 堆疊與佇列實作 第四章:系統程式設計 4.1 檔案 I/O 操作 4.2 錯誤處理機制 4.3 多檔案專案組織 4.4 Makefile 使用 第五章:進階主題 5.1 函數指標 5.2 前置處理器與巨集 5.3 位元操作 5.4 多執行緒基礎 第六章:開發規範與最佳實踐 6.1 命名規範 6.2 程式碼風格指南 6.3 除錯技巧 6.4 效能優化建議 附錄:檢查清單 第一章:C 語言基礎 1.1 C 語言概述與開發環境 1.1.1 為什麼選擇 C 語言 C 語言自 1972 年由 Dennis Ritchie 在貝爾實驗室開發以來,至今仍是系統程式設計的首選語言: ...

February 3, 2026 · 69 min · 14526 words · Eric Cheng

Cobol教學手冊

COBOL 教學手冊 版本:1.0 最後更新:2026 年 2 月 適用對象:新進工程師、有現代語言背景但未接觸主機系統的工程師 定位:企業內部實務教學手冊 目錄 第一章:COBOL 與主機系統概覽 1.1 為什麼 COBOL 至今仍被大量使用 1.2 COBOL 在大型主機系統中的角色 1.3 Batch 系統 vs Online 系統(CICS) 1.4 COBOL 與資料庫(DB2)/ 檔案系統的關係 第二章:COBOL 程式基本結構 2.1 COBOL Program Structure 總覽 2.2 IDENTIFICATION DIVISION 2.3 ENVIRONMENT DIVISION 2.4 DATA DIVISION 2.5 PROCEDURE DIVISION 2.6 基本程式範例(可編譯) 第三章:資料型態與資料結構 3.1 PIC 語法完整說明 3.2 數值型、文字型、符號位(SIGN) 3.3 REDEFINES 與 OCCURS 3.4 Working-Storage vs Linkage Section 3.5 常見錯誤與陷阱 第三章小結 第四章:檔案處理(主機實務重點) 4.1 Sequential File 基本操作 4.2 READ / WRITE / OPEN / CLOSE 4.3 EOF 控制寫法 4.4 檔案 Layout(Record Layout)設計原則 4.5 實務範例(Batch 檔案讀寫) 第五章:批次程式(Batch Job)設計 5.1 Batch 程式生命週期 5.2 Return Code(RC)設計原則 5.3 程式錯誤處理與異常控制 5.4 批次程式撰寫範例 5.5 可維運的 Batch 設計 Best Practice 第六章:與資料庫(DB2)互動 6.1 Embedded SQL 基本概念 6.2 SELECT / INSERT / UPDATE / DELETE 範例 6.3 SQLCODE / SQLSTATE 處理方式 6.4 資料一致性的觀念(Commit / Rollback) 第七章:COBOL 程式設計規範 7.1 命名規則(Program / Variable / Paragraph) 7.2 排版與可讀性原則 7.3 註解撰寫建議 7.4 避免「維護地獄」的寫法 7.5 常見 Anti-pattern 第八章:舊系統維護與現代化觀點 8.1 如何「讀懂」舊 COBOL 程式 8.2 如何安全修改老程式 8.3 與現代系統整合概念 8.4 COBOL 在未來系統中的定位 第九章:新手常見問題(FAQ) Q1:為什麼 COBOL 看起來這麼冗長? Q2:為什麼不把 COBOL 改成 Java? Q3:初學者最容易踩的雷? Q4:如何有效學習與除錯 COBOL? Q5:主機環境和 PC 開發有什麼不同? Q6:COBOL 還有未來嗎? 附錄 A:COBOL 開發檢查清單(Checklist) 程式開發前檢查 程式撰寫檢查 檔案處理檢查 資料庫處理檢查 錯誤處理檢查 測試前檢查 上線前檢查 附錄 B:常用 COBOL 關鍵字速查表 資料定義關鍵字 流程控制關鍵字 資料操作關鍵字 檔案操作關鍵字 附錄 C:SQLCODE 常見錯誤碼對照表 成功與警告代碼 常見錯誤代碼 錯誤處理範例 結語 第一章:COBOL 與主機系統概覽 1.1 為什麼 COBOL 至今仍被大量使用 COBOL 的歷史地位 COBOL(COmmon Business-Oriented Language)誕生於 1959 年,是專為商業應用設計的程式語言。至今已超過 65 年歷史,但仍在全球金融、保險、政府機構中扮演核心角色。 ...

February 3, 2026 · 39 min · 8149 words · Eric Cheng

Spring Boot 4.x升版教學

Spring Boot 4.x升版教學 文件資訊 項目 說明 文件名稱 Spring Boot 4.x 升版教學(企業標準技術白皮書) 版本 2.0 更新日期 2026-11-18 作者 技術團隊 目標對象 已有 Spring Boot 2.x/3.x 實務經驗的工程師、Tech Lead、架構師、負責審查 AI 產出升版程式碼的 Reviewer 生產基準 Spring Boot 4.1.2(Spring Framework 7.0.10、Spring Security 7.1.2、Spring Data 2026.0.2) 升版起點 Spring Boot 3.5.16(3.5.x 最新 patch) 前瞻基準 🔭 Spring Boot 4.2.0-RC2(官方預定 2026-11 發布 GA) Java 版本 最低 Java 17;建議 Java 21 或 25(LTS) 驗證狀態 書中標示「✅ 已驗證」的範例,都放在同一個範例專案裡實際編譯並執行過測試,紀錄見附錄 C 如何閱讀本手冊 這份手冊的目標是讓你能自己完成升版,也能審查 AI 產出的升版修改。寫法固定是:先說明規則與原因,再給驗證過的範例,最後給檢查方法。 標記 意義 【4.0】 Spring Boot 4.0 開始的變更,從 3.x 升上來一定會遇到 【4.1】 Spring Boot 4.1 新增或變更(4.1 已移除所有 4.0 標為棄用的 API) 🔭【4.2】 4.2 里程碑/RC 的內容,GA 前可能再變動,不要直接用在生產環境 ✅ 已驗證 範例檔案直接取自附錄 C 的驗證專案,已用 Maven 編譯並通過測試 ❌ 反例 常見錯誤寫法,附錄 C.4 證明它在 4.1.2 會編譯失敗或測試失敗 每一章最後都有「審查與驗證清單」,欄位固定為:檢查項目/如何驗證(指令)/預期結果/常見 AI 錯誤。Reviewer 可以直接照表操作。 ...

January 30, 2026 · 66 min · 13959 words · Eric Cheng

雲端原生運算生態系教學手冊

雲端原生運算生態系教學手冊 版本:1.0 最後更新:2026 年 1 月 適用對象:資深工程師、系統架構師、SRE / DevOps 工程師、技術主管 定位:企業內部標準教材 文件維護:內部技術團隊 使用情境:大型企業 / 銀行內部系統 最後更新: 2026年1月30日 適用於: 雲端原生運算生態系 Created by: Eric Cheng 目錄 1. 雲端原生運算概論 1.1 什麼是 Cloud Native 1.2 與傳統架構的差異 1.3 CNCF 的角色與定位 1.4 CNCF Landscape 全景圖說明 1.5 雲端原生帶來的價值與挑戰 2. 雲端原生系統整體架構 2.1 典型雲端原生參考架構 2.2 核心分層說明 2.2.1 基礎設施層(Infrastructure Layer) 2.2.2 容器層(Container Runtime Layer) 2.2.3 編排層(Orchestration Layer) 2.2.4 平台層(Platform Layer) 2.2.5 可觀測性(Observability Layer) 2.2.6 安全層(Security Layer) 2.3 微服務與事件驅動架構 3. CNCF 核心專案分類與說明 3.1 Container & Runtime 3.2 Orchestration & Management 3.3 Networking 3.4 Service Mesh 3.5 API Gateway & Ingress 3.6 Observability 3.7 Logging 3.8 Security 3.9 CI/CD 3.10 Storage 3.11 Messaging & Streaming 4. 系統安裝與基礎環境建置 4.1 雲端原生平台建置方式比較 4.2 Managed Kubernetes 比較 4.3 Self-Managed Kubernetes 安裝(kubeadm) 4.4 必要 Add-ons 安裝建議 4.5 開發、測試、正式環境差異設計 5. 系統設定與組態管理 5.1 Kubernetes Namespace 與 RBAC 設計 5.2 ConfigMap / Secret 使用方式 5.3 Helm 與 Kustomize 的角色 5.4 GitOps 架構(以 Argo CD 為例) 5.5 環境參數與設定管理策略 6. 雲端原生系統使用方式 6.1 應用程式容器化流程 6.2 Deployment / StatefulSet 使用情境 6.3 Service / Ingress / Gateway 設計 6.4 自動擴縮(HPA / VPA) 6.5 Rolling Update 與 Zero Downtime Deployment 7. 系統維運與可觀測性 7.1 Metrics、Logs、Traces 的角色 7.2 Prometheus + Grafana 架構 7.3 OpenTelemetry 導入方式 7.4 告警(Alerting)設計原則 7.5 SRE 常用監控指標(SLI / SLO / SLA) 8. 系統安全與治理 8.1 雲端原生安全風險概覽 8.2 Kubernetes Security Best Practices 8.3 Image Security 與 Supply Chain Security 8.4 Policy as Code(OPA / Kyverno) 8.5 零信任(Zero Trust)在雲端原生的應用 9. 系統升級與版本管理 9.1 Kubernetes 升級策略 9.2 CNCF 元件相容性考量 9.3 滾動升級與回滾機制 9.4 升級風險與因應方式 10. 應用系統如何串接雲端原生平台 10.1 傳統系統(Legacy System)上雲策略 10.2 API-based 系統整合 10.3 Event-driven 架構串接方式 10.4 Database、MQ、外部系統整合模式 10.5 金融/企業系統常見整合案例 11. 企業實務建議與最佳實踐 11.1 雲端原生導入常見地雷 11.2 組織與流程調整建議 11.3 開發、維運、資安協作模式 11.4 技術選型建議 11.5 成熟度模型(Cloud Native Maturity Model) 12. 檢查清單(Checklist) 12.1 叢集建置檢查清單 12.2 應用部署檢查清單 12.3 可觀測性檢查清單 12.4 安全檢查清單 12.5 維運檢查清單 附錄 附錄 A:常用 kubectl 指令速查 附錄 B:參考資源 1. 雲端原生運算概論 1.1 什麼是 Cloud Native Cloud Native(雲端原生) 是一種建構和運行應用程式的方法,充分利用雲端運算模型的優勢。根據 CNCF(Cloud Native Computing Foundation)的定義: ...

January 30, 2026 · 30 min · 6212 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

Kong API Gateway教學手冊

Kong API Gateway教學手冊 項目 內容 文件版本 2.0(企業標準技術白皮書版) 最後更新 2026-09-30 版本基準(雙軌) Kong Gateway OSS 3.9.3(開源最終發行版,所有實作範例的基準)/Kong Gateway Enterprise 3.16.0.0(最新版)與 3.14 LTS 周邊工具基準 decK 1.67.0、Kong Operator 2.3.x、Kong Ingress Controller 3.5 LTS、Helm chart kong/kong 3.4.x 適用對象 後端工程師、系統架構師、平台/DevOps/SRE 工程師、資安人員 定位 企業內部 API Gateway 標準教材與導入參考 文件維護 內部技術團隊(Created by Eric Cheng) 🆕 v2.0 改版重點 版本基準改為雙軌:Kong 自 3.10 起不再發布 OSS 的 Docker image 與安裝套件,OSS 最後一版是 3.9.3。Enterprise 已經推進到 3.16,並在 3.15 起改成「沒有授權時 Admin API 唯讀」。本版把所有可以免授權執行的範例統一在 OSS 3.9.3 上,Enterprise 的差異集中在第 1.4、10、11、13 章說明。 修正 v1.0 的錯誤設定:已淘汰的 redis_host、KongIngress、config.endpoint(OpenTelemetry)、flush_timeout(HTTP Log)、decK 舊命令、Plugin 優先序規則等,完整清單請見附錄 D.2。 新增章節:第 11 章「安全強化」、第 13 章「AI Gateway 與 MCP」、附錄 C「常見問答」、附錄 D「版本紀錄」、附錄 E「查證紀錄」。 每章結尾新增「💡 本章實務建議」;新增的段落標示為 🆕,更正的段落標示為 ⚠️。 閱讀指引 讀者角色 建議閱讀順序 重點章節 初次接觸 Kong 的工程師 1 → 3 → 4 → 5 → 6 3.2 常見部署方式、5.1 建立第一個 API 系統架構師 1 → 2 → 10 → 11 → 12 1.4 產品矩陣與授權變化、2.2 部署拓樸 平台/SRE 工程師 3 → 8 → 9 → 10 → 15 9.1 decK 與 APIOps、10.4 升級策略 資安人員 6 → 11 → 15.4 11.1 Admin API 保護 AI 平台團隊 1.5 → 13 13.2 以 OSS AI Proxy 串接 LLM 📌 標示說明:OSS 表示 Kong Gateway 開源版(3.9.3)即可使用;EE 表示需要 Kong Gateway Enterprise 授權或 Konnect;DB-less ✅/❌ 表示該 Plugin 是否支援 DB-less 模式。 ...

January 30, 2026 · 70 min · 14808 words · Eric Cheng