arrow_back

Cloud Functions：Qwik Start - 指令列

登录 加入
欢迎加入我们的社区，一起测试和分享您的知识！
done
学习 700 多个动手实验和课程并获得相关技能徽章

Cloud Functions：Qwik Start - 指令列

实验 30 分钟 universal_currency_alt 1 积分 show_chart 入门级
info 此实验可能会提供 AI 工具来支持您学习。
欢迎加入我们的社区，一起测试和分享您的知识！
done
学习 700 多个动手实验和课程并获得相关技能徽章

GSP080

Google Cloud 自修研究室標誌

總覽

「Cloud 函式」是因應事件執行的程式碼，事件包括 HTTP 要求、訊息傳遞服務發送的訊息，或是檔案上傳作業等。「Cloud 事件」是雲端環境中發生的「事項」，可能是資料庫內的資料出現異動、儲存系統中新增了檔案，或是建立新的虛擬機器執行個體。

Cloud 函式是以事件為準，只有發生事件時才會執行，因此適合用於必須迅速完成或不必隨時保持運作的任務。

舉例來說，Cloud 函式可以用於：

  • 為上傳至 Cloud Storage 的圖片自動產生縮圖。
  • 在 Cloud Pub/Sub 收到新訊息時，傳送通知至使用者的手機。
  • 處理 Cloud Firestore 資料庫提供的資料，並產生報告。

您在編寫程式碼時，可以使用任何支援 Node.js 的語言。只要按幾下滑鼠，即可將程式碼部署至雲端。Cloud 函式部署完畢之後，就會因應事件自動開始執行。

透過這個實作研究室，您可以瞭解如何使用 Google Cloud 控制台來建立、部署及測試 Cloud 函式。

透過這個實作研究室，您可以瞭解如何使用 Google Cloud Shell 指令列來建立、部署及測試 Cloud 函式。

學習內容

  • 建立 Cloud 函式
  • 部署及測試 Cloud 函式
  • 查看記錄檔

設定

點選「Start Lab」按鈕前的須知事項

請詳閱以下操作說明。研究室活動會計時，而且中途無法暫停。點選「Start Lab」 後就會開始計時，讓您瞭解有多少時間可以使用 Google Cloud 資源。

您將在真正的雲端環境中完成實作研究室活動，而不是在模擬或示範環境。為達此目的，我們會提供新的暫時憑證，讓您用來在研究室活動期間登入及存取 Google Cloud。

如要完成這個研究室活動，請先確認：

  • 您可以使用標準的網際網路瀏覽器 (Chrome 瀏覽器為佳)。
注意：請使用無痕模式或私密瀏覽視窗執行此研究室。這可以防止個人帳戶和學生帳戶之間的衝突，避免個人帳戶產生額外費用。
  • 是時候完成研究室活動了！別忘了，活動一開始將無法暫停。
注意：如果您擁有個人 Google Cloud 帳戶或專案，請勿用於本研究室，以免產生額外費用。

如何開始研究室及登入 Google Cloud 控制台

  1. 按一下「Start Lab」(開始研究室) 按鈕。如果研究室會產生費用，畫面中會出現選擇付款方式的彈出式視窗。左側的「Lab Details」窗格會顯示下列項目：

    • 「Open Google Cloud console」按鈕
    • 剩餘時間
    • 必須在這個研究室中使用的暫時憑證
    • 完成這個實驗室所需的其他資訊 (如有)

  2. 點選「Open Google Cloud console」；如果使用 Chrome 瀏覽器，也能按一下滑鼠右鍵，然後選取「在無痕式視窗中開啟連結」。

    接著，實驗室會啟動相關資源並開啟另一個分頁，當中顯示「登入」頁面。

    提示：您可以在不同的視窗中並排開啟分頁。

    注意：如果頁面中顯示「選擇帳戶」對話方塊，請點選「使用其他帳戶」。

  3. 如有必要，請將下方的 Username 貼到「登入」對話方塊。

    {{{user_0.username | "Username"}}}

    您也可以在「Lab Details」窗格找到 Username。

  4. 點選「下一步」。

  5. 複製下方的 Password，並貼到「歡迎使用」對話方塊。

    {{{user_0.password | "Password"}}}

    您也可以在「Lab Details」窗格找到 Password。

  6. 點選「下一步」。

    重要事項：請務必使用實驗室提供的憑證，而非自己的 Google Cloud 帳戶憑證。 注意：如果使用自己的 Google Cloud 帳戶來進行這個實驗室，可能會產生額外費用。

  7. 按過後續的所有頁面：

    • 接受條款及細則。
    • 由於這是臨時帳戶，請勿新增救援選項或雙重驗證機制。
    • 請勿申請免費試用。

Google Cloud 控制台稍後會在這個分頁開啟。

注意：如要查看列出 Google Cloud 產品和服務的選單，請點選左上角的「導覽選單」。「導覽選單」圖示

啟動 Cloud Shell

Cloud Shell 是搭載多項開發工具的虛擬機器，提供永久的 5 GB 主目錄，而且在 Google Cloud 中運作。Cloud Shell 提供指令列存取權，方便您使用 Google Cloud 資源。

  1. 點按 Google Cloud 控制台上方的「啟用 Cloud Shell」圖示 「啟動 Cloud Shell」圖示。

連線完成即代表已通過驗證，且專案已設為您的 PROJECT_ID。輸出內容中有一行宣告本工作階段 PROJECT_ID 的文字：

您在本工作階段中的 Cloud Platform 專案會設為「YOUR_PROJECT_ID」

gcloud 是 Google Cloud 的指令列工具，已預先安裝於 Cloud Shell，並支援 Tab 鍵自動完成功能。

  1. (選用) 您可以執行下列指令來列出使用中的帳戶：
gcloud auth list

  1. 點按「授權」。

  2. 輸出畫面應如下所示：

輸出內容：

ACTIVE: * ACCOUNT: student-01-xxxxxxxxxxxx@qwiklabs.net To set the active account, run: $ gcloud config set account `ACCOUNT`
  1. (選用) 您可以使用下列指令來列出專案 ID：
gcloud config list project

輸出內容：

[core] project = <project_ID>

輸出內容範例：

[core] project = qwiklabs-gcp-44776a13dea667a6 附註：如需有關 gcloud 的完整說明，請前往 Google Cloud 並參閱「gcloud CLI overview guide」(gcloud CLI 總覽指南)。

工作 1：建立函式

首先，您會建立名為 helloWorld 的簡單函式，以便將訊息寫入 Cloud Functions 記錄檔。這個函式由 Cloud 函式事件觸發，並會接受用於表示「函式已執行完畢」的回呼函式。

這個研究室中的 Cloud 函式事件屬於 Cloud Pub/Sub 主題事件。Pub/Sub 是一項訊息傳遞服務，而且傳送者與接收者彼此分離。傳送或發布訊息時，接收者必須訂閱主題，才能收到快訊與訊息內容。如要進一步瞭解 Pub/Sub，請參閱 Cloud Pub/Sub 指南中的「Google Cloud Pub/Sub：Google 規模的訊息傳遞服務」。

如要進一步瞭解事件參數和回呼參數，請參閱 Cloud Functions 說明文件中的「背景函式」。

如要建立 Cloud 函式，請按照下列指示操作：

  1. 在 Cloud Shell 執行下列指令，設定預設區域：

    gcloud config set run/region {{{project_0.default_region |REGION}}}

  2. 為函式程式碼建立目錄：

    mkdir gcf_hello_world && cd $_

  3. 建立並開啟 index.js 來編輯內容：

    nano index.js

  4. 將下列內容複製到 index.js 檔案：

    const functions = require('@google-cloud/functions-framework'); // Register a CloudEvent callback with the Functions Framework that will // be executed when the Pub/Sub trigger topic receives a message. functions.cloudEvent('helloPubSub', cloudEvent => { // The Pub/Sub message is passed as the CloudEvent's data payload. const base64name = cloudEvent.data.message.data; const name = base64name ? Buffer.from(base64name, 'base64').toString() : 'World'; console.log(`Hello, ${name}!`); });

  5. 按下 Ctrl+X 鍵退出 nano 編輯器，並按下 Y 鍵儲存檔案。

  6. 建立並開啟 package.json 來編輯內容：

  7. 將下列內容複製到 package.json 檔案：

    { "name": "gcf_hello_world", "version": "1.0.0", "main": "index.js", "scripts": { "start": "node index.js", "test": "echo \"Error: no test specified\" && exit 1" }, "dependencies": { "@google-cloud/functions-framework": "^3.0.0" } }

  8. 按下 Ctrl+X 鍵退出 nano 編輯器，並按下 Y 鍵儲存檔案。

  9. 安裝套件依附元件：

    npm install

    預期的輸出內容如下：

    added 140 packages, and audited 141 packages in 9s 27 packages are looking for funding run `npm fund` for details found 0 vulnerabilities

工作 2：部署函式

在本實驗室中，您會將 --trigger-topic 設為 cf_demo。

注意：
Cloud Functions 是事件導向型服務，因此必須指定觸發條件類型。部署新函式時，「--trigger-topic」、「--trigger-bucket」或「--trigger-http」都是常見的觸發事件。更新現有函式時，如未另行指定，函式會沿用原有的觸發條件。

  1. 將 helloPubSub 函式部署至名為 cf-demo 的 Pub/Sub 主題

    gcloud functions deploy nodejs-pubsub-function \ --gen2 \ --runtime=nodejs20 \ --region={{{ project_0.default_region | REGION }}} \ --source=. \ --entry-point=helloPubSub \ --trigger-topic cf-demo \ --stage-bucket {{{ project_0.project_id | PROJECT_ID }}}-bucket \ --service-account cloudfunctionsa@{{{ project_0.project_id | PROJECT_ID }}}.iam.gserviceaccount.com \ --allow-unauthenticated 注意：
    出現服務帳戶 serviceAccountTokenCreator 通知時，請按下 n 鍵。

  2. 驗證函式的狀態：

    gcloud functions describe nodejs-pubsub-function \ --region={{{ project_0.default_region | REGION }}}

    如果狀態為「ACTIVE」，代表函式已部署完畢。

    預期的輸出內容如下：

    BuildConfig: automaticUpdatePolicy: {} build: projects/630521560493/locations/{{{ project_0.default_region | REGION }}}/builds/7ff9d415-50d9-4557-9bcd-5afad42a6390 dockerRegistry: ARTIFACT_REGISTRY dockerRepository: projects/{{{ project_0.project_id | PROJECT_ID }}}/locations/{{{ project_0.default_region | REGION }}}/repositories/gcf-artifacts entryPoint: helloPubSub ... State: ACTIVE ... UpdateTime: '2024-08-05T13:51:05.317298824Z' Url: https://{{{ project_0.default_region | REGION }}}-{{{ project_0.project_id | PROJECT_ID }}}.cloudfunctions.net/nodejs-pubsub-function

在主題中發布的每則訊息都會觸發函式執行作業，訊息內容則會以輸入資料的形式傳遞。

測試已完成的工作

點選「Check my progress」，確認工作已完成。如果順利完成，就會看見評估分數。

部署函式。

工作 3：測試函式

部署函式並確認函式狀態為「ACTIVE」後，請測試函式是否會在偵測到事件後，將訊息寫入 Cloud 記錄檔。

  1. 使用部分資料叫用 Pub/Sub。

    gcloud pubsub topics publish cf-demo --message="Cloud Function Gen2"

    輸出內容範例：

    messageIds: - '11927162971409664'

請查看記錄檔，確認當中有符合這組執行作業 ID 的記錄訊息。

工作 4：查看記錄檔

  1. 查看記錄檔，確認歷史記錄中有您的訊息：

    gcloud functions logs read nodejs-pubsub-function \ --region={{{ project_0.default_region | REGION }}} 注意：
    記錄檔會在 10 分鐘內顯示，您也能依序點選「記錄」>「記錄檔探索工具」來查看記錄檔。

    Cloud 函式的輸出資訊大致如下所示：

    LEVEL: NAME: nodejs-pubsub-function EXECUTION_ID: h4v6akxf4sxt TIME_UTC: 2024-08-05 15:15:25.723 LOG: Hello, Cloud Function Gen2! LEVEL: I NAME: nodejs-pubsub-function EXECUTION_ID: TIME_UTC: 2024-08-05 15:15:25.711 LOG: LEVEL: NAME: nodejs-pubsub-function EXECUTION_ID: h4oxfjn7zlyu TIME_UTC: 2024-08-05 15:10:34.303 LOG: Hello, Friend! LEVEL: I NAME: nodejs-pubsub-function EXECUTION_ID: TIME_UTC: 2024-08-05 15:10:34.291 LOG: LEVEL: NAME: nodejs-pubsub-function EXECUTION_ID: h4fjhyfxua3k TIME_UTC: 2024-08-05 15:03:16.342 LOG: Hello, "SGVsbG8gZnJvbSB0aGUgY29tbWFuZCBsaW5l"!

應用程式已部署並測試完畢，您可以查看記錄檔。

工作 5：隨堂測驗

  1. 完成下列選擇題能加深您的印象，更清楚本實驗室介紹的概念，請盡您所能回答。

恭喜！

您已使用 Google Cloud 控制台來建立、部署及測試使用指令列的 Cloud 函式

挑戰下一個研究室

本研究室屬於 Qwik Start 研究室系列，旨在帶您一窺 Google Cloud 的眾多功能。在研究室目錄中搜尋「Qwik Start」，即可找到要進行的下一個研究室！

後續步驟/瞭解詳情

Google Cloud 教育訓練與認證

協助您瞭解如何充分運用 Google Cloud 的技術。我們的課程會介紹專業技能和最佳做法，讓您可以快速掌握要領並持續進修。我們提供從基本到進階等級的訓練課程，並有隨選、線上和虛擬課程等選項，方便您抽空參加。認證可協助您驗證及證明自己在 Google Cloud 技術方面的技能和專業知識。

使用手冊上次更新日期：2024 年 8 月 5 日

實驗室上次測試日期：2024 年 8 月 5 日

Copyright 2024 Google LLC 保留所有權利。Google 和 Google 標誌是 Google LLC 的商標，其他公司和產品名稱則有可能是其關聯公司的商標。

此内容目前不可用

一旦可用，我们会通过电子邮件告知您

太好了！

一旦可用，我们会通过电子邮件告知您