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

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

預先發布版 — Cloud Run 執行個體

這項功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前功能是依「原樣」提供，支援服務可能受限。 詳情請參閱推出階段說明。

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

事前準備

登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎 建立帳戶，親自評估產品在實際工作環境中的成效。新客戶還能獲得價值 $300 美元的免費抵免額，可用於執行、測試及部署工作負載。

安裝 Google Cloud CLI。

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

若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 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

安裝 Google Cloud CLI。

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

若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 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

1. 如要為 Cloud Run 執行個體設定預設專案：

   gcloud config set project PROJECT_ID

   將 PROJECT_ID 替換為您為本快速入門導覽課程建立的專案名稱。
2. 確認已安裝 gcloud beta 元件：

   gcloud components install beta

3. 查看 Cloud Run 定價，或使用 Pricing Calculator 估算費用。

必要的角色

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

• 執行個體上的 Cloud Run 管理員 (roles/run.admin)
• 服務身分上的服務帳戶使用者 (roles/iam.serviceAccountUser)
• 專案的記錄檢視器 (roles/logging.viewer)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

建立執行個體

如要使用 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 驗證即可存取執行個體網址。

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. 在瀏覽器中開啟傳回的網址，與正在執行的容器互動。

查看執行個體記錄檔

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

1. 前往 Google Cloud 控制台的「Logs Explorer」：

   前往 Logs Explorer

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 資源，請按照下列步驟操作：

注意：刪除專案會造成以下結果：
• 專案中的所有內容都會遭到刪除。如果使用現有專案來進行本文中的任務，刪除專案將一併移除當中已完成的其他任務'。
• 自訂專案 ID 會消失。當您之前建立這個專案時，可能建立了想要在日後使用的自訂專案 ID。如要保留使用該專案 ID 的網址 (例如 appspot.com 網址)，請刪除在該專案中選取的資源，而不是刪除整個專案。

刪除 Google Cloud 專案：

gcloud projects delete PROJECT_ID

後續步驟

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

• 建立及管理 Cloud Run 執行個體
• Cloud Run 執行個體生命週期