從 GitHub 部署

把 GitHub repository 連到 App。每次 push 都會建置；push 到正式分支會上線，其他分支會有自己的預覽網址。

運作方式#

Agent Lab 的 GitHub App Crescendo Agent Lab（由漸強實驗室提供）會讀取你允許的 repository，並在每次 push 時收到通知。

• push 到正式分支（預設是 repository 的預設分支，可以修改）：建置後在 App 的網址上線。
• push 到其他分支：建置一個有自己預覽網址的版本，不會上線。如果工作區裡有同名的 Agent Lab 分支（例如 staging），就會在那個分支上線。
• GitHub 上的 commit 會顯示結果：建置中顯示等待中，完成後顯示成功（附預覽網址）或失敗（附建置記錄連結）。

建置方式跟上傳完全一樣，平台會自動偵測框架。見從原始碼部署。

1. 連結 GitHub#

1. 到 設定 › 部署設定，選 連結 GitHub。
2. GitHub 會問要把 Crescendo Agent Lab 安裝到哪裡：你的帳號或你的某個組織。可以允許所有 repository，或只選 App 需要的幾個。
3. 回到 Agent Lab 後就會看到這個帳號。如果組織需要擁有者核准安裝，在核准前會顯示為已申請。

只有能管理 App 的人可以連結 GitHub。要停止部署，在這裡移除連結；如果不想讓它再讀取任何東西，也到 GitHub 解除安裝 App。

2. 匯入 repository#

1. 在 App 頁選 新增 App，再選 從 GitHub 匯入。
2. 選帳號、搜尋並選擇 repository。
3. 確認名稱、網址標籤和正式分支。monorepo 請填 App 路徑，例如 apps/web。
4. 貼上專案需要的變數，或之後再填。
5. 選 部署。正式分支最新的 commit 會建置並上線。

已經存在的 App，到 設定 › Git 連結。

分支#

git 分支會自動在名稱完全相同的 Agent Lab 分支上線：push 到 staging，就會在你的 staging 分支上線，不需要另外設定對應。請先建立 Agent Lab 分支；建立之前，push 到這個 git 分支只會有預覽網址。正式分支一律在 App 的主要網址上線。在 設定 › Git 可以修改正式分支。部署最新提交 不用 push 就能再建置一次正式分支。

限制#

• repository 的限制和上傳原始碼相同：2 萬個檔案、512 MB，不含 node_modules、.git，以及 .env.local、.env.*.local。提交進 repo 的 .env、.env.<mode> 會保留，這是 Vite、Next.js 的預期。
• 不會抓取 git submodule 和 Git LFS 檔案。
• 每次 push 和其他建置一樣使用建置分鐘數。