使用 Cloud Shell 適用的 Cloud Code 建立 Cloud Run 函式

瞭解如何在 Cloud Shell 編輯器中使用 Cloud Code，建立、部署、叫用及下載 HTTP Cloud Run 函式。

Cloud Code 這項擴充功能可將許多 Google Cloud服務 (例如 Google Kubernetes Engine 和 Cloud Run) 直接整合至您的 IDE，因此不需要切換內容，即可開發應用程式。 您預設可以透過 Cloud Shell 編輯器使用 Cloud Code。

您可以在 VS Code (也支援建立及部署函式) 中安裝 Cloud Code 擴充功能，也能在 IntelliJ 和其他支援的 JetBrains IDE (不支援 Cloud Run 函式) 中安裝。

如要直接在 Cloud Shell 編輯器中按照逐步指南操作，請按一下「Guide me」(逐步引導)：

逐步引導

事前準備

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

    Go to project selector

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

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

    Go to project selector

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

    6. 連線至 Google Cloud

    在本節中，您將啟動 Cloud Shell 編輯器、連線至Google Cloud，並選取 Google Cloud 專案。

    如要連線至 Google Cloud，請按照下列步驟操作：

    1. 啟動 Cloud Shell 編輯器。

    2. 如果系統提示您授權 Cloud Code 使用憑證發出 Google Cloud API 呼叫，請按一下「Authorize」(授權)，並同意條款。

    3. 如果尚未連線至 Google Cloud，請在 Cloud Code 狀態列中，按一下「Connect to Google Cloud」(連線至 Google Cloud)。

      狀態列中的「連線至 Google Cloud 」按鈕

    4. 如果系統提示您授權 Cloud Code 使用憑證發出 Google Cloud API 呼叫，請按一下「Authorize」(授權)，表示您同意這些條款。

    5. 如果尚未選取專案，請在 Cloud Code 狀態列中按一下「Select a Google Cloud Project」。 Google Cloud

      如果您已選取 Google Cloud 專案，Cloud Code 狀態列會顯示專案名稱，您可以繼續建立函式。

    6. 在隨即顯示的「選取 Google Cloud 專案」快速選單中，選取您的 Google Cloud 專案。

      專案會載入，並成為 Cloud Shell 編輯器中的現有專案。如要隨時切換專案，請點選 Cloud Code 狀態列中的現用專案名稱，然後選取其他專案。

    建立函式

    將 Cloud Shell 編輯器做為建立及部署函式的環境使用。這個編輯器已預先載入雲端開發作業所需的工具。

    如要使用範例建立新函式，請按照下列步驟操作：

    1. 在 Cloud Code 狀態列中，按一下「Cloud Code」。

      Cloud Code 狀態列按鈕

    2. 在隨即顯示的「快速挑選」選單中，選取「New Application」(新增應用程式)。

    3. 選取「Cloud Functions application」(Cloud Functions 應用程式) 做為範例應用程式類型。

    4. 從 Cloud Run 函式應用程式範例清單中，選取「Node.js: Hello World」。

    5. 選取要用來存放應用程式的資料夾，然後按一下「Create New Application」(建立新的應用程式)。

      Cloud Shell 編輯器會在新的工作區中載入應用程式。重新載入後，您就能透過「Explorer」檢視畫面存取應用程式。

      launch.json 檔案 (位於 .vscode 資料夾) 包含函式所需的設定：

      {
"configurations": [
    {
    "name": "Deploy Cloud Function",
    "type": "cloudcode.cloudfunctions",
    "request": "launch",
    "functionName": "function-hello-world",
    "gen": "GEN_2",
    "entryPoint": "helloHttp",
    }
]
}

    部署函式

    建立函式後，現在已可在 Cloud Shell 中部署函式，請按照以下步驟操作：

    1. 按一下「Cloud Code」，然後展開「Cloud Functions」探索工具。

    2. 依序點選函式和 「Deploy function」(部署函式)。

    3. 在快捷選單，選取要部署函式的 Google Cloud 專案。

    4. 選取要部署函式的區域。

    5. 選取「Node.js 20」。

      函式部署作業可能需要幾分鐘的時間才能完成。如果仍在進行中，畫面上就會顯示 進度圖示。作業完成後，如果成功的話，會顯示 成功圖示，如果失敗，會顯示 錯誤圖示，如果部署失敗並還原為先前執行成功的部署項目，則會顯示 警告圖示。

      如果部署失敗，請查看「Output」(輸出內容) (依序點選「View」(檢視) >「Output」(輸出內容)) 檢視畫面中的錯誤訊息。如果點選連結，系統就會將您導向Google Cloud 控制台中的建構作業記錄檔，並提供該錯誤的相關詳細資訊。

    6. (選用) 部署函式後，您可以執行下列動作：

      • 如要查看已部署函式的唯讀檔案，請展開函式，然後展開「Source Code」資料夾。您可在此查看 launch.json (在 .vscode 底下)、已部署的程式碼和 package.json。

      • 如要在 Google Cloud 控制台中查看函式，請對該函式按一下滑鼠右鍵，並選取「Open in Cloud Console」(在 Cloud 控制台開啟)。出現提示時，請選取「Open」(開啟)。

      • 如要編輯函式的中繼資料，請在函式上按一下滑鼠右鍵，然後選取「Edit metadata in Cloud Console」(在 Cloud 控制台中編輯中繼資料)。

      • 如要查看已部署函式的記錄檔，請在函式上按一下滑鼠右鍵，然後選取「View logs」(查看記錄檔)。

    叫用函式

    叫用函式可讓您在Google Cloud 控制台中，透過 Cloud Shell 編輯器的終端機執行部署的函式。如要叫用函式，請按照下列步驟操作：

    1. 在函式上按一下滑鼠右鍵，選取「Invoke function via HTTP」(透過 HTTP 叫用函式)。

    2. 在顯示的「Trigger function via HTTP」(透過 HTTP 觸發函式) 快捷選單，選取「Invoke with no arguments」(不使用引數叫用)。

      接著，終端機會在 IDE 開啟並執行指令，在Google Cloud執行函式。

    選用步驟：將現有函式下載至新的工作區

    如要將現有函式下載至新的工作區，請按照下列步驟操作：

    1. 按一下 「Cloud Code」，然後展開「Cloud Functions」探索工具。

    2. 展開 Google Cloud 專案程式碼片段，對要下載的函式按一下滑鼠右鍵，然後選取「Download to new workspace」(下載至新的工作區)。

    3. 出現提示時，請輸入新應用程式的名稱，然後點選「Create New Application」(建立新應用程式)。

      如此一來，系統便會將函式下載到本機電腦，並在 Cloud Shell 編輯器的新工作區中開啟該函式。

    清除所用資源

    如要只刪除您為本快速入門導覽課程建立的函式：

    1. 在「Cloud Functions」檔案總管中，對函式名稱按一下滑鼠右鍵，然後選取「Open in Cloud Console」(在 Cloud 控制台中開啟)。

    2. 按一下「Delete」(刪除)，然後點選「Delete」(刪除)。

    如要刪除專案 (和相關聯的資源)，請按照下列步驟操作：

    1. 前往 Google Cloud 控制台的「Projects」(專案) 頁面：

      前往「Projects」(專案) 頁面

    2. 選取您在本快速入門導覽課程所建立的專案，然後按一下「Delete」(刪除)。

    3. 輸入專案 ID 確認，然後點選「Shut down」(關閉)。

      接著，系統就會關閉專案並排定刪除時間。

    後續步驟