このページは Cloud Translation API によって翻訳されました。

Cloud Run サービスを管理する

このページでは、サービスを作成する方法とサービスの情報を表示する方法について説明します。

各サービスには一意で永続的な run.app URL があります。この URL は、新しいリビジョンをサービスにデプロイしても変わりません。Cloud Run にデプロイされた関数もサービスとして扱われ、run.app アドレスが割り当てられます。サービスの永続ドメインは、サービス名とハッシュで構成されます。

必要なロール

Cloud Run のサービスとリビジョンを管理するために必要な権限を取得するには、Cloud Run サービスに対する Cloud Run デベロッパー（roles/run.developer）IAM ロールを付与するよう管理者に依頼してください。

Cloud Run に関連付けられている IAM ロールと権限のリストについては、Cloud Run IAM ロールと Cloud Run IAM 権限をご覧ください。Cloud Run サービスがGoogle Cloud APIs（Cloud クライアントライブラリなど）と連携している場合は、サービス ID の構成ガイドをご覧ください。ロールの付与の詳細については、デプロイ権限とアクセスの管理をご覧ください。

サービスを作成する

コンテナイメージを最初にデプロイするときに、新しいサービスが作成されます。新しいサービスをデプロイする場合は、これよりも操作が多くなります。

プロジェクト内のサービスのリストを表示する

プロジェクトで使用可能なサービスの一覧は、 Google Cloud コンソールまたは Google Cloud CLI を使用して表示できます。

コンソール

サービスリストを表示するには:

Google Cloud コンソールで Cloud Run に移動します。

Cloud Run に移動
プロジェクトに表示されたサービスのリストを調べます。

gcloud

プロジェクトのサービスを一覧取得するには:

gcloud run services list

サービスには URL が関連付けられています。

割り当てられたラベルなど、サービス定義のプロパティを基準にこのリストをフィルタできます。

Cloud Code

Cloud Code でサービスを一覧表示するには、IntelliJ と Visual Studio Code に関する Cloud Run Explorer ガイドをご覧ください。

クライアントライブラリ

コードからサービスのリストを表示するには:

REST API

プロジェクト内のサービスの一覧を表示するには、GET HTTP リクエストを Cloud Run Admin API の service エンドポイントに送信します。

curl の使用例を次に示します。

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services

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

ACCESS_TOKEN は、サービスを表示する IAM 権限を持つアカウントの有効なアクセストークンに置き換えます。たとえば、gcloud にログインしている場合は、gcloud auth print-access-token を使用してアクセストークンを取得できます。Cloud Run コンテナインスタンスから、コンテナインスタンスメタデータサーバーを使用してアクセストークンを取得できます。
REGION は、サービスの Google Cloud リージョンに置き換えます。
PROJECT-ID は、 Google Cloud プロジェクト ID に置き換えます。

プロジェクト内の関数のリストを表示する

Google Cloud コンソールを使用して、プロジェクトで使用可能な関数のリストを表示できます。

コンソール

サービスリストの関数をフィルタするには:

Google Cloud コンソールで Cloud Run に移動します。

Cloud Run に移動
プロジェクトに表示されたサービスのリストを調べます。
[サービスをフィルタ] > [デプロイタイプ] > [関数] を選択します。

以前に Cloud Functions（第 2 世代 API）を使用して関数をデプロイした場合は、[デプロイしたユーザー] 列に「Cloud Functions」と表示されます。

サービスをコピーする

Google Cloud コンソールまたは YAML を使用して、既存のサービスのコピーを作成できます。名前やリージョンなど、コピーに含まれる任意の要素を変更できます。

Console

サービスをコピーするには:

Google Cloud コンソールで Cloud Run に移動します。

Cloud Run に移動
プロジェクトに関して表示されるサービスのリストから、コピーするサービスを選択します。
1. [コピー] をクリックします。
2. サービスのコピーのページで、必要に応じて値（リージョンなど）を設定または変更します。同じリージョンを保持する場合は、サービスに新しい名前を付ける必要があります。
3. [作成] をクリックするとコピーが作成され、新しいサービス名を使ってそれがデプロイされます。

YAML

新しいサービスを作成する場合は、この手順をスキップします。既存のサービスを更新する場合は、その YAML 構成をダウンロードします。
```
gcloud run services describe SERVICE --format export > service.yaml
```
サービスに対して次の構成変更を行います。
```
 apiVersion: serving.knative.dev/v1
 kind: Service
 metadata:
   annotations:
     ...
   name: SERVICE
   ...
 spec:
   template:
     metadata:
       annotations:
       ...
       name: REVISION
```
- コピーを別のリージョンにデプロイしない場合は、SERVICE を、そのコピーに使用する名前に置き換えます。コピーを別のリージョンにデプロイする場合は、元の名前を使用できます。
- REVISION を新しいリビジョン名に置き換えるか、削除（存在する場合）します。新しいリビジョン名を指定する場合は、次の条件を満たす必要があります。
  - SERVICE- で始まる
  - 小文字、数字、- のみが使用されている
  - 末尾が - ではない
  - 63 文字以内である
次のコマンドを使用してサービスをコピーします。
```
gcloud run services replace service.yaml
```
コピーを別のリージョンにデプロイするには、--region フラグを使用します。

サービスの詳細を表示する

サービスの詳細は、 Google Cloud コンソール、Google Cloud CLI、YAML ファイル、または REST API を使用して表示できます。

コンソール

サービスの詳細を表示するには:

Google Cloud コンソールで Cloud Run に移動します。

Cloud Run に移動
表示されているサービスの一覧でサービスをクリックし、サービスの詳細ビューを開きます。

gcloud

サービスの詳細を表示するには:

gcloud run services describe SERVICE

SERVICE は、サービスの名前に置き換えます。

--format フラグを使用して出力をフォーマットできます。たとえば、YAML としてフォーマットします。

gcloud run services describe SERVICE --region REGION --format yaml

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

SERVICE は、サービスの名前に置き換えます。
REGION は、サービスの Google Cloud リージョンに置き換えます。

--format export を使用すると、自動生成のラベルやステータスを含まない YAML としてエクスポートできます。

gcloud run services describe SERVICE --region REGION --format export

--format フラグを使用して、サービスの URL を取得することもできます。

gcloud run services describe SERVICE --region REGION --format='value(status.url)'

Cloud Code

Cloud Code でサービスの詳細を表示するには、IntelliJ と Visual Studio Code に関する Cloud Run Explorer ガイドをご覧ください。

サービスのリビジョンの詳細については、リビジョンの管理をご覧ください。

クライアントライブラリ

コードからサービスの詳細を表示するには:

REST API

サービスの詳細を表示するには、GET HTTP リクエストを Cloud Run Admin API の service エンドポイントに送信します。

curl の使用例を次に示します。

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME

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

ACCESS_TOKEN は、サービスの詳細を表示する IAM 権限を持つアカウントの有効なアクセストークンに置き換えます。たとえば、gcloud にログインしている場合は、gcloud auth print-access-token を使用してアクセストークンを取得できます。Cloud Run コンテナインスタンスから、コンテナインスタンスメタデータサーバーを使用してアクセストークンを取得できます。
SERVICE-NAME は、サービスの名前に置き換えます。
REGION: サービスの Google Cloud リージョン。
PROJECT-ID は、 Google Cloud プロジェクト ID に置き換えます。

既存のサービスを無効にする

既存の Cloud Run サービスとリビジョンを無効にするために必要な権限を取得するには、プロジェクトに対する Cloud Run 管理者（roles/run.admin）IAM ロールを付与するよう管理者に依頼してください。

サービスを無効にしても、現在処理中のリクエストは完了できます。ただし、サービス URL に対するその後のリクエストは失敗し、Service unavailable または Service disabled のエラーが発生します。

トラフィックタグが原因でのみアクティブになっているサービスリビジョンへのリクエストは、リビジョンが無効になっていないため影響を受けません。

サービスを無効にするには、スケーリングをゼロに設定します。サービスは、 Google Cloud コンソール、Google Cloud CLI、YAML ファイル、または API を使用して無効にできます。

コンソール

Google Cloud コンソールで Cloud Run に移動します。

Cloud Run に移動
無効にするサービスをクリックして詳細パネルを表示し、詳細パネルの右上にある [スケーリング] の横にある鉛筆アイコンをクリックします。
[スケーリングを編集] フォームを見つけて、[手動スケーリング] を選択します。

[インスタンス数] フィールドに値 0（ゼロ）を入力します。
[保存] をクリックします。

gcloud

サービスを無効にするには、次のコマンドを使用してスケーリングをゼロに設定します。

gcloud run services update SERVICE --scaling=0

SERVICE は、実際のサービス名に置き換えます。

YAML

サービスの YAML 構成をダウンロードします。

gcloud run services describe SERVICE --format export > service.yaml

manualInstanceCount 属性をゼロ（0）に設定します。

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
  annotations:
  run.googleapis.com/scalingMode: manual
  run.googleapis.com/manualInstanceCount: `0`

SERVICE は、Cloud Run サービスの名前に置き換えます。

次のコマンドを使用して、サービスを作成または更新します。
```
gcloud run services replace service.yaml
```

REST API

サービスを無効にするには、Cloud Run Admin API の service エンドポイントに PATCH HTTP リクエストを送信します。

curl の使用例を次に示します。

    curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer ACCESS_TOKEN" \
    -X PATCH \
    -d '{"scaling":{"manualInstanceCount":0 }}' \
    https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE?update_mask=scaling.manualInstanceCount

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

ACCESS_TOKEN: サービスを更新する IAM 権限を持つアカウントの有効なアクセストークン。たとえば、gcloud にログインしている場合は、gcloud auth print-access-token を使用してアクセストークンを取得できます。Cloud Run コンテナインスタンスからは、コンテナインスタンスメタデータサーバーを使用してアクセストークンを取得できます。
SERVICE: サービスの名前。
REGION: サービスがデプロイされている Google Cloud リージョン。
PROJECT_ID: Google Cloud プロジェクト ID。

Terraform

サービスを無効にするには、manual_instance_count 属性をゼロ（0）に設定します。

resource "google_cloud_run_v2_service" "default" {
  name     = "SERVICE_NAME"
  location = "REGION"

  template {
    containers {
      image = "IMAGE_URL"
    }
  }
  scaling {
    scaling_mode = "MANUAL"
    manual_instance_count = "0"
  }
}

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

SERVICE_NAME: Cloud Run サービスの名前。
REGION: Google Cloud のリージョン。例: europe-west1
IMAGE_URL: コンテナイメージへの参照（us-docker.pkg.dev/cloudrun/container/hello:latest など）。Artifact Registry を使用する場合は、リポジトリ REPO_NAME がすでに作成されている必要があります。URL は LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG の形式です。

既存のサービスを削除する

サービスを削除する場合は、次の点に注意してください。

サービスを削除すると、トラフィック処理中であるかどうかにかかわらず、このサービスに関連するすべてのリソースが削除されます。このサービスのリビジョンもすべて削除されます。
サービスを削除しても、Artifact Registry からコンテナイメージが自動的に削除されることはありません。削除されたリビジョンで使用されているコンテナイメージを Artifact Registry から削除するには、イメージの削除をご覧ください。
1 つ以上の Eventarc トリガーを持つサービスを削除しても、これらのトリガーは自動的に削除されません。トリガーを削除するには、トリガーを管理するをご覧ください。
削除が完全に完了するまで、 Google Cloud コンソールとコマンドラインインターフェースにはサービスが表示されています。ただし、サービスの更新はできません。
サービスは完全に削除されます。元に戻すことも、復元することもできません。サービスを削除した後、同じリージョンに同じ名前のサービスを新たにデプロイすると、同じエンドポイント URL が使用されます。
Cloud Run functions を削除すると、新しいリクエストの受け入れが停止します。ただし、Cloud Run は実行中のインスタンスをすぐに終了しません。代わりに、関数は構成されたタイムアウト内でタスクが完了するまで実行されます。このため、関数を削除した後、短期間ログにアクティブとして表示されることがあります。

サービスまたは関数は、 Google Cloud コンソール、Google Cloud CLI、YAML ファイル、または REST API を使用して削除できます。

コンソール

サービスを削除するには:

Google Cloud コンソールで Cloud Run に移動します。

Cloud Run に移動
削除するサービスをサービスリストで探し、そのチェックボックスをクリックして選択します。
[削除] をクリックします。これにより、サービスのすべてのリビジョンが削除されます。

gcloud

サービスを削除するには、次のコマンドを使用します。

gcloud run services delete SERVICE --region REGION

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

SERVICE は、実際のサービスの名前に置き換えます。
REGION は、サービスの Google Cloud リージョンに置き換えます。

クライアントライブラリ

コードからサービスを削除するには:

REST API

サービスを削除するには、Cloud Run Admin API の service エンドポイントに DELETE HTTP リクエストを送信します。

curl の使用例を次に示します。

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X DELETE \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME

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

ACCESS_TOKEN は、サービスを削除する IAM 権限を持つアカウントの有効なアクセストークンに置き換えます。たとえば、gcloud にログインしている場合は、gcloud auth print-access-token を使用してアクセストークンを取得できます。Cloud Run コンテナインスタンスから、コンテナインスタンスメタデータサーバーを使用してアクセストークンを取得できます。
SERVICE-NAME は、サービスの名前に置き換えます。
REGION: サービスの Google Cloud リージョン。
PROJECT-ID は、 Google Cloud プロジェクト ID に置き換えます。

Cloud Run サービスを管理する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

必要なロール

サービスを作成する

プロジェクト内のサービスのリストを表示する

コンソール

gcloud

Cloud Code

クライアント ライブラリ

REST API

プロジェクト内の関数のリストを表示する

コンソール

サービスをコピーする

Console

YAML

サービスの詳細を表示する

コンソール

gcloud

Cloud Code

クライアント ライブラリ

REST API

既存のサービスを無効にする

コンソール

gcloud

YAML

REST API

Terraform

既存のサービスを削除する

コンソール

gcloud

クライアント ライブラリ

REST API

Cloud Run サービスを管理する

クライアントライブラリ

クライアントライブラリ

クライアントライブラリ