Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

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

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

始める前に

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

注: すでに gcloud CLI をインストールしている場合は、最新バージョンがインストールされていることを確認してください。gcloud components update
フェデレーション ID（連携 ID）を使用するように gcloud CLI を構成します。

詳細については、連携 ID を使用して gcloud CLI にログインするをご覧ください。
gcloud CLI を初期化するには、次のコマンドを実行します:
```
gcloud init
```
プロジェクトを 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 プロジェクトの名前に置き換えます。
このガイドで既存のプロジェクトを使用する場合は、このガイドを完了するために必要な権限があることを確認します。新しいプロジェクトを作成した場合は、必要な権限がすでに付与されています。
プロジェクト Google Cloud に対して課金が有効になっていることを確認します。
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
```

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

必要なロール

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

インスタンスに対する Cloud Run 管理者（roles/run.admin）
サービス ID に対するサービスアカウントユーザー（roles/iam.serviceAccountUser）ロール
ログビューア（roles/logging.viewer）プロジェクトに対する

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

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

インスタンスの作成

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

次のコマンドを実行します。
```
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 にアクセスできます。

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

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

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

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

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

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

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

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

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 リソースを解放する手順は次のとおりです。

注意 : プロジェクトを削除すると、次のような影響があります。

プロジェクト内のすべてのものが削除されます。既存のプロジェクトを使用してこのドキュメントのタスクを行った場合、そのプロジェクトを削除すると、プロジェクト内で行った他の作業もすべて削除されます。
カスタムプロジェクト ID が失われます。このプロジェクトを作成したときに、将来使用するカスタムプロジェクト ID を作成した可能性があります。そのプロジェクト ID を使用した URL（例: appspot.com URL）を保持するには、プロジェクト全体ではなく、プロジェクト内の選択したリソースだけを削除します。

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

gcloud projects delete PROJECT_ID

次のステップ

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