gcp-cloud-run

GCP Cloud Run

目次

• 概要
• 使用する場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

Google Cloud Run を使用すると、インフラストラクチャを管理せずに、コンテナ化されたアプリケーションを大規模にデプロイできます。ステートレスな HTTP コンテナを実行し、ゼロから数千のインスタンスまで自動スケーリングできます。料金が発生するのは、コンピューティングリソースを使用した時間分のみです。

使用する場面

• マイクロサービスと API
• ウェブアプリケーションとバックエンド
• バッチ処理ジョブ
• 長時間実行するバックグラウンドワーカー
• CI/CD パイプラインとの統合
• データ処理パイプライン
• WebSocket アプリケーション
• 複数言語に対応するサービス

クイックスタート

最小限の実行可能な例：

# Build container image
gcloud builds submit --tag gcr.io/MY_PROJECT_ID/my-app:latest

# Deploy to Cloud Run
gcloud run deploy my-app \
  --image gcr.io/MY_PROJECT_ID/my-app:latest \
  --platform managed \
  --region us-central1 \
  --memory 512Mi \
  --cpu 1 \
  --timeout 3600 \
  --max-instances 100 \
  --min-instances 1 \
  --no-allow-unauthenticated \
  --set-env-vars NODE_ENV=production,DATABASE_URL=postgresql://...

# Allow public access
gcloud run services add-iam-policy-binding my-app \
  --platform managed \
  --region us-central1 \
  --member=allUsers \
  --role=roles/run.invoker

# Get service URL
gcloud run services describe my-app \
// ... (see reference guides for full implementation)

リファレンスガイド

詳細な実装は references/ ディレクトリにあります。

ガイド	内容
gcloud CLI を使用した Cloud Run のデプロイ	gcloud CLI を使用した Cloud Run のデプロイ
コンテナ化されたアプリケーション（Node.js）	コンテナ化されたアプリケーション（Node.js）
Terraform による Cloud Run の設定	Terraform による Cloud Run の設定
Docker のビルドとプッシュ	Docker のビルドとプッシュ

ベストプラクティス

✅ 推奨事項

• コンテナのヘルスチェックを使用する
• 適切な CPU とメモリを設定する
• グレースフルシャットダウンを実装する
• 最小権限のサービスアカウントを使用する
• Cloud Logging で監視する
• 保護のために Cloud Armor を有効にする
• ブルーグリーンデプロイにはリビジョン管理を使用する
• 起動プローブとライブネスプローブを実装する

❌ 避けるべきこと

• シークレットをコードに保存する
• デフォルトのサービスアカウントを使用する
• ステートフルなアプリケーションを作成する
• ヘルスチェックを無視する
• テストせずにデプロイする
• 過剰なリソース制限を設定する
• コンテナのファイルシステムにファイルを保存する