版本與上線
每次上傳都會產生一個新版本。版本不會被覆寫,上線一律是讓最新的版本上線。
建置階段#
上傳之後,版本會依序經過這些階段,「部署」分頁的版本列會顯示目前在哪一段:
| 階段 | 平台在做什麼 |
|---|---|
| 排隊中 | 等待建置機器。畫面會顯示前面還有幾個。 |
| 建置中 | 建置網頁或容器映像檔。 |
| 掃描中 | 檢查密鑰、個人資料、外部載入的腳本;網頁服務另外掃描映像檔的漏洞與密鑰。 |
| 審查中 | 整理掃描結果。 |
| 等待確認 | 有檢查項目設成「會先問過你」,而且找到了問題。看過結果後,你可以決定照樣發佈。 |
| 成功 | 版本可以上線。 |
| 已取消 | 排隊時由成員取消,沒有建置。畫面會寫出由誰、何時取消。 |
| 失敗 | 內容被拒收,或平台出錯。見部署失敗排除。 |
每個檢查項目在版本的檢查結果裡會標出它的處理方式:「修正後才能上線」、「會先問過你」或「不執行」。
上線#
工作區只有正式環境時,每個新版本建置成功後都會自動上線,除非目前上線的已經是更新的版本。訪客會在一分鐘內看到新版本。
上線一律是讓最新的版本上線。最新版本還沒上線時(例如只有建置,或是上傳到別的環境),在「部署」分頁最新部署的通知上,或那個版本列上按「上線」。只有最新的版本能上線。想再跑較早的程式碼,就把它重新部署成一個新版本(見回到較早的程式碼)。
工作區有一個以上的環境時,版本只會在你上傳到的那個環境上線(見環境)。
版本有問題時,修正後再部署一次。想在訪客看到之前先試試看,可以先部署到另一個環境(例如 staging),確認沒問題再到正式環境上線。
每個版本都有自己的預覽網址,不管目前上線的是哪一版都能開。
內網呼叫也會跟著切換
其他專案透過內網網址呼叫這個專案時,打到的是目前上線的版本。上線後,內網呼叫的目標也會跟著換。
取消排隊中的建置#
版本還在排隊中時,在部署分頁最新部署的通知上,或版本自己的頁面上,選取消建置。按下就會取消,不會再問一次:這個版本不會建置,不會用掉建置分鐘數,任何環境上線中的版本也都不會變。能部署這個專案的人都能取消。
取消之後還能復原。上傳後大約一天內,在顯示這個已取消版本的地方選重新建置,就會重新排隊,不用重新上傳。超過這段時間,上傳的檔案已經刪除,請重新部署。
建置機器一旦開始建置,就不能取消了。它會照常完成;如果不想要這個版本,等它完成後再部署修正的版本。
從 GitHub 推送建置的版本取消後會維持取消:GitHub 重送同一個推送不會讓它回來。要再建置這個 commit,用部署最新提交,或推送新的 commit。
回到較早的程式碼#
如果某個版本建置完成時,已經有更新的版本上線,這個版本不會自動上線。兩次 push(或兩次上線到同一個環境的上傳)間隔很近、後面那次建置比較快時,就會發生這種情況。較新的版本會繼續上線,較早的那個版本留在列表裡,顯示「未上線:第 N 版較新」。這不是失敗,不需要處理。
想再跑較早的程式碼,就把它再 push 一次(或再上傳一次)。這會產生一個比目前上線版本更新的版本,並和其他版本一樣上線。
環境#
專案有多個環境時,所有動作都只作用在你目前所在的環境。上傳按鈕會寫「上傳,並在 ‹環境› 上線」,上線也只影響這個環境。每個環境用自己的設定和機敏值。
在某個環境上線之前,平台會比對這個環境的變數與機敏值名稱,缺少的會先提醒你。
新環境開放使用前
新環境有自己的網址,所以 Agent Lab 以外、原本只認得正式環境網址的服務,也要知道這個新網址。交給別人用之前,先確認這幾件事:
- 沒帶過來的值。 只複製機敏值名稱的環境,會在 環境變數 裡把每個缺少的機敏值列成空白的一列,並寫出是從哪個環境複製來的;在填好之前,專案總覽的狀態會一直是 需要注意。這段期間,新環境已經在跑來源環境目前的版本。
- OAuth 回呼網址。 如果網站用 Google、GitHub、LINE 或其他 OAuth 服務登入,要把新環境的網址加上你的回呼路徑,加進那個服務允許的重新導向(callback)網址。不然登入會因為網址不符而失敗。
- 登入網域。 如果你的登入服務有允許的網域清單,例如 Firebase Authentication 的授權網域或允許來源清單,也要把新網址加進去。
- 值裡面的網址。 複製過來的值如果指向來源環境的 Agent Lab 網址或資料庫,會自動改成新環境的。指向 Agent Lab 以外的網址則照原樣複製。