快速入門導覽課程：建立 Cloud Run 執行個體

本頁面說明如何使用 Cloud Run 在範例容器中建立 Cloud Run 執行個體、查看記錄，以及使用 gcloud CLI 管理生命週期。

事前準備

安裝 Google Cloud CLI。

注意：如果您先前已安裝 gcloud CLI，請執行 gcloud components update，確認您使用的是最新版本。
設定 gcloud CLI，使用您的聯合身分。

詳情請參閱「使用聯合身分登入 gcloud CLI」。
執行下列指令，初始化 gcloud CLI：
```
gcloud init
```
建立或選取 Cloud de Confiance 專案。
選取或建立專案所需的角色
- 選取專案：選取專案時，不需具備特定 IAM 角色，只要您在專案中獲派角色，即可選取該專案。
- 建立專案：如要建立專案，您需要專案建立者角色 (roles/resourcemanager.projectCreator)，其中包含 resourcemanager.projects.create 權限。瞭解如何授予角色。
注意：如果您不打算保留在這項程序中建立的資源，請建立新專案，不要選取現有專案。如果採用這種做法，當您完成這些步驟後，就可以直接刪除該專案，並移除相關聯的所有資源。
- 建立 Cloud de Confiance 專案：
```
gcloud projects create PROJECT_ID
```
  將 PROJECT_ID 替換為您要建立的 Cloud de Confiance 專案名稱。
- 選取您建立的 Cloud de Confiance 專案：
```
gcloud config set project PROJECT_ID
```
  將 PROJECT_ID 替換為 Cloud de Confiance 專案名稱。
如要使用現有專案進行本指南中的操作，請確認您具有完成本指南所需的權限。如果您建立新專案，則已具備必要權限。
確認 Cloud de Confiance 專案已啟用計費功能。
如尚未啟用，請啟用 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 定價，或使用 Pricing Calculator 估算費用。

必要的角色

如要取得完成本快速入門導覽課程所需的權限，請要求管理員授予您下列 IAM 角色：

執行個體上的 Cloud Run 管理員 (roles/run.admin)
服務身分上的服務帳戶使用者 (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 替換為支援的 Cloud de Confiance 區域。

--no-invoker-iam-check 旗標會停用 IAM 叫用者驗證，因此不必經過 IAM 驗證，即可存取執行個體網址。

等待執行個體建立完成。完成後，指令會顯示類似以下的輸出內容：

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

在瀏覽器中開啟傳回的網址，與執行中的容器互動。

查看執行個體記錄檔

如要查看 Cloud Run 執行個體產生的記錄，請按照下列步驟操作：

前往 Cloud de Confiance 控制台的「Logs Explorer」：

前往 Logs Explorer

篩選特定執行個體的記錄：

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

清除所用資源

如要避免系統向您的 Cloud de Confiance by S3NS 帳戶收取本頁所用資源的費用，請按照下列步驟操作。

刪除執行個體

如要停止並刪除 Cloud Run 執行個體，請按照下列步驟操作：

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

刪除測試專案

刪除 Cloud de Confiance 專案後，系統會停止收取該專案中所有資源的費用。如要釋出專案中的所有 Cloud de Confiance by S3NS 資源，請按照下列步驟操作：

刪除 Cloud de Confiance 專案：

gcloud projects delete PROJECT_ID

後續步驟

如要進一步瞭解 Cloud Run 執行個體，請參閱：