Crescendo Lab ドキュメント
日本語
無料で始める

ソースコードからデプロイ

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 CLINext.js(output: "export" ならウェブページ)
Angular、静的 Astro、ビルドスクリプト付きの HTMLNuxt、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 で、プラットフォームが知らない名前も同じです。
  1. デプロイ前に入力します。Web サービスは 設定 › 実行設定(シークレットは シークレット)、ウェブページは 設定 › ビルド変数 です。ソースからビルドしたバージョンには、コードが読むのに未設定の変数が表示されます。
  2. 変数はビルドにも渡されます。ビルド時の変数はウェブページに埋め込まれるため、VITE_ や NEXT_PUBLIC_ の変数にシークレットを入れないでください。
  3. シークレットはインストールとビルドの手順にマウントで渡されます(プライベートレジストリのトークンなど)。イメージには書き込まれません。

ビルド設定#

検出が外れたときは 設定 › ビルド設定 で上書きします。空欄は検出されます。

設定例変数
Node.js バージョン22ALPACK_NODE_VERSION
インストールコマンドnpm ciALPACK_INSTALL_CMD
ビルドコマンドnpm run build:prodALPACK_BUILD_CMD
起動コマンドnode dist/server.jsALPACK_START_CMD
出力ディレクトリdist/browserALPACK_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 ファイルです。