教學

GitLab 使用教學手冊 項目 內容 文件版本 3.0 最後更新 2026 年 9 月 30 日 適用版本 GitLab 19.4（2026-09-17 發布，最新修補版 19.4.1）；GitLab Runner 19.4.1；glab 1.120.0；Git 2.56.0 向下相容 主要內容適用 GitLab 18.x 以上；各章以「🆕／⚠️」標示版本差異 適用對象 新進與資深開發人員、Tech Lead、DevOps／平台工程、資安與稽核人員、GitLab 管理員 文件定位 企業標準技術白皮書／內部 GitLab 標準教材 使用情境 企業內部 Java（Spring Boot）專案、多團隊協作、受監理產業（金融、醫療、公部門） 文件維護 內部技術團隊 ⚠️ v3.0 重大改版說明：本版以 GitLab 19.4 與 docs.gitlab.com 官方文件為基準，逐章查證並改寫。v2.0 中已被淘汰或有誤的內容都已更正，包括：Runner 以 --registration-token 註冊、only:／except: 語法、已移除的 License-Scanning 範本、openjdk 映像檔、錯誤的 codequality／dependency_scanning 報表格式、錯誤的 CI/CD 變數優先順序，以及虛構的 CI 報表類型與命令列工具。同時新增 CI/CD Components 與 Catalog、id_tokens（OIDC）、Merge Trains、CODEOWNERS 與核准規則、Secret Push Protection、安全政策、GitLab agent for Kubernetes、GitLab Duo 與 Duo Agent Platform、升級路徑與 19.0 重大變更等章節。完整更正清單見附錄 D：版本更新紀錄，查證來源見附錄 E：查證紀錄。 ...

專案 Git 教學手冊 項目 內容 文件版本 3.0 最後更新 2026 年 9 月 29 日 適用版本 Git 2.56.x（2026-09-28 發布）；Git for Windows 2.56.0；向下相容 Git 2.40 以上 適用對象 新進與資深開發人員、Tech Lead、DevOps／平台工程、資安與稽核人員 文件定位 企業標準技術白皮書／內部 Git 標準教材 使用情境 大型企業、金融業（銀行、證券、保險）內部 Java 專案與多團隊協作 文件維護 內部技術團隊 Created by Eric Cheng ⚠️ v3.0 重大改版說明：本版以 Git 2.56（2026-09-28）與 git-scm.com 官方文件為基準逐章查證改寫。v2.0 內容中已淘汰的 Husky husky install／husky add 用法、git filter-branch 移除敏感資料、舊式 core.sparseCheckout 設定、過時的 Maven 外掛座標與版本、錯誤的 gh api 分支保護範例等均已更正；並新增 Git 物件模型、分支策略選型、Rulesets、SSH 簽署、秘密掃描、git maintenance／scalar、企業治理與 Git 3.0 升級準備 等章節。完整更正清單請見附錄 D：版本更新紀錄，查證來源請見附錄 E：查證紀錄。 ...

Hexagonal Architecture 設計教學手冊 📚 文件說明 本教學手冊旨在幫助新進同仁快速理解和應用 Hexagonal Architecture（六邊形架構）。透過循序漸進的方式，從基礎概念到實務應用，讓團隊成員能夠有效地運用這種架構模式進行軟體開發。 🎯 學習目標 理解 Hexagonal Architecture 的核心概念與設計理念 掌握 Ports & Adapters 模式的實作技巧 學會在實際專案中導入六邊形架構 提升程式碼的可測試性與可維護性 建立與團隊協作的共同語言 📖 目錄 Part 1. 基礎概念 認識 Hexagonal Architecture（六邊形架構） 1.1 Hexagonal 的由來與核心理念 1.2 與傳統分層架構的比較 1.3 Ports & Adapters 模式的核心概念 Hexagonal Architecture 的設計目標 2.1 解耦業務邏輯與基礎設施 2.2 減少技術債務與提升可測試性 2.3 支援 Domain-Driven Design 的角色 Hexagonal 與其他架構模式的關係 3.1 與 Clean Architecture 的異同 3.2 與 Onion Architecture 的異同 3.3 適用場景與限制 Part 2. 核心組件與實作模式 Ports & Adapters 詳解 4.1 定義與職責 4.2 輸入 Port / 輸出 Port 4.3 主動 Adapter / 被動 Adapter Domain 層的角色 ...

HTML5 與 CSS3 程式語言教學手冊 目錄 前言 開發環境設定 HTML5 開發規範 CSS3 開發規範 專案中的命名規則與檔案結構 CSS 動畫與轉場效果 HTML5 新特性與 API JavaScript 整合與互動 網頁無障礙設計 常見錯誤與解決方法 開發最佳實務 範例程式碼 結語 檢查清單 1. 前言 1.1 HTML5 與 CSS3 在專案中的角色 HTML5 和 CSS3 是現代網頁開發的基石，在我們的專案中扮演著至關重要的角色： HTML5 的角色 結構定義者：負責網頁內容的語意化結構 互動基礎：提供表單、多媒體等互動元素 可及性保障：確保網站對所有使用者都能順利存取 SEO 基礎：良好的 HTML 結構有助於搜尋引擎優化 CSS3 的角色 視覺呈現：控制網頁的外觀與佈局 使用者體驗：創造流暢的動畫與互動效果 響應式設計：確保在各種裝置上都有良好的顯示效果 效能優化：減少不必要的圖片使用，提升載入速度 1.2 重要性 在現代網頁開發中，HTML5 和 CSS3 的重要性體現在： 標準化：遵循 W3C 標準，確保跨瀏覽器相容性 可維護性：良好的結構和命名規則讓程式碼易於維護 效能：正確使用能大幅提升網頁載入速度 可及性：符合無障礙設計標準，服務更多使用者 SEO 優化：語意化的 HTML 有助於搜尋引擎理解內容 2. 開發環境設定 2.1 必要工具 2.1.1 程式碼編輯器 推薦：Visual Studio Code ...

IntelliJ IDEA 使用教學手冊（原 Community Edition／統一版免費功能） 文件資訊 項目 內容 文件版本 2.0 最後更新 2026-10-01 版本基準 IntelliJ IDEA 2026.2.3（build 262.10968.63，2026-09-16）統一版的免費功能；Ultimate 訂閱功能以 🔒 標示。相容性矩陣見 1.5 版本基準與相容性矩陣 文件定位 企業標準技術白皮書／內部標準教材：Java 後端團隊使用 IntelliJ IDEA 的安裝部署、環境設定、日常開發、版本控制、建置除錯、測試品質、AI 輔助、效能維運與團隊治理 適用對象 Java 後端新進人員、資深工程師、技術主管、開發環境管理員（IT／DevOps）、資安與稽核人員 前置知識 Java 基礎語法、Maven 或 Gradle 基本概念、Git 基本操作 產品沿革 IntelliJ IDEA Community Edition 自 2025.3 起併入統一版 IntelliJ IDEA，不再單獨發行，詳見 1.1 產品沿革：從 Community Edition 到統一版 前一版本 1.0（2025-08-29，以 IntelliJ IDEA Community Edition 2023.3 為基準） Created by Eric Cheng 📌 v2.0 改版重點：章節重新編排為 17 章與 5 個附錄，以統一版 IntelliJ IDEA 2026.2.3 為基準。 ...

Java 程式語言教學手冊 目錄 Java 語言簡介 1.1 Java 的歷史與特性 1.2 為什麼專案使用 Java 1.3 Java 認證路線簡介 1.4 認證考點提醒 1.5 小練習 開發環境與工具 2.1 JDK 安裝（Java 21） 2.2 IDE 設定 2.3 Build 工具 2.4 認證考點提醒 2.5 小練習 Java 基礎語法 3.1 Hello World 程式 3.2 基本資料型別、變數、常數 3.3 運算子與型別轉換 3.4 流程控制 3.5 陣列操作 3.6 字串處理 3.7 認證考點提醒 3.8 小練習 物件導向程式設計 (OOP) 4.1 類別與物件 4.2 建構子與方法 4.3 繼承 (Inheritance) 4.4 多型 (Polymorphism) 4.5 封裝 (Encapsulation) 4.6 抽象類別與介面 4.7 認證考點提醒 4.8 小練習 核心 API 與工具 5.1 集合框架 (Collections Framework) 5.2 泛型 (Generics) 5.3 日期時間 API 5.4 檔案 I/O 操作 5.5 正規表達式 5.6 認證考點提醒 5.7 小練習 例外處理與錯誤管理 6.1 例外處理機制 6.2 自訂例外 6.3 最佳實務 6.4 認證考點提醒 6.5 小練習 進階語法與認證內容 ...

Jenkins CI/CD 教學手冊 文件資訊 項目 內容 文件版本 2.0 最後更新 2026-10-02 版本基準 Jenkins LTS 2.580.1（2026-09-30）、Java 21／25（controller 與所有 agent）、Helm chart jenkins 5.9.64、plugin 版本以 2026-10-02 的 update center 為準；完整矩陣見 1.4 版本基準與相容性矩陣 文件定位 企業標準技術白皮書／內部標準教材：Jenkins 的規劃、安裝、Pipeline 開發、分散式建置、部署、安全、組態即程式碼、監控、備份升級與供應鏈安全 適用對象 新進 Java 開發人員（第 1–13 章）、DevOps／平台工程師、系統管理員、架構師、資安與稽核人員 前置知識 Java 與 Maven 基礎、Git、Linux 指令列、容器基本概念；第 14 章以後需要 Kubernetes 基本概念 姊妹文件 《git使用教學》、《Kubernetes教學手冊》、《Podman使用教學》、《Prometheus與Grafana教學手冊》、《OpenTelemetry教學手冊》、《GitLab使用教學》、《github使用教學》 前一版本 1.0（2024-03-10，以 Jenkins LTS 2.401.x、JDK 11／17 為基準） Created by Eric Cheng 📌 v2.0 改版重點：章節重新編排為 24 章與 9 個附錄，全面對齊 Jenkins LTS 2.580.1。 ...

Linux 使用教學 專案開發環境導向 + 認證準備指南 適用於 Java 開發專案團隊的 Linux 學習手冊 📋 目錄 1. 前言 1.1 本手冊目的 1.2 適用對象 1.3 專案環境說明 1.4 學習方法與建議 2. Linux 基礎概念 2.1 Linux 與開源精神簡介 2.2 Linux 系統架構 2.3 檔案系統階層結構 2.4 使用者與群組管理 2.5 檔案與目錄權限 3. Linux 常用指令 3.1 檔案與目錄操作 3.2 檔案檢視與搜尋 3.3 檔案壓縮與解壓縮 3.4 權限管理 3.5 程序管理 3.6 網路工具 3.7 軟體管理 4. 開發環境操作 4.1 安裝與設定 JDK 4.2 安裝與設定 Python 4.3 安裝與設定 Node.js 4.4 資料庫客戶端 4.5 使用 Git 與 GitLab/GitHub 4.6 容器化開發工具 4.7 Maven/Gradle 編譯與部署 5. 專案日常任務 5.1 SSH 遠端登入 5.2 檔案傳輸 5.3 Log 查詢與分析 5.4 錯誤排查技巧 5.5 排程任務 6. Linux 系統安全與最佳實務 6.1 sudo 與使用者權限控管 6.2 SSH 安全性 6.3 防火牆設定 6.4 SELinux / AppArmor 基本操作 7. CI/CD 與 Linux 整合 7.1 Jenkins 於 Linux 的安裝與設定 7.2 Jenkins Pipeline 與 Shell Script 7.3 Linux 與容器整合 7.4 自動化部署流程範例 8. Linux 認證導向補充 8.1 認證體系概覽 8.2 LFCS (Linux Foundation Certified System Administrator) 8.3 RHCSA (Red Hat Certified System Administrator) 8.4 LPI (Linux Professional Institute) 認證 8.5 認證準備策略 9. 附錄與總結 9.1 學習路徑總結 9.2 常見問題與解答 (FAQ) 9.3 實務檢查清單 9.4 進階學習資源 9.5 職涯發展指南 9.6 結語與展望 1. 前言 1.1 本手冊目的 📖 為什麼需要這份手冊？ ...

Microservices Architecture 設計教學手冊 版本： 1.0 更新日期： 2025年9月20日 適用對象： 新進開發同仁 編寫者： 系統架構師團隊 📖 手冊簡介 本手冊是為新進開發同仁設計的微服務架構（Microservices Architecture）實務教學文件。透過系統性的學習路徑，幫助開發人員從零基礎逐步掌握微服務設計與實作技能。 🎯 學習目標 完成本手冊學習後，您將能夠： 理解微服務架構的核心概念與設計原則 掌握微服務拆分與邊界劃分技巧 熟練應用各種微服務設計模式 具備實際專案開發與維護能力 通過相關技術認證考試 🚀 使用方式 循序漸進：按照章節順序學習，每章都有前置知識 理論實作並重：理解概念後立即進行實作練習 檢查清單驗證：每章結束使用檢查清單自我驗證 團隊討論：與同事分享學習心得，加深理解 📚 目錄 Part I. 基礎認識 1. 微服務架構簡介 1.1 為什麼需要微服務 1.2 單體架構 vs. 微服務架構 1.3 微服務的核心特徵 1.4 適用與不適用場景 2. 微服務與業界標準 2.1 SOA 與微服務的差異 2.2 Cloud Native 與微服務 2.3 與 Microservices Architecture 認證的關聯 Part II. 微服務設計原則 3. 微服務設計的基本原則 3.1 單一職責原則 (SRP) 3.2 高內聚、低耦合 3.3 獨立部署與擴展 3.4 容錯與恢復能力 4. 微服務邊界劃分 4.1 領域驅動設計 (DDD) 基礎 4.2 限界上下文 (Bounded Context) 4.3 服務拆分策略 Part III. 技術架構 5. 微服務通訊模式 5.1 同步通訊 5.2 非同步通訊 5.3 事件驅動架構 6. 資料管理策略 7. 配置與服務發現 Part IV. 微服務設計模式 8. 分解模式 8.1 Database per Service Pattern 8.2 Strangler Fig Pattern 8.3 Self-Contained Service Pattern 9. 通訊模式 9.1 API Gateway Pattern 9.2 Backend for Frontend (BFF) Pattern 10. 資料管理模式 10.1 Saga Pattern 10.2 CQRS Pattern 10.3 Event Sourcing Pattern 11. 可靠性模式 11.1 Circuit Breaker Pattern 11.2 Retry Pattern 11.3 Bulkhead Pattern Part V. 跨領域關注點 12. 安全性架構 12.1 身份驗證與授權 12.2 資料保護與加密 13. 監控與可觀察性 13.1 分散式追蹤 13.2 指標收集與監控 13.3 健康檢查與服務探測 14. 配置管理 14.1 集中化配置管理 14.2 功能開關 (Feature Toggles) Part VI. DevOps 與微服務 15. CI/CD 流水線 16. 容器化與 Kubernetes 17. Infrastructure as Code Part VII. 實戰指南 18. 微服務專案規劃 19. 實作步驟與最佳實務 20. 測試策略 21. 效能調優 Part VIII. 總結與資源 總結 最佳實務摘要 延伸學習資源 Part I. 基礎認識 1. 微服務架構簡介 1.1 為什麼需要微服務 🔍 單體架構的挑戰 在傳統的單體架構（Monolithic Architecture）中，整個應用程式被打包成一個單一的部署單元。隨著業務成長，會面臨以下問題： ...

Object-Relational Mapping (ORM) 物件關聯對映教學手冊 目錄 ORM 簡介 1.1 什麼是 ORM？ 1.2 為什麼需要 ORM？ 1.3 ORM 解決的問題 1.4 與 SQL/資料庫互動的關係 1.5 小結 ORM 的基本概念 2.1 實體 (Entity) 2.2 對應 (Mapping) 2.3 Session/EntityManager 2.4 Transaction (交易) 2.5 Lazy Loading vs Eager Loading 2.6 小結 ORM 工具與框架簡介 3.1 Java 生態系統 3.2 Python 生態系統 3.3 其他語言的 ORM 框架 3.4 ORM 框架比較 3.5 選擇 ORM 框架的考量因素 3.6 小結 安裝與設定 4.1 Java 環境設定 (Spring Boot + JPA) 4.2 Python 環境設定 (SQLAlchemy) 4.3 開發環境驗證 4.4 常見安裝問題與解決方案 4.5 小結 基本 CRUD 範例 ...