gcp-cloud-functions

GCP Cloud Functions

目次

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

概要

Google Cloud Functions を使用すると、Google Cloud Platform 上でイベント駆動型のサーバーレスコンピューティングを利用できます。自動スケーリング、統合されたセキュリティ、Google Cloud サービスとのシームレスな連携を備えた関数を構築し、迅速に開発できます。

使用する場面

• HTTP API と Webhook
• Pub/Sub メッセージの処理
• ストレージバケットのイベント
• Firestore データベースのトリガー
• Cloud Scheduler のジョブ
• リアルタイムデータ処理
• 画像と動画の処理
• データパイプラインのオーケストレーション

クイックスタート

最小限の動作例：

# Install Google Cloud SDK
curl https://sdk.cloud.google.com | bash
exec -l $SHELL

# Initialize and authenticate
gcloud init
gcloud auth application-default login

# Set project
gcloud config set project MY_PROJECT_ID

# Create service account
gcloud iam service-accounts create cloud-function-sa \
  --display-name "Cloud Function Service Account"

# Grant permissions
gcloud projects add-iam-policy-binding MY_PROJECT_ID \
  --member="serviceAccount:cloud-function-sa@MY_PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/cloudfunctions.invoker"

# Deploy HTTP function
gcloud functions deploy my-http-function \
  --gen2 \
  --runtime nodejs18 \
  --region us-central1 \
// ... (see reference guides for full implementation)

リファレンスガイド

詳細な実装については、references/ ディレクトリを参照してください。

ガイド	内容
gcloud CLI による Cloud Function の作成	gcloud CLI による Cloud Function の作成
Cloud Functions の実装（Node.js）	Cloud Functions の実装（Node.js）
Terraform による Cloud Functions の設定	Terraform による Cloud Functions の設定

ベストプラクティス

✅ 推奨事項

• 最小権限のサービスアカウントを使用します
• シークレットは Secret Manager に保存します
• 適切なエラー処理を実装します
• 設定には環境変数を使用します
• Cloud Logging と Cloud Monitoring で監視します
• 適切なメモリとタイムアウトを設定します
• イベントフィルターを使用して呼び出しを減らします
• 冪等性のある関数を実装します

❌ 禁止事項

• シークレットをコードに保存しないでください
• デフォルトのサービスアカウントを使用しないでください
• 長時間実行される関数を作成しないでください
• エラー処理を無視しないでください
• テストせずにデプロイしないでください
• 機密性の高い関数に認証なしのアクセスを使用しないでください