ソースコードからデプロイ
JavaScript プロジェクトを Dockerfile なしでそのままアップロードできます。Agent Lab がフレームワークを検出してビルドし、ウェブページまたは Web サービスにします。
何が起きるか#
package.json が最上位にくるようにプロジェクトを zip にしてアップロードします。プラットフォームがプロジェクトを読み取り、ビルドプランを作ってビルドします。
- ブラウザ向けのファイルだけを生成するプロジェクトはウェブページになり、CDN から配信されます。シングルページアプリのパス(
/orders/42など)はすべてindex.htmlを返します。 - サーバーを動かすプロジェクトはWeb サービスになり、非 root ユーザーで 8080 番ポートで動くイメージにビルドされます。
Dockerfile を書く必要はありません。最上位に Dockerfile がある場合は検出の代わりにそれが使われます。無効にするにはビルド設定を参照してください。
zip に入れないもの
node_modules、.git、dist、.env。依存関係はプラットフォームがインストールし、含まれていてもスキップします。
対応フレームワーク#
| ウェブページになる | Web サービスになる |
|---|---|
| Vite(React、Vue、Svelte)、Create React App、Vue CLI | Next.js(output: "export" ならウェブページ) |
| Angular、静的 Astro、ビルドスクリプト付きの HTML | Nuxt、SvelteKit、Remix、React Router 7、SSR の Astro |
| Express、Fastify、Koa、Hono、NestJS などの Node サーバー |
npm、pnpm、Yarn、Bun はロックファイルか packageManager フィールドで判定します。Node.js は engines.node、.nvmrc、.node-version の順に読み、なければ最新 LTS(24)を使います。18、20、22、24 が使えます。
ビルド環境#
ビルドはフルの node:<バージョン> イメージで動き、git、python3、make、g++ が入っています。実行時はより小さい node:<バージョン>-slim で動きます。インストールとビルドの手順で git が使えるので、git rev-parse HEAD を実行するスクリプトも結果を得られます。
- GitHub からのビルドには、push されたコミットが深さ 1 で取得され、push されたブランチと同じ名前のブランチにあります。
- アップロードには、アップロードしたファイルを 1 コミットにしたリポジトリが用意されます。アップロードに含まれる
.gitフォルダーは使いません。
ビルド中は 3 つの変数がコミットを表します:AGENTLAB_GIT_COMMIT_SHA、AGENTLAB_GIT_COMMIT_REF(ブランチ)、AGENTLAB_GIT_REPO(owner/name)。GitHub からのビルドでだけ値が入り、アップロードでは空です。同じ名前で設定した変数は無視されます。実行中のサービスには渡りません。独自の Dockerfile を使うプロジェクトは ARG で宣言すると受け取れます。git があるかどうかはそのイメージ次第です。
環境変数#
プランには、コードが読む変数(.env.example、process.env.*、import.meta.env.*)が並び、シークレットらしいものやビルド時に必要なもの(VITE_*、NEXT_PUBLIC_* など)に印が付きます。
Nuxt 3 以降では、nuxt.config の runtimeConfig に書かれたキーも読みます。runtimeConfig.apiSecret は NUXT_API_SECRET、runtimeConfig.public.apiBase は NUXT_PUBLIC_API_BASE です。nuxt-auth-utils を使うと NUXT_SESSION_PASSWORD が並びます。スプレッド(...shared)やレイヤー、ほかのモジュールが加えるキーは見つからないため、.env.example に書いてください。
シークレットには、値を誰が用意するか(source)も付きます。
generate:ランダムであればよく、誰も知る必要のない値です。NUXT_SESSION_PASSWORD、SESSION_SECRET、AUTH_SECRET、SECRET_KEY_BASEなど。フレームワークが求める長さでコンソールから生成できます。アシスタントがsites_secrets_generateで生成・保存することもでき、その場合もアシスタントは値を見ません。person:それ以外のすべてのシークレットです。API キー、Webhook の署名シークレット、データベースのパスワードなど、値はあなただけが持っています。STRIPE_やLINE_のようにサービス名を含む名前は必ずpersonで、プラットフォームが知らない名前も同じです。
- デプロイ前に入力します。Web サービスは 設定 › 実行設定(シークレットは シークレット)、ウェブページは 設定 › ビルド変数 です。ソースからビルドしたバージョンには、コードが読むのに未設定の変数が表示されます。
- 変数はビルドにも渡されます。ビルド時の変数はウェブページに埋め込まれるため、
VITE_やNEXT_PUBLIC_の変数にシークレットを入れないでください。 - シークレットはインストールとビルドの手順にマウントで渡されます(プライベートレジストリのトークンなど)。イメージには書き込まれません。
ビルド設定#
検出が外れたときは 設定 › ビルド設定 で上書きします。空欄は検出されます。
| 設定 | 例 | 変数 |
|---|---|---|
| Node.js バージョン | 22 | ALPACK_NODE_VERSION |
| インストールコマンド | npm ci | ALPACK_INSTALL_CMD |
| ビルドコマンド | npm run build:prod | ALPACK_BUILD_CMD |
| 起動コマンド | node dist/server.js | ALPACK_START_CMD |
| 出力ディレクトリ | dist/browser | ALPACK_OUTPUT_DIR |
| リポジトリの Dockerfile を使わない | オン | ALPACK_IGNORE_DOCKERFILE |
| ルートディレクトリ | apps/web | — |
環境の実行設定に同じ名前の変数があれば、そちらが優先されます。ALPACK_* はビルドだけに使われ、実行中のサービスには渡されません。
ウェブページと検出されたプロジェクトに起動コマンドを設定すると、Web サービスになります。
モノレポ#
複数のプロジェクトを含むリポジトリは、リポジトリ全体をアップロードし、ビルド設定の ルートディレクトリ にプロジェクトのフォルダ(例: apps/web)を入力します。プラットフォームはそのフォルダで検出・ビルドするため、そのフォルダの package.json とロックファイルでビルド方法が決まります。リポジトリの他の場所にあるパッケージ(workspace:* の依存など)はまだ使えません。
新しいプロジェクトの最初のアップロードやプッシュで、最上位にデプロイできるもの(Dockerfile、package.json、go.mod、pyproject.toml、requirements.txt、setup.py、index.html)がなく、1〜2 階層下のフォルダにプロジェクトがある場合(frontend/ と backend/ に分かれたリポジトリなど)は公開されません。そのバージョンは最大 5 つのフォルダを挙げてどれをデプロイするか選ぶよう求め、プロジェクトの種類は未決定のままです。選ぶと ルートディレクトリが設定され、もう一度デプロイされます。GitHub なら最新のコミット、コンソールなら同じファイルです。最上位に index.html があるファイルは、横のフォルダにソースがあってもウェブページのままです。
ビルドが失敗したとき#
| 表示 | 対処 |
|---|---|
| このソースのビルド方法がわからない | zip の最上位に package.json を置くか、起動コマンドを設定します。 |
| ビルドが何も出力しなかった | 出力ディレクトリを、ビルドが実際にファイルを書く場所に設定します。 |
| Web サービスへのアップロードがウェブページ | Web サービスはウェブページに戻せません。新しいプロジェクトを作るか、起動コマンドを設定します。 |
| ネイティブモジュールのコンパイル失敗 | ロックファイルをコミットしてください。ビルド用イメージにはコンパイラ(python3、make、g++)が入っています。 |
各手順はバージョンページのビルドログで確認できます。AI ツールでは、先にビルドプランを取得させてください。MCP ツールを参照。
Go と Python#
プロジェクトのルートに go.mod、pyproject.toml、requirements.txt、または setup.py を置いてアップロードします。Dockerfile があれば優先し、なければ生成します。Go はルートの main package または単一の cmd/*/main.go をビルドします。複数のエントリーポイントにはビルド/起動コマンドの指定が必要です。Python は pip、Poetry、uv と Django WSGI、Flask、FastAPI をサポートします。
ALPACK_GO_VERSION、ALPACK_PYTHON_VERSION でバージョンを、ALPACK_PORT でポートを指定できます。Python は .python-version または manifest の制約から 3.10–3.14 を選び、未指定時は 3.12 を使用します。ALPACK_BUILD_PACKAGES と ALPACK_RUNTIME_PACKAGES には Debian パッケージ名を空白区切りで設定します。生成したイメージは非 root で実行されます。データベース、Redis、認証情報は別途設定してください。原始コードの上限は 1 ファイル 128 MiB、展開後合計 512 MiB、20,000 ファイルです。