部署指南範本（Deployment Guide）

參照標準：ITIL 4 Release Management / ISO/IEC 20000-1:2018 第 8.5.2 節「Release management」
文件用途：提供系統部署的標準化步驟指引，確保可重複、可追蹤、可回滾的部署流程
適用階段：部署與上線階段（Release & Deployment）

📋 章節目錄

1. 文件資訊
2. 部署概述
3. 先決條件
4. 部署架構
5. 部署步驟
6. 驗證程序
7. 回滾程序
8. 監控確認
9. 聯絡窗口
10. 附錄

1. 文件資訊

📝 範本

版本歷程

📖 使用說明

• 依據 ITIL 4 Release Management 實務，每次部署需有正式的部署指南
• 文件需在部署前完成審核，未經核准不得執行部署
• 適用於所有環境（SIT / UAT / Staging / Production）部署

💡 範例

2. 部署概述

📝 範本

2.1 部署資訊摘要

2.2 變更內容摘要

2.3 部署風險評估

📖 使用說明

• 部署類型決定所需的審核層級與流程嚴格度
• Hotfix 可簡化流程但仍需記錄
• 預估停機時間需告知業務方，以便安排使用者通知

💡 範例

2.1 部署資訊摘要

3. 先決條件

📝 範本

3.1 核准與簽核

3.2 技術先決條件

3.3 部署所需權限

📖 使用說明

• 所有先決條件需在部署開始前全部確認（Checklist 全部打勾）
• 任何一項未完成則不得啟動部署
• 資料庫備份是最關鍵的先決條件，未備份禁止部署

💡 範例

3.2 技術先決條件

4. 部署架構

📝 範本

4.1 目標環境架構圖

{架構圖或 Mermaid 圖}

4.2 環境資訊

4.3 網路與防火牆規則

📖 使用說明

• 架構圖幫助部署人員理解全貌，建議使用 Mermaid 或繪製圖示
• 網路規則需在部署前確認已開通，避免部署後才發現連線失敗
• 機敏資訊（密碼、連線字串）不寫入文件，使用 Secret Manager 或變數引用

💡 範例

4.1 目標環境架構圖

Internet → Azure Front Door → AKS Ingress → Service
                                              ├── hrms-api (3 replicas)
                                              ├── hrms-worker (2 replicas)
                                              └── hrms-web (3 replicas)
                                                    ↓
                                    PostgreSQL (Azure DB for PostgreSQL)
                                    Redis (Azure Cache for Redis)
                                    Azure Blob Storage

5. 部署步驟

📝 範本

5.0 部署前通知

5.1 資料庫變更

5.2 應用程式部署

5.3 組態更新

5.4 流量切換

📖 使用說明

• 步驟需按執行順序排列，不可跳步
• 每步驟需有具體指令（可複製貼上執行）與預期結果
• 「確認者」在部署時簽名確認該步驟已完成
• 資料庫變更必須先於應用程式部署（確保 schema 相容）
• 機敏值（密碼）用環境變數或 Secret 引用，不寫死

💡 範例

5.2 應用程式部署

6. 驗證程序

📝 範本

6.1 Smoke Test（冒煙測試）

6.2 健康檢查

6.3 整合驗證

6.4 部署成功判定標準

📖 使用說明

• 驗證程序在部署完成後立即執行，決定是否接受本次部署
• Smoke Test 覆蓋核心業務路徑（如登入、主要功能），不需全面測試
• 若任何 P1 驗證失敗，立即啟動回滾程序

💡 範例

6.1 Smoke Test

6.2 健康檢查

7. 回滾程序

📝 範本

7.1 回滾觸發條件

7.2 回滾步驟

7.3 資料庫回滾

7.4 回滾後驗證

7.5 回滾時間預估

📖 使用說明

• 每次部署必須有回滾計畫，這是 ITIL 4 Release Management 的核心要求
• 回滾步驟需預先演練驗證，不可「部署當天第一次嘗試回滾」
• 資料庫回滾是最複雜的部分（若有 schema 變更），需特別規劃
• 藍綠部署的回滾最簡單：切回舊版流量即可

💡 範例

7.1 回滾觸發條件

7.2 回滾步驟（藍綠部署）

8. 監控確認

📝 範本

8.1 部署後監控期間

8.2 關鍵監控指標

8.3 日誌檢查項目

📖 使用說明

• 部署後加強監控是確保部署穩定的最後一道防線
• 監控期間內若指標異常，仍可啟動回滾
• 建議部署後 24 小時為加強監控期，48 小時後轉為一般監控

💡 範例

8.2 關鍵監控指標

9. 聯絡窗口

📝 範本

📖 使用說明

• 部署當天所有窗口需保持電話暢通
• 部署指揮負責 Go/No-Go 決策與回滾決定
• 建議建立即時通訊群組（如 Teams/Slack War Room）方便即時溝通

💡 範例

10. 附錄

📝 範本

10.1 部署 Checklist 總表

10.2 相關文件

10.3 術語定義

📖 使用說明

• Checklist 在部署當天使用，逐項確認並記錄時間
• 此 Checklist 同時作為部署紀錄保存，不可事後補填

💡 範例

10.1 部署 Checklist（已執行）

📌 範本使用注意事項

1. 本範本依據 ITIL 4 Release Management 與 ISO/IEC 20000-1:2018 編製
2. 正式環境部署需經 CAB 審核後方可執行
3. 回滾計畫為必填章節，未填寫不得核准部署
4. 部署完成後本文件作為部署紀錄歸檔保存
5. 搭配「運維手冊（Runbook）」使用，完成日常維運