GitHub からデプロイ
GitHub リポジトリをプロジェクトにつなぎます。プロジェクトは本番ブランチからデプロイされ、push 時の自動デプロイをオンにすると push のたびに公開されます。
しくみ#
Agent Lab の GitHub App Crescendo Agent Lab(提供: Crescendo Lab)は、許可したリポジトリを読み取り、push のたびに通知を受けます。
- プロジェクトは本番ブランチ(変更しなければリポジトリのデフォルトブランチ)に結びつきます。push 時の自動デプロイがオンなら、本番ブランチへの push はビルドされ、プロジェクトのアドレスで公開されます。
- ワークスペースの Agent Lab の環境と同じ名前の git ブランチ(例:
staging)への push は、その環境で公開されます(これも自動デプロイがオンのときだけです)。 - ほかのブランチへの push は何もビルドしません。バージョンもプレビューアドレスも作られず、コミットにも何も表示されません。
- GitHub のコミットに結果を表示できます。ビルド中は保留、完了後はバージョンのアドレス付きの成功か、ビルドログへのリンク付きの失敗です。
ビルドはアップロードと同じで、フレームワークを自動で検出します。ソースコードからデプロイを参照。
連携の GitHub とは別物です
連携の GitHub は、アシスタントが会話中に GitHub のツールを使うためのものです。デプロイ用の接続はここで設定します。
1. GitHub を接続#
- 設定 › デプロイ設定 で GitHub を接続 を選びます。
- GitHub で Crescendo Agent Lab のインストール先(自分のアカウントか組織)を選びます。すべてのリポジトリか、必要なものだけを許可できます。
- Agent Lab に戻るとアカウントが表示されます。組織のオーナーの承認が必要な場合は、承認まで申請中と表示されます。
ワークスペースに接続できる GitHub アカウントまたは組織は 1 つ です。接続、変更、解除はここだけで行い、ワークスペースのオーナーと管理者だけが操作できます。
アカウントを変更
アカウントを変更 を選び、新しいアカウントまたは組織に Crescendo Agent Lab をインストールします。Agent Lab に戻ると、何かが変わる前に、現在のアカウントを通して接続されたプロジェクトがすべて表示されます。
- 新しいアカウントもリポジトリを読めるプロジェクトは、リポジトリ、本番ブランチ、自動デプロイを維持します。
- それ以外のプロジェクトは接続が解除され、リポジトリの接続とブランチ設定を失います。
アカウントを変更 で一度に切り替えるか、現在のアカウントのままにします。30 分以内に決めなければ何も変わりません。どちらの場合も、Crescendo Agent Lab は GitHub でアンインストールするまで新しいアカウントにインストールされたままです。
接続を解除
接続を解除 では、まずこのアカウントを通して接続されたプロジェクトがすべて表示されます。各プロジェクトはリポジトリの接続とブランチ設定を失いますが、デプロイ済みの内容はそのままで、アップロードや AI ツールでは引き続きデプロイできます。Crescendo Agent Lab は GitHub にインストールされたままなので、何も読ませたくない場合は GitHub でアンインストールしてください。
GitHub で停止されたとき
アカウントが GitHub で Crescendo Agent Lab を停止すると、デプロイ設定と接続中の各プロジェクトの 設定 › Git にそう表示され、オーナーが GitHub で再開するまで push はデプロイされません。GitHub でアンインストールされた場合はプロジェクトの接続が解除され、デプロイ設定にそう表示されます。GitHub からデプロイするには、もう一度接続してください。
2. リポジトリをインポート#
- プロジェクト一覧で プロジェクトを作成、続けて GitHub からインポート を選びます。
- リポジトリを名前で検索して選びます。検索の対象は、アカウントが Agent Lab に読ませているすべてのリポジトリです。見つからない場合は、結果の最後にある GitHub でリポジトリのアクセスを調整 から共有してください。
- 名前、アドレスラベル、本番ブランチを確認します。モノレポでは ルートディレクトリ(例:
apps/web)を設定します。 - 必要な変数を貼り付けるか、あとで追加します。
- デプロイ を選びます。本番ブランチの最新コミットがビルドされ、公開されます。push 時の自動デプロイは最初オフなので、オンにするまでその後の push はデプロイされません(下記参照)。
既存のプロジェクトは 設定 › Git で接続します。
push 時の自動デプロイ#
各プロジェクトの 設定 › Git に push 時の自動デプロイ のスイッチがあります。リポジトリを接続したときはオフで、このスイッチができる前に接続したプロジェクトも同じです。
- オン: 本番ブランチへの push はビルドされて公開され、Agent Lab の環境と同じ名前のブランチへの push はその環境を更新します。
- オフ: push してもビルドされません。公開するときは 最新のコミットをデプロイ を選びます。スイッチがオンでもオフでも使えます。
変更できるのはプロジェクトを管理できる人だけです。
2 回の push の間隔が短いときは、先の push のビルドが最後に終わっても、最新のコミットが公開されます。バージョンが自動で新しいバージョンを置き換えて公開されることはありません。以前のコードに戻すを参照してください。
ブランチと環境#
git ブランチは、まったく同じ名前の Agent Lab の環境で自動的に公開されます。staging への push は staging 環境で公開され、対応づけの設定は不要です。先に Agent Lab の環境を作成してください。作成するまでは、その git ブランチへの push は何もビルドしません。本番ブランチは常にプロジェクトのメインアドレスで公開されます。設定 › Git で本番ブランチを変更できます。最新のコミットをデプロイ で、push せずに本番ブランチを再ビルドできます。
GitHub を使わないデプロイ#
プロジェクトに GitHub は必須ではありません。プロジェクトのページでフォルダや zip をアップロードするか、AI ツールにアップロードさせることもできます。ただし、アップロードしたものは自動では再デプロイされません。ファイルの変更は監視されないので、変更はもう一度アップロードしたとき(自分でも AI ツールでも)にだけ公開されます。プロジェクトの概要の ソース にもそう表示されます。
push のたびにデプロイしたい場合は GitHub を接続します。
- インストールできる人。 Agent Lab では、ワークスペースのオーナーと管理者が 設定 › デプロイ設定 で GitHub を接続します。GitHub では、自分のアカウントには自分で Crescendo Agent Lab をインストールし、組織にはその組織のオーナーがインストールします。オーナーでない場合は GitHub からオーナーにインストール申請が送られ、誰かが承認するまでデプロイ設定には申請中と表示されます。
- できること。 Crescendo Agent Lab が求める権限は 3 つです。リポジトリの内容の読み取り、メタデータの読み取り、コミットステータスの書き込み(各コミットにビルド結果を表示するため)。コード、ブランチ、プルリクエストを変更することはありません。
- 動作の確認方法。 デプロイ設定でアカウントが 接続済み と表示されること。GitHub からインポート またはプロジェクトの 設定 › Git でリポジトリを検索すると見つかること。push 時の自動デプロイ をオンにして本番ブランチにコミットを push すると、プロジェクトの デプロイ タブに新しいバージョンが表示され、GitHub のコミットに保留中、続いてバージョンのアドレス付きの成功が表示されること。
制限#
- リポジトリにはアップロードしたソースと同じ制限があります。
node_modules、.env.local/.env.*.localを除いて(コミットされた.envと.env.<mode>は Vite や Next.js の想定どおり残します) 2 万ファイル、512 MB まで。コミットの.git(深さ 1)も制限に数えます。.gitを含めると制限を超えるリポジトリは.gitなしでビルドします。 - ビルドには git と push されたコミットがあります。ビルド環境を参照してください。
- git サブモジュールと Git LFS のファイルは取得しません。
- push ごとのビルドも、ほかのビルドと同じくビルド時間を使います。