Cloud Run + Firestore で SaaS バックエンド構築チュートリアル

Cloud Run + Firestore はモダン SaaS バックエンドの定番構成です。 サーバレス + 完全マネージド + 無料枠寛大で、個人開発から本格 SaaS まで対応可能。本記事ではマルチテナント設計から課金まで実装例を網羅します。

アーキテクチャ全体

Web/Mobile (React/Flutter)
        |
   Firebase Auth (認証)
        |
   Firebase Hosting (フロント CDN) → Cloud Run (API)
                                          |
                                          v
                              Firestore (主 DB)
                              Cloud Storage (ファイル)
                              Pub/Sub (非同期処理)
                              Cloud Tasks (遅延処理)
                              Stripe Webhook → Cloud Run
                              SendGrid (メール)
                              Cloud Scheduler (定期バッチ)

Step 1: Firestore マルチテナント設計

// 構造
/tenants/{tenant_id}
  /users/{user_id}
  /subscriptions/{sub_id}
  /resources/{resource_id}

// または
/tenants/{tenant_id}/{collection}/{doc}

// Security Rules (例)
match /tenants/{tenant_id}/{document=**} {
  allow read, write: if request.auth.token.tenant_id == tenant_id;
}

Step 2: Cloud Run API (Node.js / Express)

import express from "express";
import { initializeApp, applicationDefault } from "firebase-admin/app";
import { getAuth } from "firebase-admin/auth";
import { getFirestore } from "firebase-admin/firestore";

initializeApp({ credential: applicationDefault() });
const app = express();
app.use(express.json());

// Firebase Auth 検証 Middleware
app.use(async (req, res, next) => {
  const idToken = req.headers.authorization?.split("Bearer ")[1];
  if (!idToken) return res.status(401).send("Unauthorized");
  try {
    const decoded = await getAuth().verifyIdToken(idToken);
    req.user = decoded;
    next();
  } catch (e) {
    res.status(401).send("Invalid token");
  }
});

app.post("/api/posts", async (req, res) => {
  const db = getFirestore();
  const ref = await db.collection(`tenants/${req.user.tenant_id}/posts`).add({
    title: req.body.title,
    authorId: req.user.uid,
    createdAt: new Date(),
  });
  res.json({ id: ref.id });
});

app.listen(process.env.PORT || 8080);

Step 3: Stripe 課金連携

import Stripe from "stripe";
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);

// Checkout Session 作成
app.post("/api/checkout", async (req, res) => {
  const session = await stripe.checkout.sessions.create({
    mode: "subscription",
    customer_email: req.user.email,
    line_items: [{ price: "price_xxx", quantity: 1 }],
    success_url: "https://app.example.com/success",
    cancel_url: "https://app.example.com/cancel",
    client_reference_id: req.user.tenant_id,
  });
  res.json({ url: session.url });
});

// Webhook 受信
app.post("/webhooks/stripe", express.raw({ type: "application/json" }),
  async (req, res) => {
    const event = stripe.webhooks.constructEvent(
      req.body,
      req.headers["stripe-signature"]!,
      process.env.STRIPE_WEBHOOK_SECRET!
    );

    if (event.type === "checkout.session.completed") {
      const session = event.data.object;
      await getFirestore()
        .collection(`tenants/${session.client_reference_id}/subscriptions`)
        .doc("current")
        .set({ status: "active", stripeCustomerId: session.customer });
    }
    res.json({ received: true });
  }
);

Step 4: Cloud Scheduler バッチ

# Cloud Scheduler → Cloud Run Job 起動
gcloud scheduler jobs create http daily-backup \
  --schedule="0 3 * * *" \
  --uri="https://my-api.run.app/jobs/backup" \
  --http-method=POST \
  --oidc-service-account-email=scheduler-sa@PROJECT.iam.gserviceaccount.com

Step 5: Firestore バックアップ

# Cloud Scheduler → Cloud Functions → Firestore Export
gcloud firestore export gs://my-backup-bucket/${TIMESTAMP} \
  --collection-ids=tenants

# Lifecycle Rule で 90 日後に Archive、365 日後に削除

Step 6: 監視・アラート

• Cloud Monitoring SLO: 99.9% Availability + P95 < 500ms
• Burn Rate Alert: Fast burn (14.4x, 1h) → PagerDuty
• Cloud Logging: Structured Logging (jsonPayload)
• Error Reporting: Crash 自動グルーピング
• Uptime Check: 5 拠点から HTTP 監視

料金例 (月 10K MAU)

ベストプラクティス

• Firebase Auth + Custom Claims (tenant_id / role)
• Firestore Security Rules でテナント分離強制
• Min Instances 0 (Cold Start 許容で月額削減)
• 重要 API のみ Min Instances 1+
• Secret Manager で API キー管理
• Workload Identity で SA キー不要
• Stripe Webhook の冪等性 (event.id で重複処理排除)
• Firestore Composite Index 事前定義

※ Google Cloud、Firebase は Google LLC、Stripe は Stripe, Inc. の登録商標です。