今すぐ始める

Node.js、Next.js、Nuxtのアプリケーション。

Node.jsプロジェクトの判別と起動の仕組み:Nodeのバージョン、パッケージマネージャー、Next.jsとNuxt(サーバーまたは静的)、SvelteKit、Astro、Expressなど、PORT変数、Prismaのマイグレーション。

1 分で読めます

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.jsoutから静的サイトとして
Nuxtサーバーとして(.output/server/index.mjs)
ssr: falseとgenerateスクリプトのあるNuxt.output/publicから静的サイトとして
SvelteKitadapter-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サービスとして動かすこともできます。プロジェクトのサービスをご覧ください。

解決しませんか?

チャットでご相談ください。AIがすぐに回答し、必要なときはエンジニアが加わります。時間帯は問いません。

サポートに問い合わせる