快速入門導覽課程：從 Git 存放區部署至 Cloud Run

快速入門導覽課程：從 Git 存放區部署至 Cloud Run

本頁面說明如何使用 Cloud Build，持續從 Git 存放區部署至 Cloud Run。

您可以使用 Cloud Build 或 Developer Connect，從存放區持續部署。

事前準備

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

3. Verify that billing is enabled for your Google Cloud project.

4. 啟用 Cloud Build API (如果尚未啟用)。

   啟用 API 所需的角色

   您必須具備 serviceusage.services.enable 權限，才能啟用 API。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「Service Usage 管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

   啟用 API

5. 如果專案受限於限制未經驗證叫用的網域限制組織政策，您必須按照「測試私人服務」一節所述的方式存取已部署的服務。

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

必要的角色

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

• 服務的 Cloud Run 原始碼開發人員 (roles/run.sourceDeveloper)
• 專案的 Cloud Run 管理員 (roles/run.admin)
• 服務身分的服務帳戶使用者 (roles/iam.serviceAccountUser)
• 專案的記錄檢視器 (roles/logging.viewer)

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

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

使用範本建立存放區

如要建立存放區，請按照下列步驟操作：

1. 前往範本存放區：

   Node.js

   前往 github.com/GoogleCloudPlatform/cloud-run-microservice-template-nodejs

   Python

   前往 github.com/GoogleCloudPlatform/cloud-run-microservice-template-python

   Go

   前往 github.com/GoogleCloudPlatform/cloud-run-microservice-template-go

   Java

   前往 github.com/GoogleCloudPlatform/cloud-run-microservice-template-java

2. 按一下「使用這個範本」。

3. 選取「建立新的存放區」。

4. 在表單中，輸入存放區名稱。

5. 點選「Create Repository」(建立存放區)。

從存放區部署

如要從存放區部署：

1. 前往 Google Cloud 控制台的「Cloud Run」頁面：

   前往 Cloud Run。

2. 從選單中選取「服務」，然後點選「連結存放區」。

3. 在表單中選取「Cloud Build」，然後按一下「Set up with Cloud Build」。

4. 在右側面板中：

   1. 在「Repository」下方，選取新建立的存放區。如果您尚未驗證，系統可能會要求您驗證。請使用「Repository Provider」(存放區供應商) 欄位下方的「authenticate」(驗證) 連結。

   2. 勾選 GitHub 和 Google Cloud 互動性的確認協議。

   3. 點選「下一步」。

   4. 在 「Build Type」(建構類型) 下方，選取 「Google Cloud Buildpacks」。

   5. 按一下 [儲存]。

5. 在「Create service」(建立服務) 表單中：

   1. 確認服務名稱。系統會自動填入存放區名稱。

   2. 在「Region」(區域) 下拉式選單中，選取服務所在的區域。

   3. 在「驗證」下方，選取「允許公開存取」。如果您沒有選取這項設定的權限 (Cloud Run 管理員角色)，服務會部署並要求驗證。

   4. 按一下「Create」(建立)，將範例存放區部署至 Cloud Run，然後等待部署作業完成。

6. 按一下顯示的網址連結來執行部署好的容器。

Cloud Run 位置

Cloud Run 具有區域性，這表示執行 Cloud Run 服務的基礎架構位於特定區域，並由 Google 負責管理，實現該區域內所有可用區之間的備援可用性。

選擇執行 Cloud Run 服務的區域時，主要考量重點在於延遲時間、可用性或耐用性需求。原則上可以選擇距離使用者最近的區域，但也應考慮 Cloud Run 服務所用其他 Google Cloud產品的位置。如果跨多個位置使用 Google Cloud 產品，可能會影響服務的延遲時間和費用。

Cloud Run 可在下列地區使用：

採用級別 1 定價

• asia-east1 (臺灣)
• asia-northeast1 (東京)
• asia-northeast2 (大阪)
• asia-south1 (印度孟買)
• asia-southeast3 (曼谷)
• europe-north1 (芬蘭) 低二氧化碳排放
• europe-north2 (斯德哥爾摩) 低二氧化碳排放
• europe-southwest1 (馬德里) 低二氧化碳排放
• europe-west1 (比利時) 低二氧化碳
• europe-west4 (荷蘭) 低二氧化碳排放
• europe-west8 (米蘭) 低二氧化碳排放
• europe-west9 (巴黎) 低二氧化碳排放
• me-west1 (特拉維夫)
• northamerica-south1 (墨西哥)
• us-central1 (愛荷華州) 低二氧化碳排放
• us-east1 (南卡羅來納州)
• us-east4 (北維吉尼亞州)
• us-east5 (哥倫布)
• us-south1 (達拉斯) 低二氧化碳排放
• us-west1 (奧勒岡州) 低二氧化碳排放

採用級別 2 定價

• africa-south1 (約翰尼斯堡)
• asia-east2 (香港)
• asia-northeast3 (韓國首爾)
• asia-southeast1 (新加坡)
• asia-southeast2 (雅加達)
• asia-south2 (印度德里)
• australia-southeast1 (雪梨)
• australia-southeast2 (墨爾本)
• europe-central2 (波蘭華沙) 低二氧化碳
• europe-west10 (柏林)
• europe-west12 (杜林) 低二氧化碳排放
• europe-west2 (英國倫敦) 低二氧化碳排放
• europe-west3 (德國法蘭克福)
• europe-west6 (瑞士蘇黎世) 低二氧化碳
• me-central1 (杜哈)
• me-central2 (達曼)
• northamerica-northeast1 (蒙特婁) 低二氧化碳排放
• northamerica-northeast2 (多倫多) 低二氧化碳排放
• southamerica-east1 (巴西聖保羅) 低二氧化碳排放
• southamerica-west1 (智利聖地牙哥) 低二氧化碳排放
• us-west2 (洛杉磯)
• us-west3 (鹽湖城)
• us-west4 (拉斯維加斯)

如果您已建立 Cloud Run 服務，可以在Google Cloud 控制台的 Cloud Run 資訊主頁中查看區域。

確定

更新服務

如要變更服務，請按照下列步驟操作：

1. 將修訂版本推送至存放區的 main 分支版本。

2. 重新整理 Cloud Run 服務，查看更新狀態。

成功： 您已將 Git 存放區中的容器映像檔部署至 Cloud Run。

Cloud Run 會根據需求自動調度容器執行個體資源，您只需支付處理要求期間使用的 CPU、記憶體和網路費用。

清除所用資源

為避免系統向您的 Google Cloud 帳戶收取額外費用，請刪除您透過本快速入門導覽課程部署的所有資源。

刪除存放區

Cloud Run 不會對未使用的已部署服務收費。不過，您可能仍須支付在 Artifact Registry 儲存容器映像檔的費用。如要刪除 Artifact Registry 存放區，請按照 Artifact Registry 說明文件中的「刪除存放區」步驟操作。

刪除服務

Cloud Run 服務在收到要求前不會產生費用。如要刪除 Cloud Run 服務，請按照下列任一步驟操作：

控制台

如要刪除服務：

1. 前往 Google Cloud 控制台的 Cloud Run「Services」(服務) 頁面：

   前往 Cloud Run。

2. 在服務清單中找出您要刪除的服務，然後按一下核取方塊來選取。

3. 按一下「Delete」(刪除)。這項操作會刪除服務的所有修訂版本。

gcloud

如要刪除服務，請執行下列指令：

gcloud run services delete SERVICE --region REGION

更改下列內容：

• SERVICE：服務名稱。
• REGION：服務的 Google Cloud 區域。

刪除測試專案

刪除 Google Cloud 專案後，系統會停止對該專案中的所有資源計費。如要釋出專案中的所有 Google Cloud 資源，請按照下列步驟操作：

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

   前往「Manage resources」(管理資源)

2. 在專案清單中選取要刪除的專案，然後點選「Delete」(刪除)。
3. 在對話方塊中輸入專案 ID，然後按一下 [Shut down] (關閉) 以刪除專案。

後續步驟

• 快速入門導覽課程：建構及部署
• 使用 Cloud Build 持續部署
• 使用 Buildpacks 建構容器