GSP080

總覽

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

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

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

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

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

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

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

課程內容

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

設定

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

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

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

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

• 您可以使用標準的網際網路瀏覽器 (Chrome 瀏覽器為佳)。

注意：請使用無痕模式或私密瀏覽視窗執行此研究室。這可以防止個人帳戶和學生帳戶之間的衝突，避免個人帳戶產生額外費用。

• 是時候完成研究室活動了！別忘了，活動一開始將無法暫停。

注意：如果您擁有個人 Google Cloud 帳戶或專案，請勿用於本研究室，以免產生額外費用。

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

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

   • 「Open Google Console」(開啟 Google 控制台) 按鈕
   • 剩餘時間
   • 必須在這個研究室中使用的暫時憑證
   • 完成這個研究室所需的其他資訊 (如有)

2. 按一下「Open Google Console」(開啟 Google 控制台)。接著，研究室會啟動相關資源並開啟另一個分頁，當中會顯示「Sign in」(登入) 頁面。

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

   注意事項：如果頁面中顯示了「Choose an account」(選擇帳戶) 對話方塊，請按一下「Use Another Account」(使用其他帳戶)。

3. 如有必要，請複製「Lab Details」(研究室詳細資料) 面板中的使用者名稱，然後貼到「Sign in」(登入) 對話方塊。按一下「Next」(下一步)。

4. 複製「Lab Details」(研究室詳細資料) 面板中的密碼，然後貼到「Welcome」(歡迎使用) 對話方塊。按一下「Next」(下一步)。

   重要注意事項：請務必使用左側面板中的憑證，而非 Google Cloud 技能重點加強的憑證。 注意事項：如果使用自己的 Google Cloud 帳戶來進行這個研究室，可能會產生額外費用。

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

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

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

注意事項：按一下畫面左上方的導覽選單，即可在選單中查看 Google Cloud 產品與服務的清單。

啟動 Cloud Shell

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

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

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

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

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

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

gcloud auth list

3. 點按「授權」。

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

輸出內容：

ACTIVE: * ACCOUNT: student-01-xxxxxxxxxxxx@qwiklabs.net To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (選用) 您可以使用下列指令來列出專案 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 compute/region {{{project_0.default_region |REGION}}}

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

mkdir gcf_hello_world

3. 前往 gcf_hello_world 目錄：

cd gcf_hello_world

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

nano index.js

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

/** * Background Cloud Function to be triggered by Pub/Sub. * This function is exported by index.js, and executed when * the trigger topic receives a message. * * @param {object} data 事件酬載。 * @param {object} context 事件中繼資料。 */ exports.helloWorld = (data, context) => { const pubSubMessage = data; const name = pubSubMessage.data ? Buffer.from(pubSubMessage.data, 'base64').toString() : "Hello World"; console.log(`My Cloud Function: ${name}`); };

6. 同時按下 Ctrl 與 X 鍵退出 nano 編輯器，並按下 Y 鍵儲存檔案。

工作 2：建立 Cloud Storage 值區

• 請輸入下列指令，為函式建立新的 Cloud Storage 值區：

gsutil mb -p [PROJECT_ID] gs://[BUCKET_NAME]

• PROJECT_ID 是專案 ID，可在這個研究室左側的研究室詳細資料面板中找到：

• BUCKET_NAME 是您為值區指定的名稱。您可以將專案 ID 做為值區名稱，確保指定的是全域不重複的名稱：

若要進一步瞭解如何為值區命名，請參閱 Cloud Storage 說明文件中的值區命名指南。

測試已完成的工作

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

建立 Cloud Storage 值區。

工作 3：部署函式

部署新函式時，您必須指定 --trigger-topic、--trigger-bucket 或 --trigger-http。更新現有函式時，如未另行指定，函式會沿用原有的觸發條件。

在這個研究室中，您會將 --trigger-topic 設為 hello_world。

1. 將函式部署至 Pub/Sub 主題 hello_world，並將 [BUCKET_NAME] 替換為您的值區名稱：

gcloud functions deploy helloWorld \ --stage-bucket [BUCKET_NAME] \ --trigger-topic hello_world \ --runtime nodejs20 注意：如果收到 OperationError，請忽略警告並再次執行指令。

如果出現提示訊息，請輸入 Y，允許在未經驗證的情況下叫用新函式。

2. 驗證函式的狀態：

gcloud functions describe helloWorld

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

entryPoint: helloWorld eventTrigger: eventType: providers/cloud.pubsub/eventTypes/topic.publish failurePolicy: {} resource: ... status: ACTIVE ...

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

測試已完成的工作

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

部署函式。

工作 4：測試函式

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

• 請輸入下列指令，為函式建立訊息測試：

DATA=$(printf 'Hello World!'|base64) && gcloud functions call helloWorld --data '{"data":"'$DATA'"}'

如果 Cloud 工具傳回函式的執行作業 ID，代表訊息已寫入記錄檔。

輸出內容範例：

executionId: 3zmhpf7l6j5b

請查看記錄檔，確認記錄訊息含有該組執行作業 ID。

工作 5：查看記錄檔

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

gcloud functions logs read helloWorld

如果函式成功執行，記錄檔中會顯示下列訊息：

LEVEL: D NAME: helloWorld EXECUTION_ID: 4bgl3jw2a9i3 TIME_UTC: 2023-03-23 13:45:31.545 LOG: Function execution took 912 ms, finished with status: 'ok' LEVEL: I NAME: helloWorld EXECUTION_ID: 4bgl3jw2a9i3 TIME_UTC: 2023-03-23 13:45:31.533 LOG: My Cloud Function: Hello World! LEVEL: D NAME: helloWorld EXECUTION_ID: 4bgl3jw2a9i3 TIME_UTC: 2023-03-23 13:45:30.633 LOG: Function execution started 注意：記錄檔大約會在 10 分鐘內顯示。您也可以依序點選「記錄」>「記錄檔探索工具」來查看記錄檔。

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

工作 6：測試您的瞭解程度

下列選擇題可強化您對本研究室所述概念的理解，請盡力回答即可。

恭喜！

完成您的任務

這個自修研究室是下列任務的一部分：Baseline: Deploy & Develop、Baseline: Infrastructure 和 Optimizing your Google Cloud Costs。「任務」是指一系列相關的研究室課程，藉由課程建立出完整的學習路徑。完成這項任務後即可獲得徽章，以表彰您的成就。您可以公開展示徽章，並在線上履歷或社群媒體帳戶中加入徽章連結。歡迎報名參加任何包含這個研究室的任務，立即取得完成學分。請參閱 Google Cloud Skills Boost 目錄，查看所有可參加的任務。

進行下一個研究室

這個研究室也是一系列稱為 Qwik Start 的研究室之一，這些研究室旨在讓您稍微體驗 Google Cloud 提供的眾多功能。在研究室目錄中搜尋「Qwik Start」，即可找到要進行的下一個研究室！

後續步驟/瞭解詳情

• 您已透過指令列啟動 Cloud 函式，接著請前往「Cloud Functions：Qwik Start - 控制台」研究室，嘗試使用 Cloud 控制台啟動 Cloud 函式。
• 若要進一步瞭解如何建立觸發條件並連結至函式，請參閱 Cloud Functions 指南中的事件與觸發條件部分。

Google Cloud 教育訓練與認證

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

使用手冊上次更新日期：2023 年 8 月 10 日

研究室上次測試日期：2023 年 8 月 10 日

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