部署上線
從正式環境設定與 Cloudflare 資源，到正式網域、業務驗收與後續更新，完成網站上線。
前面的章節已介紹服務申請、專案建立、業務開發和功能設定。本章將這些內容串成一次完整發布：確認部署目標、準備正式環境設定、發布程式碼與資料，再於正式網域上驗證實際業務流程。
如果你已跟著首次部署將專案部署到 workers.dev，可以直接準備正式環境設定並執行更新，不必重新建立 Cloudflare 資源。跟著 WebpageToPDF 實作教學操作的讀者，還需要先部署自己新增的 PDF Worker 等業務相依服務。
本章保留哪些內容
部署分成六項工作。上線前檢查放在正式環境設定和驗收流程中，第三方回呼與網域切換一起說明，發布後的觀察與故障處理則放在最後一篇。
| 順序 | 文章 | 解決的問題 |
|---|---|---|
| 1 | 確認部署環境與 Cloudflare 資源 | 帳戶、Worker、D1、KV、R2 和 Queue 各是什麼，哪些由指令碼建立 |
| 2 | 準備正式環境設定與金鑰 | 哪些設定需要在上線前替換，如何同步環境變數 |
| 3 | 管理正式環境資料庫與內容 | 資料庫初始化、增量遷移、備份和文件同步如何配合 |
| 4 | 首次部署與後續更新 | 選擇正確指令，了解執行順序和中斷後的處理方式 |
| 5 | 正式網域與第三方回呼 | 切換網站網址，同步登入、付款、Turnstile 和郵件設定 |
| 6 | 上線驗收與日常維護 | 驗證關鍵流程、觀察背景工作、處理發布故障 |
依目前狀態選擇入口
| 目前狀態 | 下一步 |
|---|---|
| 只有本機專案，尚未建立遠端資源 | 準備正式環境設定後執行 npm run deploy:init |
已有可存取的 workers.dev 網站 | 核對資源和設定，準備綁定正式網域 |
| 已部署且已有正式網域 | 修改程式碼或正式環境設定後執行 npm run deploy:update |
| 上次指令執行到一半失敗 | 先確認失敗階段和遠端狀態，再依中斷處理繼續操作 |
首次部署、更新和網域切換，並不是同一個指令的不同寫法。它們檢查的前提、修改的資源與執行順序都不同，後文會分別說明。
本章指令都在使用 Saavo 建立的應用程式根目錄執行。範例的正式網址統一使用 https://app.example.com，請替換成自己的網域。涉及遠端資源的指令會明確說明，不要混淆本機偵錯與正式環境操作。
部署完成與正式開放
終端機顯示部署成功，表示指令碼中的建置、發布和檢查已完成。註冊郵件是否送達、使用者付款後是否取得權益，以及業務工作是否執行成功，仍需要透過實際流程驗證。
建議先在測試環境完成功能驗證，再部署正式設定，最後依驗收清單開放註冊和收款。後續每次更新，也可以沿用同一套步驟檢查受影響的功能。