Cloud Run へのコンテナ イメージのデプロイ

コンソール

コンテナ イメージをデプロイするには:

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

   Cloud Run に移動

2. [コンテナのデプロイ] をクリックして、[サービスの作成] フォームを表示します。

   1. フォームで、デプロイ オプションを選択します。

      1. コンテナを手動でデプロイする場合は、[既存のコンテナ イメージから 1 つのリビジョンをデプロイする] を選択し、コンテナ イメージを指定します。

      2. 継続的デプロイを自動化する場合は、[ソース リポジトリから新しいリビジョンを継続的にデプロイする] を選択し、継続的デプロイの手順の説明に従ってください。

   2. 必要なサービス名を入力します。サービス名は 49 文字以下で、リージョンとプロジェクトごとに一意である必要があります。サービス名は後から変更することはできません。この名前は一般公開されます。

   3. サービスのリージョンを選択します。リージョン セレクタには、料金階層とドメイン マッピングの可用性が示され、カーボン フットプリントの影響が最も低いリージョンがハイライト表示されます。

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

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

   6. フォームの Ingress 設定を必要に応じて設定します。

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

      • 公開 API またはウェブサイトを作成する場合は、[公開アクセスを許可する] を選択します。これをオンにすると、allUser という特別な ID に IAM 起動元ロールが割り当てられます。サービスの作成後に、IAM を使用してこの設定を編集できます。
      • 認証で保護された安全なサービスが必要な場合は、[認証が必要] を選択します。

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

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

4. サービスの構成が完了したら、[作成] をクリックしてイメージを Cloud Run にデプロイし、デプロイの完了を待ちます。

5. 表示された URL リンクをクリックして、デプロイしたサービスで一意の安定したエンドポイントを開きます。

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 run deploy SERVICE --image IMAGE_URL

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

      • SERVICE: デプロイ先のサービスの名前。サービス名は 49 文字以下で、リージョンとプロジェクトごとに一意である必要があります。サービスがまだ存在しない場合、デプロイ中にこのコマンドによってサービスが作成されます。このパラメータは省略できますが、省略するとサービス名の入力を求められます。
      • 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 の形式です。--image フラグを指定しないと、deploy コマンドでソースコードからのデプロイが試行されます。

      公開 API またはウェブサイトを作成する場合は、--allow-unauthenticated フラグを使用してサービスへの公開アクセスを許可します。これにより、Cloud Run 呼び出し元の IAM ロールが allUsers に割り当てられます。--no-allow-unauthenticated を指定して公開アクセスを禁止することもできます。いずれかのフラグを省略すると、deploy コマンドの実行時に確認のプロンプトが表示されます。

   2. デプロイが完了するまで待ちます。正常に完了すると、デプロイされたサービスの URL が成功のメッセージと一緒に表示されます。

   run/region gcloud プロパティで設定した場所とは異なる場所にデプロイする場合は、次のようにします。

   gcloud run deploy SERVICE --region REGION

YAML

サービス仕様を YAML ファイルに保管してから、gcloud CLI を使用してデプロイできます。

1. 次の内容の新しいファイルを service.yaml という名前で作成します。

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       spec:
         containers:
         - image: IMAGE

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

   • SERVICE: Cloud Run サービスの名前。サービス名は 49 文字以下で、リージョンとプロジェクトごとに一意である必要があります。
   • IMAGE: コンテナ イメージの URL。

   環境変数やメモリ上限など他の構成を指定することもできます。

2. 次のコマンドを使用して新しいサービスをデプロイします。

   gcloud run services replace service.yaml

3. （省略可能）サービスへの未認証アクセスを許可したい場合は、サービスを一般公開にします。

Terraform

Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。

Terraform 構成の google_cloud_run_v2_service リソースに次の内容を追加します。


  provider "google" {
    project = "PROJECT-ID"
  }

  resource "google_cloud_run_v2_service" "default" {
    name     = "SERVICE"
    location = "REGION"
    client   = "terraform"

    template {
      containers {
        image = "IMAGE_URL"
      }
    }
  }

  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: コンテナ イメージへの参照（us-docker.pkg.dev/cloudrun/container/hello:latest など）。Artifact Registry を使用する場合は、リポジトリ REPO_NAME がすでに作成されている必要があります。URL は LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG の形式です。

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

Compose

Compose 仕様を YAML ファイルに保存し、単一の gcloud コマンドを使用して Cloud Run サービスとしてデプロイできます。

compose.yaml ファイルを Cloud Run サービスとしてデプロイする手順は次のとおりです。

1. プロジェクト ディレクトリに、サービス定義を含む compose.yaml ファイルを作成します。

   services:
     web:
       image: IMAGE
       ports:
         - "8080:8080"

   IMAGE は、コンテナ イメージの URL に置き換えます。

   環境変数、シークレット、ボリューム マウントなど、他の構成オプションを指定することもできます。

2. サービスをデプロイするには、gcloud beta run compose up コマンドを実行します。

   gcloud beta run compose up compose.yaml

3. 必要なコンポーネントをインストールするプロンプトや API を有効にするプロンプトが表示されたら、「y」と応答します。

4. 省略可: サービスへの未認証アクセスを許可したい場合は、サービスを一般公開にします。

デプロイが完了すると、Cloud Run サービスの URL が表示されます。この URL をコピーしてブラウザに貼り付けると、実行中のコンテナが表示されます。 Google Cloud コンソールからデフォルトの認証を無効にできます。

クライアント ライブラリ

コードから新しいサービスをデプロイするには:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

新しいサービスをデプロイするには、Cloud Run Admin API の service エンドポイントに POST HTTP リクエストを送信します。

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

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{template: {containers: [{image: "IMAGE_URL"}]}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services?serviceId=SERVICE

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

• ACCESS_TOKEN: サービスをデプロイする IAM 権限を持つアカウントの有効なアクセス トークン。たとえば、gcloud にログインしている場合は、gcloud auth print-access-token を使用してアクセス トークンを取得できます。Cloud Run コンテナ インスタンスからは、コンテナ インスタンス メタデータ サーバーを使用してアクセス トークンを取得できます。
• 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 の形式です。
• SERVICE: デプロイ先のサービスの名前。サービス名は 49 文字以下で、リージョンとプロジェクトごとに一意である必要があります。
• REGION: サービスの Google Cloud リージョン。
• PROJECT-ID: Google Cloud プロジェクト ID。

コンソール

既存のサービスの新しいリビジョンをデプロイするには:

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

   Cloud Run に移動

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

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

   1. 必要に応じて、デプロイする新しいコンテナ イメージの URL を入力します。

   2. 必要に応じてコンテナを構成します。

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

   4. [容量] で、メモリ上限と CPU 上限を指定します。

   5. 必要に応じて、リクエスト タイムアウトと同時実行を指定します。

   6. 必要に応じて実行環境を指定します。

   7. [自動スケーリング] で、最小インスタンスと最大インスタンスを指定します。

   8. 他のタブを使用して、必要に応じて構成します。

      • シークレット
      • 環境変数
      • HTTP/2
      • サービス アカウント
      • Cloud SQL 接続
      • VPC 接続

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 run deploy SERVICE --image IMAGE_URL

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

      • SERVICE: デプロイ先のサービスの名前。このパラメータは省略できますが、省略するとサービス名の入力を求められます。
      • 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 の形式です。

      新しいリビジョンにはリビジョン サフィックスが自動的に割り当てられます。独自のリビジョン サフィックスを指定する場合は、gcloud CLI パラメータ --revision-suffix を使用します。

   2. デプロイが完了するまで待ちます。正常に完了すると、デプロイされたサービスの URL が成功のメッセージと一緒に表示されます。

YAML

既存のサービスの構成をダウンロードや表示する場合は、次のコマンドを使用して結果を YAML ファイルに保存します。

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

サービス構成 YAML ファイルで、任意の spec.template 子属性を変更してリビジョン設定を更新してから、新しいリビジョンをデプロイします。

gcloud run services replace service.yaml

Cloud Code

Cloud Code を使用して既存のサービスの新しいリビジョンをデプロイする方法については、IntelliJ と Visual Studio Code のガイドをご覧ください。

Terraform

新しいサービスのデプロイの例で説明されているように Terraform を設定していることを確認します。

1. 構成ファイルに変更を行います。

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

   terraform apply

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

Compose

Compose 仕様を YAML ファイルに保存し、1 つの gcloud コマンドを使用して Cloud Run サービス リビジョンとしてデプロイできます。

compose.yaml ファイルを Cloud Run サービス リビジョンとしてデプロイする手順は次のとおりです。

1. プロジェクト ディレクトリに、サービス定義を含む compose.yaml ファイルを作成します。

   services:
     web:
       image: IMAGE
       ports:
         - "8080:8080"

   IMAGE は、コンテナ イメージの URL に置き換えます。

   環境変数、シークレット、ボリューム マウントなど、他の構成オプションを指定することもできます。

2. サービスをデプロイするには、gcloud beta run compose up コマンドを実行します。

   gcloud beta run compose up compose.yaml

3. 必要なコンポーネントをインストールするプロンプトや API を有効にするプロンプトが表示されたら、「y」と応答します。

4. 省略可: サービスへの未認証アクセスを許可したい場合は、サービスを一般公開にします。

デプロイが完了すると、Cloud Run サービスの URL が表示されます。この URL をコピーしてブラウザに貼り付けると、実行中のコンテナが表示されます。 Google Cloud コンソールからデフォルトの認証を無効にできます。

クライアント ライブラリ

コードから新しいリビジョンをデプロイするには:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

新しいリビジョンをデプロイするには、Cloud Run Admin API の service エンドポイントに PATCH HTTP リクエストを送信します。

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

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X PATCH \
  -d '{template: {containers: [{image: "IMAGE_URL"}]}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE

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

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