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 ロールは必要ありません。ロールが付与されているプロジェクトを選択できます。
- プロジェクトを作成する: プロジェクトを作成するには、resourcemanager.projects.create 権限を含むプロジェクト作成者のロール（roles/resourcemanager.projectCreator）が必要です。詳しくは、ロールを付与する方法をご覧ください。
注: この手順で作成するリソースをそのまま保持する予定でない場合、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの終了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。
- 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）を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（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）を保持するには、プロジェクト全体ではなく、プロジェクト内の選択したリソースだけを削除します。

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

gcloud projects delete PROJECT_ID

次のステップ

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