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

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

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

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

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

事前準備

1. 安裝 Google Cloud CLI。

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

2. 設定 gcloud CLI，使用您的聯合身分。

   詳情請參閱「使用聯合身分登入 gcloud CLI」。

3. 執行下列指令，初始化 gcloud CLI：

   gcloud init

4. 建立或選取 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 專案名稱。

5. 如要使用現有專案進行本指南中的操作，請確認您具有完成本指南所需的權限。如果您建立新專案，則已具備必要權限。

6. 確認專案已啟用計費功能 Google Cloud 。

7. 啟用 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

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

   gcloud config set project PROJECT_ID

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

   gcloud components install beta

10. 查看 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 執行個體生命週期