サーバーレスPaaSインfraでデプロイ後に直面する実務問題의解決策

フロントエンドとバックエンドを数クリックでデプロイしてくれるオールインワンPaaSは、最初は完璧に見える。問題は、実際のユーザーが流入し始めてからだ。ローカルでは問題なく動いていたコードがプロダクションに上がるとタイムアウトを吐き出し、DBスキーマを1つ変更しようとしただけでサービス全体が不通になることもある。さらに、ベンダーロックインによって身動きが取れない状況に直面すると、頭が痛くなってくる。

このようなプラットフォームの利便性を享受しつつ、後からついてくる障害物をきれいに取り除くインフラパターンをいくつかまとめた。

ローカル環境とサーバーレスランタイムの隔たりを縮める

ローカルのNode.jsプロセスは常時起動しているが、サーバーレス環境はリクエストが入ってきたときだけ一時的に起動して消滅する。コールドスタートのタイミングでグローバル変数やDBシングルトン接続を曖昧に保持すると、コネクションプールがあっという間に枯渇してしまう。

ステージングサーバーへ毎回デプロイして確認するわけにもいかない。ネットワークレイヤー自体をローカルでモックし、ハンドラーを立ち上げる方がはるかに早い。

`typescript
// src/mocks/handlers.ts
import { http, HttpResponse } from 'msw';

export const handlers = [
http.get('/api/v1/user/profile', ({ request }) => {
const authHeader = request.headers.get('Authorization');
if (!authHeader) {
return new HttpResponse(null, { status: 401, statusText: 'Unauthorized' });
}
return HttpResponse.json({
id: 'usr_102938',
email: 'dev@example.com',
role: 'ADMIN',
createdAt: new Date().toISOString()
});
})
];

// src/mocks/node.ts
import { setupServer } from 'msw/node';
import { handlers } from './handlers';

export const server = setupServer(...handlers);

このパターンを適用する手順はシンプルだ。

MSW(Mock Service Worker)ライブラリを通じてネットワークリクエストをインターセプトするハンドラーを構成する。
エミュレーター実行時に setupServer で外部API通信を隔離する。
.env.local ファイルのDB接続アドレスをプロダクションのトランザクションプーラーエンドポイントと徹底的に分離する。

デプロイボタンを押さなくても、バックエンドインターフェースの動作をローカルで100%同一に検証できる。不安定なリモートテスト時間を捨て、コード作成後すぐにフィードバックを受け取る構造だ。

サービス停止のないスキーママイグレーション

SupabaseやNeonのようなサーバーレスPostgreSQLを使う際、単純な ALTER TABLE 文をそのまま実行するのは危険だ。対象テーブルに ACCESS EXCLUSIVE ロックがかかり、後続のクエリが続々と待機状態に陥って最終的にタイムアウト障害につながる。

まずマイグレーションセッションにタイムアウトの上限を設定しておく必要がある。

`sql
SET lock_timeout = '2000ms';
SET statement_timeout = '5000ms';

ALTER TABLE users ADD COLUMN bio VARCHAR(255);

運用中のDB構造を安全に変更するには、コードとDBを同時に拡張した後に古いものを削っていく方式を取るべきだ。

`typescript
import { db } from './db';

interface UpdateUserProfileInput {
userId: string;
fullName: string;
}

export async function updateUserProfile({ userId, fullName }: UpdateUserProfileInput) {
await db.transaction(async (tx) => {
await tx.user.update({
where: { id: userId },
data: {
full_name: fullName,
name: fullName
}
});
});
}

安全な作業のための3ステップだ。

拡張: 新規カラムを Nullable 条件で追加する。 lock_timeout を設定し、ロック競合時に即座に作業を中断する安全装置を作る。
移行: 旧カラムと新カラムにデータを同時に書き込むデュアルライトコードをデプロイする。既存データはバックグラウンドスクリプトでゆっくり埋めていく。
収縮: すべてのサーバーインスタンスが新しいコードを参照していることを確認した後、旧カラムを削除するクエリを実行する。

この手順を守れば、ユーザーのリクエストを1つもこぼさずにスキーマを交換できる。

分散ログの整理とエラーモニタリングコストの制御

サーバーレス環境で console.log だけを残しておくと、複数のインスタンスのログが入り交じって惨状と化す。1つのリクエストが入って出ていくまでの動線を追跡するには、一意の Request ID と構造化された JSON 形式が必須だ。

`typescript
import { Hono } from 'hono';
import { requestId } from 'hono/request-id';
import pino from 'pino';

const logger = pino({
level: process.env.LOG_LEVEL || 'info',
formatters: {
level: (label) => ({ level: label.toUpperCase() })
},
base: { env: process.env.NODE_ENV }
});

const app = new Hono();

app.use('', requestId());
app.use('', async (c, next) => {
const reqId = c.var.requestId;
const startTime = performance.now();

c.set('logger', logger.child({ reqId }));

await next();

const durationMs = Math.round(performance.now() - startTime);
logger.info({
reqId,
method: c.req.method,
path: c.req.path,
status: c.res.status,
durationMs
}, 'Request processing finished');
});

外部モニタリングツールを使う際の上限超過料金爆弾を回避する設定だ。

レスポンスヘッダーに Server-Timing を注入し、ボトルネックとなるポイントをモニタリングシステムへ送信する。
単純なトラフィックロストやネットワークの一時的なエラーは、エラー収集エンジン側でフィルタリングする。

`typescript
import * as Sentry from '@sentry/node';

Sentry.init({
dsn: process.env.SENTRY_DSN,
tracesSampleRate: 0.1,
beforeSend(event, hint) {
const error = hint.originalException;
if (error && error instanceof Error && error.message.includes('ECONNRESET')) {
return null;
}
return event;
}
});

無意味な 200 OK ログやノイズ的な例外状況を間引くだけでも、モニタリングプラットフォームの無料枠内でシステムを十分に制御できる。

プラットフォームロックイン防止のためのアダプターパターンとバックアップパイプライン

特定のPaaS専用SDKをビジネスロジックに直接結合させると、将来別のプラットフォームに移行する際にコードを全面的に書き直す羽目になる。Martin Fowlerが提唱したアダプターパターンを使い、アプリケーションのコアロジックと外部クラウドSDKとの接点を分離するのはそのためだ。

`typescript
export interface IStorageService {
uploadFile(path: string, fileBuffer: Buffer, mimeType: string): Promise<{ url: string }>;
deleteFile(path: string): Promise;
}

import { S3Client, PutObjectCommand, DeleteObjectCommand } from '@aws-sdk/client-s3';

export class S3StorageAdapter implements IStorageService {
private s3: S3Client;
private bucket: string;

constructor(region: string, bucket: string) {
this.s3 = new S3Client({ region });
this.bucket = bucket;
}

async uploadFile(path: string, fileBuffer: Buffer, mimeType: string): Promise<{ url: string }> {
await this.s3.send(new PutObjectCommand({
Bucket: this.bucket,
Key: path,
Body: fileBuffer,
ContentType: mimeType
}));
return { url: https://${this.bucket}.s3.amazonaws.com/${path} };
}

async deleteFile(path: string): Promise {
await this.s3.send(new DeleteObjectCommand({ Bucket: this.bucket, Key: path }));
}
}

いつでも脱出できるようにデータバックアップも自動化しておく。

`bash
#!/usr/bin/env bash
set -euo pipefail

TIMESTAMP= $(date +%Y%m%d_%H%M%S) BACKUP_DIR="/tmp/db_backup_$ {TIMESTAMP}"
S3_BUCKET="s3://my-app-exit-backups/pg_dumps"
export PGPASSWORD="${DB_PASSWORD}"

mkdir -p "${BACKUP_DIR}"

pg_dump -h " ${DB_HOST}" -p "$ {DB_PORT}" -U " ${DB_USER}" -d "$ {DB_NAME}"
-Fc --exclude-table-data='logs_*' > "${BACKUP_DIR}/full_schema_data.dump"

tar -czvf " ${BACKUP_DIR}.tar.gz" -C "$ {BACKUP_DIR}" .
aws s3 cp " ${BACKUP_DIR}.tar.gz" "$ {S3_BUCKET}/ ${TIMESTAMP}.tar.gz" --endpoint-url "$ {R2_ENDPOINT_URL}"
rm -rf " ${BACKUP_DIR}" "$ {BACKUP_DIR}.tar.gz"

pg_dump を活用してスキーマとデータを抽出するシェルスクリプトを作成する。
Cloudflare R2 や外部 S3 バケットへバックアップファイルが転送されるよう crontab に登録する。
離脱が必要になった際は、DNS の CNAME TTL をあらかじめ 300 秒に縮めておき、切り替えを行う。

特定プラットフォームに依存するリスクを減らしておけば、インフラ単価の上昇やプラットフォーム障害の際にもはるかに対応しやすくなる。

サーバーレスPaaSインfraでデプロイ後に直面する実務問題의解決策

このようなプラットフォームの利便性を享受しつつ、後からついてくる障害物をきれいに取り除くインフラパターンをいくつかまとめた。

ローカル環境とサーバーレスランタイムの隔たりを縮める

`typescript
// src/mocks/handlers.ts
import { http, HttpResponse } from 'msw';

// src/mocks/node.ts
import { setupServer } from 'msw/node';
import { handlers } from './handlers';

export const server = setupServer(...handlers);

このパターンを適用する手順はシンプルだ。

MSW(Mock Service Worker)ライブラリを通じてネットワークリクエストをインターセプトするハンドラーを構成する。
エミュレーター実行時に setupServer で外部API通信を隔離する。
.env.local ファイルのDB接続アドレスをプロダクションのトランザクションプーラーエンドポイントと徹底的に分離する。

サービス停止のないスキーママイグレーション

まずマイグレーションセッションにタイムアウトの上限を設定しておく必要がある。

`sql
SET lock_timeout = '2000ms';
SET statement_timeout = '5000ms';

ALTER TABLE users ADD COLUMN bio VARCHAR(255);

運用中のDB構造を安全に変更するには、コードとDBを同時に拡張した後に古いものを削っていく方式を取るべきだ。

`typescript
import { db } from './db';

interface UpdateUserProfileInput {
userId: string;
fullName: string;
}

安全な作業のための3ステップだ。

拡張: 新規カラムを Nullable 条件で追加する。 lock_timeout を設定し、ロック競合時に即座に作業を中断する安全装置を作る。
移行: 旧カラムと新カラムにデータを同時に書き込むデュアルライトコードをデプロイする。既存データはバックグラウンドスクリプトでゆっくり埋めていく。
収縮: すべてのサーバーインスタンスが新しいコードを参照していることを確認した後、旧カラムを削除するクエリを実行する。

この手順を守れば、ユーザーのリクエストを1つもこぼさずにスキーマを交換できる。

分散ログの整理とエラーモニタリングコストの制御

`typescript
import { Hono } from 'hono';
import { requestId } from 'hono/request-id';
import pino from 'pino';

const logger = pino({
level: process.env.LOG_LEVEL || 'info',
formatters: {
level: (label) => ({ level: label.toUpperCase() })
},
base: { env: process.env.NODE_ENV }
});

const app = new Hono();

app.use('', requestId());
app.use('', async (c, next) => {
const reqId = c.var.requestId;
const startTime = performance.now();

c.set('logger', logger.child({ reqId }));

await next();

const durationMs = Math.round(performance.now() - startTime);
logger.info({
reqId,
method: c.req.method,
path: c.req.path,
status: c.res.status,
durationMs
}, 'Request processing finished');
});

外部モニタリングツールを使う際の上限超過料金爆弾を回避する設定だ。

レスポンスヘッダーに Server-Timing を注入し、ボトルネックとなるポイントをモニタリングシステムへ送信する。
単純なトラフィックロストやネットワークの一時的なエラーは、エラー収集エンジン側でフィルタリングする。

`typescript
import * as Sentry from '@sentry/node';

無意味な 200 OK ログやノイズ的な例外状況を間引くだけでも、モニタリングプラットフォームの無料枠内でシステムを十分に制御できる。

プラットフォームロックイン防止のためのアダプターパターンとバックアップパイプライン

`typescript
export interface IStorageService {
uploadFile(path: string, fileBuffer: Buffer, mimeType: string): Promise<{ url: string }>;
deleteFile(path: string): Promise;
}

import { S3Client, PutObjectCommand, DeleteObjectCommand } from '@aws-sdk/client-s3';

export class S3StorageAdapter implements IStorageService {
private s3: S3Client;
private bucket: string;

constructor(region: string, bucket: string) {
this.s3 = new S3Client({ region });
this.bucket = bucket;
}

async deleteFile(path: string): Promise {
await this.s3.send(new DeleteObjectCommand({ Bucket: this.bucket, Key: path }));
}
}

いつでも脱出できるようにデータバックアップも自動化しておく。

`bash
#!/usr/bin/env bash
set -euo pipefail

TIMESTAMP= $(date +%Y%m%d_%H%M%S) BACKUP_DIR="/tmp/db_backup_$ {TIMESTAMP}"
S3_BUCKET="s3://my-app-exit-backups/pg_dumps"
export PGPASSWORD="${DB_PASSWORD}"

mkdir -p "${BACKUP_DIR}"

pg_dump -h " ${DB_HOST}" -p "$ {DB_PORT}" -U " ${DB_USER}" -d "$ {DB_NAME}"
-Fc --exclude-table-data='logs_*' > "${BACKUP_DIR}/full_schema_data.dump"

pg_dump を活用してスキーマとデータを抽出するシェルスクリプトを作成する。
Cloudflare R2 や外部 S3 バケットへバックアップファイルが転送されるよう crontab に登録する。
離脱が必要になった際は、DNS の CNAME TTL をあらかじめ 300 秒に縮めておき、切り替えを行う。

特定プラットフォームに依存するリスクを減らしておけば、インフラ単価の上昇やプラットフォーム障害の際にもはるかに対応しやすくなる。

サーバーレスPaaSインフラでデプロイ後に直面する実務問題の解決策

관련 영상

個人開発者の作業フローをシンプルにする方法とは？

サーバーレスPaaSインfraでデプロイ後に直面する実務問題의解決策

ローカル環境とサーバーレスランタイムの隔たりを縮める

サービス停止のないスキーママイグレーション

分散ログの整理とエラーモニタリングコストの制御

プラットフォームロックイン防止のためのアダプターパターンとバックアップパイプライン

커뮤니티의 다른 글

에이전틱 커머스 프로젝트에 x402 결제를 붙일 때 생기는 일들

AI 에이전트 결제 트랜잭션이 들어오면 쇼핑몰 코어 DB부터 보호해야 한다

WP-CLI와 SQL로 워드프레스 은폐 백도어 찾는 법

Stripe 기반 AI 에이전트에 자금 한도를 거는 백엔드 구현법

알고리즘 밖에서 나만의 커뮤니티를 지키는 법

알고리즘보다 내 전문성을 증명하는 법

댓글 (0)

サーバーレスPaaSインfraでデプロイ後に直面する実務問題의解決策

ローカル環境とサーバーレスランタイムの隔たりを縮める

サービス停止のないスキーママイグレーション

分散ログの整理とエラーモニタリングコストの制御

プラットフォームロックイン防止のためのアダプターパターンとバックアップパイプライン