GitHub からデプロイ

GitHub リポジトリをアプリにつなぎます。push のたびにビルドされ、本番ブランチへの push は公開、ほかのブランチはプレビューアドレスになります。

しくみ#

Agent Lab の GitHub App Crescendo Agent Lab（提供: Crescendo Lab）は、許可したリポジトリを読み取り、push のたびに通知を受けます。

• 本番ブランチ（変更しなければリポジトリのデフォルトブランチ）への push は、ビルドしてアプリのアドレスで公開します。
• ほかのブランチへの push は、専用のプレビューアドレスを持つバージョンをビルドし、公開はしません。ワークスペースに同じ名前の Agent Lab ブランチ（例: staging）があれば、そこで公開されます。
• GitHub のコミットに結果が表示されます。ビルド中は保留、完了後はプレビューアドレス付きの成功か、ビルドログへのリンク付きの失敗です。

ビルドはアップロードと同じで、フレームワークを自動で検出します。ソースコードからデプロイを参照。

1. GitHub を接続#

1. 設定 › デプロイ設定 で GitHub を接続 を選びます。
2. GitHub で Crescendo Agent Lab のインストール先（自分のアカウントか組織）を選びます。すべてのリポジトリか、必要なものだけを許可できます。
3. Agent Lab に戻るとアカウントが表示されます。組織のオーナーの承認が必要な場合は、承認まで申請中と表示されます。

アプリを管理できる人だけが接続できます。デプロイをやめるにはここで接続を削除し、何も読ませたくない場合は GitHub で App をアンインストールしてください。

2. リポジトリをインポート#

1. アプリ一覧で 新しいアプリ、続けて GitHub からインポート を選びます。
2. アカウントを選び、リポジトリを検索して選びます。
3. 名前、アドレスラベル、本番ブランチを確認します。モノレポでは アプリのパス（例: apps/web）を設定します。
4. 必要な変数を貼り付けるか、あとで追加します。
5. デプロイ を選びます。本番ブランチの最新コミットがビルドされ、公開されます。

既存のアプリは 設定 › Git で接続します。

ブランチ#

git ブランチは、まったく同じ名前の Agent Lab ブランチで自動的に公開されます。staging への push は staging ブランチで公開され、対応づけの設定は不要です。先に Agent Lab ブランチを作成してください。作成するまでは、その git ブランチへの push はプレビューアドレスだけになります。本番ブランチは常にアプリのメインアドレスで公開されます。設定 › Git で本番ブランチを変更できます。最新コミットをデプロイ で、push せずに本番ブランチを再ビルドできます。

制限#

• リポジトリにはアップロードしたソースと同じ制限があります。node_modules、.git、.env.local / .env.*.local を除いて（コミットされた .env と .env.<mode> は Vite や Next.js の想定どおり残します） 2 万ファイル、512 MB まで。
• git サブモジュールと Git LFS のファイルは取得しません。
• push ごとのビルドも、ほかのビルドと同じくビルド時間を使います。