Cloud Run で関数をデプロイする

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

コンソール

1. Google Cloud コンソールで [Cloud Run] ページに移動します。

   Cloud Run に移動

2. [関数を作成] をクリックします。

3. [サービス名] フィールドに、関数を表す名前を入力します。サービス名は、先頭を英字にして、49 文字以下の英字、数字、ハイフンで構成します。サービス名はハイフンで終わることはできません。また、リージョンとプロジェクトごとに一意にする必要があります。サービス名は後から変更することはできません。この名前は一般公開されます。

4. [リージョン] リストで、デフォルト値を使用するか、コンテナをデプロイするリージョンを選択します。

5. [ランタイム] リストで、デフォルト値を使用するか、ランタイム バージョンを選択します。

6. 必要に応じて、[トリガー] セクションで [トリガーを追加] をクリックし、オプションを選択します。[Eventarc トリガー] ペインが開き、トリガーの詳細を変更できます。

   1. [トリガー名] フィールドにトリガーの名前を入力するか、デフォルトの名前を使用します。

   2. リストからトリガーのタイプを選択して、次のいずれかのトリガータイプを指定します。

      • Google のソース: Pub/Sub、Cloud Storage、Firestore などの Google イベント プロバイダのトリガーを指定できます。

      • カスタム: アプリケーション コードからイベントを生成して使用します。[Eventarc トリガー] ペインのプロンプトに従ってチャネルを作成します。チャネルは、カスタム イベントをプロデューサーからコンシューマーに配信するパイプラインとして使用されるリソースです。カスタム イベントはチャネルに公開され、Eventarc トリガーがこれらのイベントに登録されます。

      • サードパーティ: Eventarc ソースを提供する Google 以外のプロバイダと統合できます。詳細については、Eventarc のサードパーティ イベントをご覧ください。

   3. リストから [イベント プロバイダ] を選択し、関数をトリガーするイベントのタイプを提供するプロダクトを選択します。イベント プロバイダのリストについては、イベント プロバイダと宛先をご覧ください。

   4. リストからイベントタイプを選択します。トリガーの構成は、サポートされているイベントタイプによって異なります。詳細については、イベントタイプをご覧ください。

   5. [リージョン] フィールドで、Eventarc トリガーのロケーションを選択します。一般に、Eventarc トリガーのロケーションは、イベントをモニタリングする Google Cloud リソースのロケーションと一致している必要があります。ほとんどの場合に、関数を同じリージョンにデプロイすることも必要です。Eventarc トリガーのロケーションの詳細については、Eventarc のロケーションについてをご覧ください。

   6. [サービス アカウント] フィールドで、サービス アカウントを選択します。Eventarc トリガーはサービス アカウントにリンクされ、関数を呼び出すときに ID として使用します。Eventarc トリガーのサービス アカウントには、関数を呼び出す権限が必要です。デフォルトでは、Cloud Run は Compute Engine のデフォルトのサービス アカウントを使用します。

   7. 受信リクエストの送信先であるサービスの URL パスを指定することもできます。これは、トリガーのイベントの送信先である宛先サービスの相対パスです。例: /、/route、route、route/subroute.

   8. 必須フィールドに値を入力したら、[トリガーを保存] をクリックします。

7. [認証] で、次の構成を行います。

   • 公開 HTTP 関数（Webhook など）を作成する場合は、[未認証の呼び出しを許可する] を選択します。これをオンにすると、IAM 起動元ロールに特別な allUser が割り当てられます。サービスの作成後に、IAM を使用してこの設定を編集できます。これを選択する権限（Cloud Run 管理者ロール）がない場合は、サービスがデプロイされ、認証が必要になります。

   • イベント トリガー関数を作成する場合は、[認証が必要] を選択します。

8. 必要に応じて、関数の次の追加構成を更新します。

   1. 必要に応じて [お支払い情報] を設定します。

   2. [サービスのスケーリング] で、デフォルトの Cloud Run 自動スケーリングを使用する場合は、必要に応じて最小インスタンスを指定します。手動スケーリングを使用する場合は、サービスのインスタンス数を指定します。

   3. 必要に応じて、上り（内向き）の制御の設定を行います。

   4. [コンテナ、ボリューム、ネットワーキング、セキュリティ] セクションを開き、該当するタブでその他のオプション設定を指定します。

      • 同時実行
      • コンテナ構成
      • CPU 制限
      • メモリ制限
      • リクエスト タイムアウト
      • シークレット
      • 環境変数
      • 実行環境
      • HTTP/2
      • サービス アカウント
      • Cloud SQL 接続
      • VPC 接続

9. [作成] をクリックし、Cloud Run がプレースホルダ リビジョンを使用してサービスを作成するのを待ちます。

10. コンソールの [ソース] タブにリダイレクトされ、関数のソースコードが表示されます。[保存して再デプロイ] をクリックします。

11. [ソース] タブで、必要に応じて [ペイロードを表示] をクリックして、受信イベントのペイロードの例を確認できます。

12. デプロイが完了したら、[テスト] ボタンをクリックして、作成した関数をテストします。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. gcloud コンポーネントを最新バージョンに更新します。

   gcloud components update

3. サンプルコードを含むディレクトリで次のコマンドを実行します。

   gcloud run deploy FUNCTION \
          --source . \
          --function FUNCTION_ENTRYPOINT \
          --base-image BASE_IMAGE \
          --region REGION
   

   次のように置き換えます。

   • FUNCTION: デプロイする関数の名前。このパラメータは省略できますが、省略すると名前の入力を求められます。

   • FUNCTION_ENTRYPOINT: ソースコード内の関数のエントリ ポイント。これは、関数の実行時に Cloud Run が実行するコードです。このフラグには、ソースコード内に存在する関数名または完全修飾クラス名を指定する必要があります。

   • BASE_IMAGE: 関数のベースイメージ環境。ベースイメージと各イメージに含まれるパッケージの詳細については、ランタイム ベースイメージをご覧ください。

   • REGION は、関数をデプロイする Google Cloud リージョンに置き換えます。例: us-central1。

   オプション:

   • 公開 HTTP 関数（Webhook など）を作成する場合は、--allow-unauthenticated フラグを指定します。このフラグは、Cloud Run IAM 起動元ロールを特別な ID allUser に割り当てます。サービスの作成後に、IAM を使用してこの設定を編集できます。イベント トリガー関数または認証済みサービスを作成する場合は、このフラグを省略できます。

必要に応じて、関数をデプロイした後、Eventarc トリガーを関数に追加できます。トリガーを追加するには、次のコマンドを実行します。

  gcloud eventarc triggers create EVENTARC_TRIGGER_NAME \
      --location=EVENTARC_TRIGGER_LOCATION \
      --destination-run-service=FUNCTION \
      --destination-run-region=REGION \
      --event-filters="type=EVENTARC_FILTER_TYPE" \
      --event-filters="EVENTARC_EVENT_FILTER" \
      --service-account=EVENTARC_TRIGGER_SERVICE_ACCOUNT

次のように置き換えます。

• EVENTARC_TRIGGER_NAME: Eventarc トリガーの名前。

• EVENTARC_TRIGGER_LOCATION は、Eventarc トリガーのロケーションに置き換えます。一般に、Eventarc トリガーのロケーションは、イベントをモニタリングする Google Cloud リソースのロケーションと一致している必要があります。ほとんどの場合に、関数を同じリージョンにデプロイすることも必要です。Eventarc トリガーのロケーションの詳細については、Eventarc のロケーションについてをご覧ください。

• FUNCTION: デプロイされた関数の名前。

• REGION: 関数の Cloud Run リージョン。

• EVENTARC_FILTER_TYPE: トリガーがモニタリングするイベント フィルタ。--event-filters フィルタにすべて一致するイベントが関数の呼び出しをトリガーします。必須: 各トリガーには、サポートされているイベントタイプを --event-filters="type=EVENTARC_FILTER_TYPE" の形式で指定する必要があります。作成後は、このイベントタイプは変更できません。EVENT_FILTER_TYPE を変更するには、新しいトリガーを作成して古いトリガーを削除します。（省略可）さらにフィルタを追加するには、--event-filters フラグを繰り返し、サポートされているフィルタを ATTRIBUTE=VALUE の形式で指定します。

• EVENTARC_TRIGGER_SERVICE_ACCOUNT: サービス アカウント。Eventarc トリガーはサービス アカウントにリンクされ、関数を呼び出すときに ID として使用します。Eventarc トリガーのサービス アカウントには、関数を呼び出す権限が必要です。デフォルトでは、Cloud Run はデフォルトのコンピューティング サービス アカウントを使用します。

Terraform

Terraform を使用して関数を管理するには、関数コードをコンテナ イメージに構築し、Google Cloud Platform Provider の google_cloud_run_v2_service リソースを使用して Terraform 構成で Cloud Run サービスを定義する必要があります。

1. 関数をスクラッチでビルディングするの手順に沿って、セキュリティの自動更新と互換性のあるコンテナ イメージを作成します。次の手順で使用する IMAGE_URL 変数にコンテナ イメージの完全なパスをコピーします。

2. 新しい main.tf ファイルをこの内容で作成します。

   provider "google" {
     project = "PROJECT-ID"
   }
   
   resource "google_cloud_run_v2_service" "default" {
     name     = "SERVICE"
     location = "REGION"
     client   = "terraform"
     template {
       containers {
         name = "SERVICE"
         image = "IMAGE_URL" # Container image built from your function in the previous step.
         base_image_uri = "BASE_IMAGE"
       }
     }
     build_config{
       function_target = "FUNCTION_TARGET"
       image_uri = "IMAGE_URL"
       base_image = "BASE_IMAGE"
       enable_automatic_updates = true
     }
   }
   resource "google_cloud_run_v2_service_iam_member" "noauth" {
     location = google_cloud_run_v2_service.default.location
     name     = google_cloud_run_v2_service.default.name
     role     = "roles/run.invoker"
     member   = "allUsers"
   }
   

   次のように置き換えます。

   • PROJECT-ID は、 Google Cloud プロジェクト ID に置き換えます。
   • REGION は、 Google Cloud リージョンに置き換えます。
   • SERVICE: Cloud Run サービスの名前。サービス名は 49 文字以下で、リージョンとプロジェクトごとに一意である必要があります。
   • IMAGE_URL: ビルドされた関数のみを含むコンテナ イメージへの参照
   • BASE_IMAGE は、ベースイメージへの参照（us-central1-docker.pkg.dev/serverless-runtimes/google-22-full/runtimes/nodejs22:public-image-current など）に置き換えます。サポートされているランタイムとそのベースイメージの一覧については、ランタイム ベースイメージをご覧ください。
   • FUNCTION_TARGET は、エントリ ポイントとして使用する関数名に置き換えます。

   この構成では公開アクセスが可能になります（--allow-unauthenticated と同等）。サービスを非公開にするには、google_cloud_run_v2_service_iam_member スタンザを削除します。

3. Terraform を初期化します。

   terraform init

4. Terraform 構成を適用します。

   terraform apply

   yes と入力して、記述されている操作を適用することを確認します。

gcloud

gcloud run deploy FUNCTION \
  --source . \
  --function FUNCTION_ENTRYPOINT \
  --base-image BASE_IMAGE \
  --region REGION \
  --image IMAGE_URL

次のように置き換えます。

• FUNCTION: デプロイする関数の名前。このパラメータは省略できますが、省略すると名前の入力を求められます。

• FUNCTION_ENTRYPOINT: ソースコード内の関数のエントリ ポイント。これは、関数の実行時に Cloud Run が実行するコードです。このフラグには、ソースコード内に存在する関数名または完全修飾クラス名を指定する必要があります。

• BASE_IMAGE: 関数のベースイメージ環境。ベースイメージと各イメージに含まれるパッケージの詳細については、ランタイム ベースイメージをご覧ください。

• REGION は、関数をデプロイする Google Cloud リージョンに置き換えます。例: us-central1。

• IMAGE_URL は、任意の Artifact Registry イメージ リポジトリを使用するイメージパスへの参照に置き換えます（projects/PROJECT_NAME/locations/LOCATION/repositories/REPOSITORY_NAME/FUNCTION など）。イメージ名は、作成する関数の名前と一致している必要があります。リポジトリパスのみを指定した場合は、関数名 FUNCTiON を使用してイメージが作成されます。

別のプロジェクトまたはリージョンにある Artifact Registry リポジトリを指定する場合は、次の点を考慮する必要があります。

IAM 構成:

• 他の Google Cloud プロジェクトからイメージをデプロイするための IAM 権限が構成されていることを確認します。
• また、構築サービス アカウントに、REPOSITORY に対する読み取りと書き込みのアクセス権が付与されていることを確認します。

ネットワークの構成:

• 現在のプロジェクト構成からターゲット REPOSITORY に到達できることを確認します。

VPC Service Controls の構成:

• ビルド サービス アカウントが VPC-SC 境界内のターゲット REPOSITORY に到達できることを確認します。

データ所在地の制約:

• 関数があるリージョンとは異なるリージョンに REPOSITORY を指定すると、リージョン間でデータが転送されます。

コンソール

1. Google Cloud コンソールで [Cloud Run] ページに移動します。

   Cloud Run に移動

2. サービスリストで更新したいサービスをクリックして、サービスの詳細を表示します。

3. [新しいリビジョンの編集とデプロイ] をクリックして、リビジョンのデプロイ フォームを表示します。

4. 構成設定を変更します。

5. [デプロイ] をクリックして、デプロイが完了するまで待ちます。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. 1 つ以上のサービス構成設定を更新するには、更新する構成のコマンドライン フラグを指定して gcloud beta run services update SERVICE コマンドを使用します。SERVICE は、サービスの名前に置き換えます。

コンソール

1. Google Cloud コンソールで [Cloud Run] ページに移動します。

   Cloud Run に移動

2. [サービス] リストで更新したいサービスをクリックして、サービスの詳細を表示します。

3. [ソース] タブに移動し、[ソースを編集] をクリックします。

4. ベースイメージの横にある [modeランタイムとセキュリティ アップデートを編集] をクリックし、必要に応じてリストから別のランタイムまたは環境を選択して、[保存] をクリックします。

5. 必要に応じて、関数のエントリ ポイントを変更します。

6. [ファイル] セクションで、add [ファイルを追加] を選択して新しいファイルを作成するか、[modeファイルの名前を変更] を選択してファイルの名前を変更するか、[deleteファイルを削除] を選択してファイルを削除します。

7. [コード] セクションで、必要に応じてソースコードを変更します。

8. [保存して再デプロイ] をクリックし、デプロイが完了するまで待ちます。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. 関数のソースコードを含むディレクトリで、次のコマンドを実行します。

   gcloud run deploy FUNCTION \
          --source . \
          --function FUNCTION_ENTRYPOINT \
          --base-image BASE_IMAGE \
          --region REGION
   

   次のように置き換えます。

   • FUNCTION: 変更する関数の名前。

   • FUNCTION_ENTRYPOINT: ソースコード内の関数のエントリ ポイント。

   • BASE_IMAGE: 関数のベースイメージ環境。ほとんどの場合、ランタイム ID（nodejs22 など）を指定できます。

     スタックで特定のシステム パッケージを使用する場合や、ベースイメージをダウンロードするリージョンを指定する場合は、次のいずれかを指定します。

     • ベースイメージの完全なパス（us-central1-docker.pkg.dev/serverless-runtimes/google-22-full/runtimes/nodejs22 など）。このオプションを使用すると、ベースイメージ、スタック内の特定のシステム パッケージ、ベースイメージをダウンロードするリージョンを指定できます。
     • ベースイメージの完全なパスのエイリアス（google-22/nodejs22、google-22-full/nodejs22 など）。この短いエイリアス オプションを使用すると、スタック内のベースイメージと特定のシステム パッケージを指定できます。

     ベースイメージと各イメージに含まれるパッケージの詳細については、ランタイム ベースイメージをご覧ください。

   • REGION は、関数をデプロイする Google Cloud リージョンに置き換えます。例: us-central1。

   オプション フラグ

   関数を変更するときに、次のオプション フラグを構成できます。

   • ビルド環境変数フラグ。ビルドステップ中に環境変数を指定します（ビルド時に固有の証明書やパラメータの構成など）。

   • ワーカープール フラグ。VPC Service Controls で保護されたビルド コンテキストで使用するワーカープールを指定します。

   • カスタム ビルド サービス アカウント フラグ。セキュリティを強化するために、デフォルトのビルド サービス アカウントの代替を指定します。

   • ベースイメージの自動更新フラグ: 自動更新を無効にします。デフォルトでは、関数のセキュリティの自動更新が有効になっています。