Node.js、Next.js、Nuxtのアプリケーション。
Node.jsプロジェクトの判別と起動の仕組み:Nodeのバージョン、パッケージマネージャー、Next.jsとNuxt(サーバーまたは静的)、SvelteKit、Astro、Expressなど、PORT変数、Prismaのマイグレーション。
package.jsonがあるリポジトリはNode.jsプロジェクトとして扱われます。フレームワーク、パッケージマネージャー、Nodeのバージョンを判別し、ビルドして起動します。お客様はプッシュするだけです。
Nodeのバージョンとパッケージマネージャー
- Node.js:
package.jsonのengines.nodeまたは.nvmrcから取得し、24、22、20、18、16のうち条件に合う最新のものを使います。どちらもない場合はNode.js 22です。 - パッケージマネージャー:ロックファイルで判別します。
pnpm-lock.yaml→ pnpm、yarn.lock→ yarn、それ以外はnpm(package-lock.jsonがあればnpm ci)。 - ビルド:
package.jsonにbuildスクリプトがあれば実行します。
フレームワーク
| フレームワーク | 実行方法 |
|---|---|
| Next.js | サーバーとして(next start)。サーバーレンダリング、APIルート、ミドルウェアは通常どおり動作します |
output: 'export'のNext.js | outから静的サイトとして |
| Nuxt | サーバーとして(.output/server/index.mjs) |
ssr: falseとgenerateスクリプトのあるNuxt | .output/publicから静的サイトとして |
| SvelteKit | adapter-nodeならサーバーとして、adapter-staticなら静的サイトとして |
| Astro | 静的サイトとして。@astrojs/nodeならサーバーとして |
| NestJS | ビルド後にdist/main.js |
| Express、Fastify、Koa、Honoなどのサーバー | scripts.startのファイル(node server.js)、なければmain、それもなければserver.js、app.js、index.js、main.js |
フロントエンドのみのプロジェクト(Vite、Create React App、Angular、Vue CLIなど)は静的サイトとして配信されます。静的サイトをご覧ください。
PORTで待ち受ける
サーバーはPORT変数のポートで、すべてのインターフェースで待ち受ける必要があります。
const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')Next.jsとNuxtはこれを自動で行います。アプリが固定のポートで待ち受けていると訪問者を受け付けられず、デプロイは起動チェックで停止し、以前のバージョンが動作を続けます。
ビルド時の値
変数タブの変数は、実行中のアプリには渡されますが、ビルドには渡されません。ビルドがクライアントのコードに書き込む値(Next.jsのNEXT_PUBLIC_…やVITE_…など)は、リポジトリから読み込まれます。たとえばコミットした.env.productionファイルです。サーバー側のコードは通常どおり変数タブの値を読み込みます。
独自の起動コマンド
自動判別された起動方法が希望と異なる場合は、設定 → ビルド設定 → 起動コマンドを設定します(例:node dist/server.js、npm run start:prod)。インストールコマンドとビルドコマンドもここで変更できます。
データベースとPrisma
プロジェクトにPostgreSQLまたはMySQLを追加し、DATABASE_URLを読み込みます。この変数は自動で設定されます。依存関係にPrismaがある場合、推奨のリリースコマンドはnpx prisma migrate deployです。デプロイのたびに、新しいバージョンが訪問者を受け付ける前に実行されます。詳しくはデプロイをご覧ください。
BullMQでキューを使う場合は、Valkeyを追加してREDIS_URLを使います。キューワーカーはバックグラウンドワーカーとして、プロセスタブで、または独自のリソースを持つ別のサービスとして動かします。詳しくはプロジェクトのサービスをご覧ください。
デプロイ後も残るファイル
各デプロイはリポジトリの新しいコピーから始まります。アプリが/dataに書き込んだファイルはデプロイ後も残り、毎日バックアップされます。それ以外の場所に書き込んだものは、次のデプロイで消えます。アップロードファイルやメディアには、通常はオブジェクトストレージが適しています。
モノレポ
複数のプロジェクトを含むリポジトリでは、アプリの作成時にプロジェクトフォルダーを設定します(例:apps/web)。同じリポジトリの別のフォルダーを別のWebサービスとして動かすこともできます。プロジェクトのサービスをご覧ください。