部署、預覽與回復。
推送如何上線、分支預覽、回到先前版本、用於遷移的發布指令、建置設定、部署掛鉤、維護模式及預覽密碼。
應用程式上線後,您很少需要透過控制台發布變更:推送到分支,新版本就會自動上線。本文說明相關的一切——部署分頁、預覽、處理程序分頁,以及設定中的幾個開關。
每次推送自動部署
每次推送到應用程式的分支,都會建置最新的提交並部署。新版本會在執行中的版本旁啟動,待其回應後才開始接收訪客;若無法啟動,先前的版本會繼續運作,我們也會以電子郵件(若您已連接 Telegram,也會透過 Telegram)通知您。
若另一個建置仍在佇列中等待時又有新的推送,新推送會併入該建置,因此連續推送不會造成冗長的佇列。
您可以在設定 → 每次推送都部署關閉此功能。關閉後,請從控制台、API 或部署掛鉤進行部署。
從控制台部署
部署分頁列出每次部署:觸發來源(推送、控制台、回復、部署掛鉤)、提交、耗時及狀態。點選某次部署可查看完整的建置記錄。
重新部署提供兩種選擇:
- 建置最新的提交——取得分支上最新的程式碼並建置。
- 重新部署執行中的版本——套用變更後的變數,不重新建置。編輯變數後請使用此選項。
開啟旁的選單提供相同的兩個動作,另外還有重新啟動。
回復
您可以回到最近 5 個成功的版本中的任一個。在部署分頁,於想要的版本按回復並確認。先前的版本會在目前版本旁啟動,待其回應後接手——不會重新建置。
回復不會還原資料庫的變更。若某次發布變更了資料庫結構,請一併還原資料庫——請參閱資料庫。
分支預覽
推送到其他任何分支都會產生專屬預覽——一個獨立網址,讓您在上線前檢查變更。請在預覽分頁開啟。
- 同時最多 3 個預覽,已包含在價格中。
- 預覽若 7 天沒有新的推送就會移除。下次推送到該分支時會重新建立。
- 預覽只會取得專為預覽設定的變數——請參閱環境變數。
- 預覽只會為專案的主服務建立,不包含其他服務。
預覽密碼
在預覽分頁,預覽密碼 → 要求輸入密碼。輸入使用者名稱與密碼(至少 8 個字元)。此後只有知道密碼的人才能開啟預覽;應用程式本身仍對所有人開放。
發布指令(遷移)
處理程序分頁 → 發布指令。它會在每次部署時、新版本接收訪客之前執行一次——通常用於資料庫遷移。若執行失敗,部署會停止,目前的版本會繼續運作,因此有問題的遷移絕不會影響到您的訪客。
對於具備遷移指令的框架,我們會提供建議指令:
| 框架 | 建議的發布指令 |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
使用建議指令會保留該指令;您也可以輸入自己的指令,或選擇無。變更會從下次部署開始生效。
建置設定
設定 → 建置設定可讓您變更我們偵測到的設定:
- 安裝指令——例如
npm ci - 建置指令——例如
npm run build - 啟動指令——啟動應用程式的指令。應用程式必須監聽
$PORT中的連接埠。 - 輸出資料夾——靜態網站建置後檔案所在的資料夾。
- 專案資料夾——用於包含多個專案的儲存庫。
欄位留空即使用我們偵測到的設定。下次部署會以新設定建置;立即建置可馬上開始。
設定中也可以設定要部署的分支。
部署掛鉤
設定 → 部署掛鉤 → 建立掛鉤。部署掛鉤是一個私密網址:當其他服務向它發送 POST 請求時,會建置並部署您分支上的最新提交。常見用途是內容管理系統在您發布內容後重新建置網站。
curl -X POST "<控制台中的掛鉤網址>"- 網址只會顯示一次——請在建立掛鉤時複製。任何持有網址的人都能觸發部署,請妥善保密。
- 每個掛鉤每小時最多 10 次部署。若建置仍在等待時有新的呼叫,會併入該建置。
- 撤銷會立即停用網址;呼叫它的服務需要改用新網址。
維護模式
設定 → 維護模式 → 顯示維護頁面。訪客會看到顯示您訊息的簡短頁面,而非應用程式;訊息留空則顯示「我們正在進行一些改善,請稍後再回來看看。」
應用程式本身會繼續運作,讓您在重新開放前檢查一切。您的專屬連結可在開啟它的裝置上照常顯示應用程式,有效 12 小時。新連結會產生新的連結,舊連結隨即失效。
關閉開關即可重新對訪客開放應用程式。
部署通知
部署未完成時,我們會以電子郵件通知您(若您已連接 Telegram,也會傳送 Telegram 訊息)。若也想將事件傳送給您的團隊——新版本上線、部署未完成、服務停止或恢復、記憶體或處理器使用率過高、備份或資料庫磁碟——請在設定 → 團隊通知新增 Slack、Discord 或您自己的 webhook。Webhook 訊息為 JSON 格式,並以僅顯示一次的密鑰簽署,簽章位於 X-Rivervo-Signature 標頭。