本頁面說明開始開發 Cloud Run 服務的幾項須知。
程式碼需求
在開發服務時,您必須符合下列需求條件:
- 服務必須監聽要求。
您可以設定傳送要求的通訊埠。在 Cloud Run 執行個體中,
PORT
環境變數的值一律會反映要求傳送的連接埠。程式碼應檢查是否有這個PORT
環境變數,如果有的話,應監聽該變數,盡可能提高可攜性。 - 服務必須是「無狀態」,不能依賴永久本機狀態。
- 如果服務在處理要求以外執行背景活動,就必須使用以執行個體為準的計費設定,才能在標準要求週期以外分配 CPU。
- 如果服務使用 NFS,就必須使用第二代執行環境。
您可以在容器執行階段合約中找到有關這些限制的詳細資料。
程式設計語言支援
Cloud Run 原始碼部署功能可支援多種語言執行階段,每種執行階段都可透過 Google Cloud 的 Buildpacks 提供的容器基礎映像檔使用。您也可以使用其他程式設計語言或架構,只要原始碼位於符合 OCI 規範的映像檔中即可。
《建構及部署》快速入門導覽課程提供使用多種主流語言的範例。
使用網路伺服器
您可以使用網路伺服器監聽所需的通訊埠,接著處理並轉送傳入的要求。例如,Node.js 開發人員可使用 Express.js,Python 開發人員則可使用 Flask,而 Ruby 開發人員可使用 Sinatra,以此類推。
將程式碼容器化
詳情請參閱「將程式碼容器化」一文。
使用 Gemini 輔助功能設計 Cloud Run 應用程式
您可以透過 Gemini Cloud Assist 聊天室取得 AI 輔助,設計出最佳應用程式。透過 Gemini Cloud Assist,您可以找出最適合的設定和策略,在 Cloud Run 上部署應用程式,確保資源使用效率,並順暢運作。
如要透過 Google Cloud 控制台使用 Gemini Cloud Assist,請按照下列步驟操作:
確認您已為 Google Cloud 使用者帳戶和專案設定 Gemini Cloud Assist。
在 Google Cloud 專案中設定 Cloud Run 開發環境,並確認您具備適當的部署權限。
前往 Google Cloud 控制台的 Cloud Run 頁面。
在控制台工具列中選取 Google Cloud 專案。使用與您在獲准存取 Gemini Cloud Assist 後提交的專案 ID 相關聯的專案。
按一下「spark」 開啟或關閉 Gemini AI 對話。
Gemini 面板隨即開啟。
視需要點按「接受」,同意條款。
如果您對特定應用程式有疑問,請先前往顯示資源的頁面,再提出問題,以提供相關背景資訊。生成回覆時,Gemini 會納入目前控制台頁面和專案的相關資訊。
在「Gemini」Gemini面板中輸入提示。
下表提供一些範例提示,說明如何搭配使用 Gemini Cloud Assist 和 Cloud Run。
提示 回覆類型 「我想在 Cloud Run 上設計 Node.js 應用程式。建議的做法是什麼?需要注意哪些事項? 簡要說明如何將應用程式容器化、建構 Node.js 應用程式,以及部署程序。 「我需要哪些權限才能部署 Cloud Run 應用程式?」 必要權限和角色清單。 「我想使用 Cloud Run 部署三層式網頁應用程式」 設計三層式網頁應用程式的步驟概要。 「如何將 App Engine 應用程式遷移至 Cloud Run」 簡要說明準備 Cloud Run 開發環境的主要步驟,以及這兩項產品之間的一些主要差異。連結至範例教學課程,可用於自訂解決方案,以滿足特定需求。 「What is the gcloud CLI command for updating the min instance setting to 2 for my Cloud Run service 'example-service'」(將 Cloud Run 服務「example-service」的最低執行個體設定更新為 2 的 gcloud CLI 指令為何?) 更新最少執行個體設定的建議 gcloud CLI 指令。 「如何更新 Cloud Run 服務 hello-world
的服務帳戶」更新服務帳戶的建議 gcloud CLI 指令。 「Show me an example of building a generative AI app on Cloud Run with LangChain」(請提供在 Cloud Run 上使用 LangChain 建構生成式 AI 應用程式的範例) 使用 Cloud Run 和 LangChain 建立範例應用程式的步驟。 "Generate a Terraform config using the google_cloud_run_v2_service
resource for a Cloud Run service that sets the billing setting to instance-based billing"更新帳單設定的建議 Terraform 設定。
詳情請參閱下列資源:
- 瞭解如何撰寫更優質的提示。
- 瞭解如何使用 Gemini Cloud Assist 面板。
- 請參閱「使用 Gemini 進行 AI 輔助及開發」一文。
- 瞭解 Gemini for Google Cloud 如何使用您的資料。
後續步驟
- 準備好服務程式碼和 Dockerfile 時,您應建構容器映像檔,再繼續反覆執行本機測試。
- 如果您要遷移現有的網頁應用程式,請參閱將您的服務遷移到 Cloud Run。
- 如需設計、實作、測試及部署 Cloud Run 服務的最佳做法,請參閱「開發提示」。