使用 Cloud Shell 部署 Cloud Run 應用程式
如要開始使用 Cloud Run,您可以部署 Hello World 範例應用程式,並檢查運作中的服務資源。在本快速入門導覽課程中,您將使用 Cloud Shell 設定 Cloud Run 服務並查看記錄。
事前準備
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
必要的角色
如要取得部署 Cloud Run 應用程式所需的權限,請要求管理員在專案中授予您下列 IAM 角色:
- Cloud Run 管理員 (
roles/run.admin) - Cloud Run 來源開發人員 (
roles/run.sourceDeveloper) - 服務帳戶使用者 (
roles/iam.serviceAccountUser) - 服務使用情形管理員 (
roles/serviceusage.serviceUsageAdmin) - 專案 IAM 管理員 (
roles/resourcemanager.projectIamAdmin) - 記錄檢視器 (
roles/logging.viewer)
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
授予 Cloud Build 服務帳戶專案存取權
除非您覆寫這項行為,否則 Cloud Build 會自動使用 Compute Engine 預設服務帳戶做為預設 Cloud Build 服務帳戶,建構原始碼和 Cloud Run 資源。
如要讓 Cloud Build 建構來源,請將專案的 Cloud Run 建構者 (roles/run.builder) 角色授予 Cloud Build 服務帳戶:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:SERVICE_ACCOUNT_EMAIL_ADDRESS \ --role=roles/run.builder
將 PROJECT_ID 替換為您的 Google Cloud專案 ID,並將 SERVICE_ACCOUNT_EMAIL_ADDRESS 替換為 Cloud Build 服務帳戶的電子郵件地址。如果您使用 Compute Engine 預設服務帳戶做為 Cloud Build 服務帳戶,請按照下列格式輸入服務帳戶電子郵件地址:
PROJECT_NUMBER-compute@
將 PROJECT_NUMBER 替換為您的 Google Cloud專案編號。
如要瞭解如何找出專案 ID 和專案編號,請參閱「建立及管理專案」。
授予 Cloud Run 建構工具角色後,需要幾分鐘才會生效。
建立應用程式
- 啟動 Cloud Shell 編輯器。
- 在 Cloud Code 狀態列中,選取「New Application」(新增應用程式)。
- 選擇「Cloud Run application」做為偏好的應用程式類型。
從範例應用程式清單 (Node.js、Python 搭配 Flask 和 Django 架構、Java、Go) 中,選擇 Hello World 應用程式。
例如,選擇
Python (Flask): Hello World會建立 Python (Flask) Hello World 範例應用程式。選取要用來存放應用程式的資料夾,然後按一下「Create New Application」(建立新的應用程式)。
Cloud Shell 編輯器會在新的工作區中載入應用程式。工作區載入後,您就能在 Explorer 檢視畫面中存取應用程式。
部署至 Cloud Run
如要將應用程式部署至 Cloud Run,請按照下列步驟操作:
- 開啟指令面板 (按下
Ctrl/Cmd+Shift+P鍵,或依序點選「View」(瀏覽) >「Command Palette」(指令面板)),然後執行「Deploy to Cloud Run」指令。Cloud Run 部署 UI 隨即顯示。 - 如果出現系統提示,請授權 Cloud Code 發出 Google Cloud API 呼叫。
- 設定 Google Cloud 專案。
- 如果出現提示,請按一下「啟用 API」,啟用 Cloud Run API。
- 在「Deploy to Cloud Run」(部署至 Cloud Run) 對話方塊中,選取現有服務或建立新服務。
- 如要建立新服務,請在「Deployment Platform」(部署平台) 下方選擇「Cloud Run (fully managed)」(Cloud Run (全代管))。
- 選擇要部署的區域。
- 在「驗證」部分,選取「允許未經驗證的叫用」,公開發布服務。
定義偏好設定後,按一下「部署」。
Cloud Code 會建立映像檔並推送至儲存庫,然後將應用程式部署到 Cloud Run。服務現已上線!
如要查看執行中的服務,請開啟「Cloud Run: Deploy」(Cloud Run:部署) 對話方塊中顯示的網址。
編輯服務
如要編輯申請資料,請按照下列步驟操作:
- 在 Explorer 檢視畫面中,找出實作服務行為的
app.py檔案。 - 將「It's running!」訊息變更為您選擇的訊息。
- 完成這項變更後,請使用指令區塊面板選擇「Deploy to Cloud Run」(部署至 Cloud Run) 指令。
- 確認「服務設定」中已選取您剛建立的服務。
- 點選「Deploy」(部署)。
- 應用程式建構及部署完成後,您可以重新整理服務,查看更新後的訊息。
查看記錄
您也可以使用 Cloud Code 隨附的記錄檢視器,查看已部署應用程式的記錄。
如要查看記錄,請按照下列步驟操作:
- 按一下
「Cloud Code」,然後展開「Cloud Run」部分。 在 Cloud Run 服務上按一下滑鼠右鍵,然後點選「View logs」(查看記錄)。
在瀏覽器中重新整理應用程式,然後點選「Logs refresh」(重新整理記錄) 按鈕,查看新產生的記錄。
清除所用資源
為了避免系統向您的 Google Cloud 帳戶收取本頁面所用資源的費用,請按照下列步驟操作。
如要刪除專案,請按照下列步驟操作:
前往 Google Cloud 控制台的「Projects」(專案) 頁面:
選取您為本快速入門導覽課程建立的專案,然後按一下「Delete」(刪除)。
接著,系統就會關閉專案並排定刪除時間。
如果您使用現有專案,並想刪除為本快速入門導覽課程建立的資源:
容器映像檔:不使用服務時,Cloud Run 不會收費,但您可能仍須支付將容器映像檔儲存在 Artifact Registry 的費用。如要刪除映像檔,請開啟 Artifact Registry 頁面,選取包含映像檔的存放區,然後選取映像檔,再依序點選「Delete」(刪除) 和「Delete」(刪除)。
Cloud Run 服務:如要刪除 Cloud Run 服務,請在Google Cloud 控制台的「Cloud Run」頁面中,選取要刪除的服務,然後依序點選「Delete」(刪除) 和「Delete」(刪除)。
後續步驟
- 探索 Cloud Shell 編輯器介面提供的各種功能。
- 瞭解如何設定 Cloud Shell,打造個人化體驗。