Dockerfile から Web サービスをデプロイする
Dockerfile を含むソースコードから、Webhook、API、エージェント用ツールなど常時稼働するサービスをデプロイします。
始める前に#
- HTTP リクエストに応答するプログラム。
- プロジェクトの最上位にある
Dockerfile。
1. Dockerfile を書く#
次の Node.js の例では、サーバーが $PORT で待ち受け、イメージはポートを 1 つだけ EXPOSE し、root 以外のユーザーで実行します。
FROM node:22-slim
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
USER node
EXPOSE 8080
CMD ["node", "server.js"]import { createServer } from "node:http";
const port = Number(process.env.PORT ?? 8080);
createServer((req, res) => {
res.writeHead(200, { "content-type": "application/json" });
res.end(JSON.stringify({ ok: true, path: req.url }));
}).listen(port);イメージは次の条件を満たす必要があります。すべてのルールはコンテナ実行契約にあります。
CMDまたはENTRYPOINTでサーバーを起動する。$PORTで HTTP を提供する。linux/amd64向けにビルドする。/tmp以外のファイルシステムは読み取り専用。/tmpにも独自の上限がある。
2. ソースをアップロードする#
プロジェクトの「デプロイ」タブで、ソースのフォルダか .zip をアップロード領域にドロップし、「アップロードしてビルド」を選びます。Dockerfile は最上位に置きます。zip を自分で作る場合は、node_modules、.git、.env を除外します。
zip -r ../app.zip . -x 'node_modules/*' '.git/*' '.env*'プラットフォームはイメージをビルドし、脆弱性とシークレットをスキャンして、実行契約に沿っているかを確認します。自動で調整した点は、バージョンのページにお知らせとして表示されます(例:「イメージが root で実行されるため、uid 10001 で実行します」)。
3. 公開して実行状態を確認する#
プロジェクトの最初のバージョンは、ビルドが成功すると自動で公開されます。2 つ目以降は「デプロイ」タブで「公開」を選びます。
「実行」タブには、配信中のバージョンと準備完了のインスタンス数が表示されます。
バージョンがいつまでも準備完了にならない
多くはポートが原因で、プラットフォームが指定したポートでサーバーが待ち受けていません。対処はデプロイのトラブルシューティングをご覧ください。
4. シークレットを追加する#
API キーなどの機密値はプロジェクトの「設定」で入力し、コードからは環境変数として読み取ります。サービスの稼働中は、確認のうえ保存と再起動が一度に行われ、新しいインスタンスの準備ができるまでは古いインスタンスが配信を続けます。詳しくはプロジェクトの設定をご覧ください。
ソースコードにシークレットを含めない
イメージ内でキーが見つかった場合は、ソースから取り除いてプロジェクトのシークレットに設定し、キーを新しいものに交換してください。
上限#
メモリと CPU
各インスタンスはプロジェクトのサイズで動きます。サイズはプロジェクトの「設定」にある「サイズ」で変更します。
| サイズ | CPU | メモリ |
|---|---|---|
| S | 0.5 vCPU | 512 MiB |
| M | 1 vCPU | 1 GiB |
| L | 2 vCPU | 2 GiB |
メモリは超えられない上限です。超えたインスタンスは停止され、再起動します。--max-old-space-size で Node.js のヒープを増やす場合は、メモリの 4 分の 3 未満にしてください。プロセスのほかの部分もメモリを使います。それ以上の値にすると、バージョンのページの「ビルドの注意」に警告が出ます。
/tmp のファイル
プログラムが書き込めるのは /tmp だけです。
- 容量は最大 256 MiB です。ファイルはディスクに置かれ、上のメモリには数えられません。
- インスタンスが再起動するたび、新しいバージョンが公開されるたびに空になります。インスタンスごとに別々です。
- 256 MiB を超えて書き込むと、インスタンスは停止されます。代わりの新しいインスタンスの
/tmpは空です。
キャッシュや一時ファイルに使い、残しておく必要のあるデータは置かないでください。
コンテナ内でデータベースを動かさない
イメージ内で起動したデータベース(PostgreSQL、MySQL、MongoDB、Redis など)は、データをインスタンスの中に保存します。インスタンスの再起動や新しいバージョンの公開でデータは失われ、プログラムのメモリも奪います。Dockerfile がデータベースをインストールまたは起動していると、「ビルドの注意」に警告が出ます。
残すデータは Agent Lab のデータベース(PostgreSQL または MySQL)か Redis キャッシュに保存してください。コードからは環境変数で接続します。