サーバーレス API

このパターンは？

サーバーを1台も持たずに Web/API を構築する、OCI でのサーバーレス構成。アイドル時はほぼ無料（Functions は GB 秒課金で実行時のみ、NoSQL はオンデマンド）、急なスパイクにも自動でスケールします。AWS の「CloudFront＋S3／API Gateway＋Lambda＋DynamoDB」を、OCI の同等サービスに置き換えた形です。

構成

[ユーザー]
   │ HTTPS
   ▼
CDN(WAFエッジポリシー) ──► Object Storage (SPA/静的サイト: HTML/CSS/JS)
   │
   │ /api/*
   ▼
API Gateway (JWTオーソライザー・レートリミット)
   │
   ▼
Functions (ビジネスロジック / Fn Project)
   │
   ▼
NoSQL Database (データ)    ※ファイルは Object Storage、秘密情報は Vault

各コンポーネントの役割

• CDN + Object Storage: フロント（SPA/静的）を WAF エッジポリシーでキャッシュ・TLS 終端し、バケットは Private のまま PAR で配信
• API Gateway: API の玄関。JWT オーソライザー・レートリミット（PER_CLIENT）・CORS・ルーティングを集約
• Functions: ロジックをイベント実行。ステートレス・自動スケール（Fn Project ベース、コンテナイメージを OCIR から起動）
• NoSQL Database: 一桁ミリ秒・サーバーレスなデータストア（型付きスキーマ＋SQL 風クエリ）

設計の勘所

• 認証は JWT オーソライザー（IDCS / 外部 OAuth IdP の発行トークン）を API Gateway の玄関で検証し集約。独自ロジックが要るなら Functions オーソライザー
• NoSQL は アクセスパターン駆動で設計し、シャードキーを均等分散させて全件 SCAN を避ける（詳細）
• Functions から他サービスへの認証は リソースプリンシパルを使い、秘密情報は Vault の Secrets から実行時取得（鍵をコードや config に直書きしない）
• 非同期・重い処理は Queue でバッファし、Events で「オブジェクト作成 → Functions 起動」を疎結合に接着

レイヤ対応（AWS との置き換え）

サーバーレス API の各レイヤが、AWS と OCI でどのサービスに対応するかを押さえると設計・移行がスムーズです。

Well-Architected の観点

• コスト最適化: 従量課金・アイドル無料（Functions は GB 秒、NoSQL はオンデマンド、API Gateway はコール数）
• 運用上の優秀性: サーバー管理レス。デプロイメント仕様や関数を Resource Manager（Terraform）/ OpenAPI で IaC 化
• パフォーマンス効率: エッジ配信＋自動水平スケール。NoSQL は一桁ミリ秒
• 信頼性: マネージドサービスの冗長性（API Gateway はリージョナルで複数 AD、NoSQL はリージョン内自動複製）を活用し、Queue でリトライ・退避
• セキュリティ: 玄関で認証集約、最小権限ポリシー、Vault による鍵管理、バケットは Private

よくある落とし穴

メトリクス/ログは Monitoring（oci_apigateway / oci_faas 名前空間）と Logging、権限は IAM の動的グループ＋ポリシーで最小化する。