クイックスタート: Cloud Run インスタンスを作成する

このページでは、Cloud Run を使用してサンプル コンテナに Cloud Run インスタンスを作成し、そのログを表示して、gcloud CLI を使用してライフサイクルを管理する方法について説明します。

始める前に

  1. アカウントに Google Cloud ログインします。 を初めて使用する場合は、 Google Cloud、 アカウントを作成して、 実際のシナリオでプロダクトがどのように機能するかを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

  2. Google Cloud CLI をインストールします。

  3. 外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

  4. gcloud CLI を初期化するには、次のコマンドを実行します: 

    gcloud init

  5. プロジェクトを Google Cloud 作成または選択します。

    プロジェクトを選択または作成するために必要なロール

    • プロジェクトを選択する: プロジェクトの選択には特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトを選択できます。
    • プロジェクトを作成する: プロジェクトを作成するには、プロジェクト作成者ロール （roles/resourcemanager.projectCreator）が必要です。これには resourcemanager.projects.create 権限が含まれています。詳しくは、ロールを付与する方法をご覧ください。

    • プロジェクトを作成する Google Cloud :

      gcloud projects create PROJECT_ID

      PROJECT_ID は、作成する Google Cloud プロジェクトの名前に置き換えます。

    • 作成した Google Cloud プロジェクトを選択します。

      gcloud config set project PROJECT_ID

      PROJECT_ID は、 Google Cloud プロジェクトの名前に置き換えます。

  6. このガイドで既存のプロジェクトを使用する場合は、 このガイドを完了するために必要な権限があることを 確認します。新しいプロジェクトを作成した場合は、 必要な権限がすでに付与されています。

  7. プロジェクト Google Cloud に対して課金が有効になっていることを確認します。

  8. Cloud Run Admin API と Cloud Logging API を有効にします。

    API を有効にするために必要なロール

    API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を通じてこの権限が付与されている可能性があります。それ以外の場合は、サービス使用管理者ロール（roles/serviceusage.serviceUsageAdmin）を通じてこの権限を取得できます。ロールを付与する方法をご覧ください。

    gcloud services enable run.googleapis.com logging.googleapis.com

  9. Google Cloud CLI をインストールします。

  10. 外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

  11. gcloud CLI を初期化するには、次のコマンドを実行します: 

    gcloud init

  12. プロジェクトを Google Cloud 作成または選択します。

    プロジェクトを選択または作成するために必要なロール

    • プロジェクトを選択する: プロジェクトの選択には特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトを選択できます。
    • プロジェクトを作成する: プロジェクトを作成するには、プロジェクト作成者ロール （roles/resourcemanager.projectCreator）が必要です。これには resourcemanager.projects.create 権限が含まれています。詳しくは、ロールを付与する方法をご覧ください。

    • プロジェクトを作成する Google Cloud :

      gcloud projects create PROJECT_ID

      PROJECT_ID は、作成する Google Cloud プロジェクトの名前に置き換えます。

    • 作成した Google Cloud プロジェクトを選択します。

      gcloud config set project PROJECT_ID

      PROJECT_ID は、 Google Cloud プロジェクトの名前に置き換えます。

  13. このガイドで既存のプロジェクトを使用する場合は、 このガイドを完了するために必要な権限があることを 確認します。新しいプロジェクトを作成した場合は、 必要な権限がすでに付与されています。

  14. プロジェクト Google Cloud に対して課金が有効になっていることを確認します。

  15. Cloud Run Admin API と Cloud Logging API を有効にします。

    API を有効にするために必要なロール

    API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を通じてこの権限が付与されている可能性があります。それ以外の場合は、サービス使用管理者ロール（roles/serviceusage.serviceUsageAdmin）を通じてこの権限を取得できます。ロールを付与する方法をご覧ください。

    gcloud services enable run.googleapis.com logging.googleapis.com
    16.
  16. Cloud Run インスタンスのデフォルト プロジェクトを設定するには: 
    gcloud config set project PROJECT_ID
     PROJECT_ID は、このクイックスタートで作成したプロジェクトの名前に置き換えます。
  17. gcloud beta コンポーネントがインストールされていることを確認します。 
    gcloud components install beta
  18. Cloud Run の料金を確認するか、 料金計算ツールで費用を見積もります。

必要なロール

このクイックスタートを完了するために必要な権限を取得するには、管理者に次の IAM ロールを付与するよう依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

インスタンスの作成

gcloud CLI を使用してサンプル コンテナに Cloud Run インスタンスを作成するには:

  1. 次のコマンドを実行します。

    gcloud beta run instances create my-instance \
--image us-docker.pkg.dev/cloudrun/container/hello \
--region REGION \
--port 8080 \
--no-invoker-iam-check

    REGION は、サポートされている Google Cloud リージョンに置き換えます。

    --no-invoker-iam-check フラグは IAM 呼び出し元認証を無効にするため、IAM 認証なしでインスタンス URL にアクセスできます。

  2. インスタンスの作成が完了するまで待機します。完了すると、コマンドは次のような出力を表示します。

    Creating instance...
Importing container..............done
Provisioning resources.......done
Starting instance.....done
Done.
Instance [my-instance] has successfully been created.

URL: https://my-instance-PROJECT-NUMBER.REGION.run.app

  3. 返された URL をブラウザで開いて、実行中のコンテナを操作します。

インスタンスのログを表示する

Cloud Run インスタンスによって生成されたログを表示するには:

  1. コンソール Google Cloud で [**ログ エクスプローラ**] に移動します。

    [ログ エクスプローラ] に移動

  2. 特定のインスタンスのログをフィルタします。

    resource.type="cloud_run_instance"
resource.labels.location="<var>REGION</var>"
resource.labels.instance_name="my-instance"

クリーンアップ

このページで使用したリソースについて、 Google Cloud アカウントに課金されないようにするには、次の操作を行います。

インスタンスを削除する

Cloud Run インスタンスを停止して削除するには:

gcloud beta run instances delete my-instance --region REGION

テスト プロジェクトを削除する

Google Cloud プロジェクトを削除すると、そのプロジェクト内のすべてのリソースに対する課金が停止します。プロジェクト内のすべての Google Cloud リソースを解放する手順は次のとおりです。

    プロジェクト Google Cloud を削除する:

    gcloud projects delete PROJECT_ID

次のステップ

Cloud Run インスタンスの詳細については、以下をご覧ください。