--- title: GitHub からデプロイ description: GitHub リポジトリをアプリにつなぎます。push のたびにビルドされ、本番ブランチへの push は公開、ほかのブランチはプレビューアドレスになります。 url: https://agentlab.cresclab.com/docs/ja/deploy/github language: ja updated: 2026-10-08 --- # GitHub からデプロイ GitHub リポジトリをアプリにつなぎます。push のたびにビルドされ、本番ブランチへの push は公開、ほかのブランチはプレビューアドレスになります。 ## しくみ Agent Lab の GitHub App **Crescendo Agent Lab**（提供: Crescendo Lab）は、許可したリポジトリを読み取り、push のたびに通知を受けます。 - **本番ブランチ**（変更しなければリポジトリのデフォルトブランチ）への push は、ビルドしてアプリのアドレスで公開します。 - **ほかのブランチ**への push は、専用のプレビューアドレスを持つバージョンをビルドし、公開はしません。ワークスペースに同じ名前の Agent Lab ブランチ（例: `staging`）があれば、そこで公開されます。 - GitHub のコミットに結果が表示されます。ビルド中は保留、完了後はプレビューアドレス付きの成功か、ビルドログへのリンク付きの失敗です。 ビルドはアップロードと同じで、フレームワークを自動で検出します。[ソースコードからデプロイ](https://agentlab.cresclab.com/docs/ja/deploy/source-build.md)を参照。 > [!NOTE] 連携の GitHub とは別物です > **連携**の GitHub は、アシスタントが会話中に 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.` は Vite や Next.js の想定どおり残します） 2 万ファイル、512 MB まで。 - git サブモジュールと Git LFS のファイルは取得しません。 - push ごとのビルドも、ほかのビルドと同じくビルド時間を使います。