GSP095

總覽

Pub/Sub 是在應用程式與服務之間交換事件資料的訊息服務。這項服務將傳送者與接收者分離，因此可在獨立撰寫的應用程式之間進行安全且可用性高的通訊。Pub/Sub 提供低延遲且持久耐用的訊息功能，開發人員常使用 Pub/Sub 實作非同步工作流程、發布事件通知，以及從各種程序或裝置串流資料。

課程內容

在本研究室中，您將完成以下學習內容：

• 建立、刪除及列出 Pub/Sub 主題和訂閱項目
• 將訊息發布至主題
• 如何使用提取訂閱者指令

先備知識

這是入門等級的研究室，預設對象為 Pub/Sub 使用經驗不多或未曾用過的使用者。您可以在本研究室中學到設定及使用這項 Google 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」圖示 。

連線完成即代表已通過驗證，且專案已設為您的 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 總覽指南)。

Pub/Sub 基本概念

如先前所述，Pub/Sub 是非同步的全域訊息服務。Pub/Sub 中常出現的三個術語為：「topic」(主題)、「publishing」(發布) 和「subscribing」(訂閱)。

• topic 是一個共用字串，可讓多個應用程式透過共同執行緒彼此連結。

• 發布者會將訊息推送 (或 publish) 至 Cloud Pub/Sub 主題。

• 使用者訂閱 (subscription) 某個主題並從該處提取訊息，或是設定 Webhook 推送訂閱項目。每位訂閱者必須在一定時間內確認每則訊息 (確認時限可供設定)。

簡言之，供應商將訊息發布到主題，而消費者訂閱該主題即可接收訊息。

工作 1：Pub/Sub 主題

Pub/Sub 服務預先安裝在 Cloud Shell 中，您不必進行任何安裝或設定即可開始使用。

1. 執行下列指令，建立名為 myTopic 的主題：

gcloud pubsub topics create myTopic

測試已完成的工作

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

建立 Pub/Sub 主題。

2. 另外再建立兩個主題做為測試，分別命名為 Test1 和 Test2：

gcloud pubsub topics create Test1 gcloud pubsub topics create Test2

3. 如要查看您剛才建立的三個主題，請執行下列指令：

gcloud pubsub topics list

輸出內容應該會類似以下示例：

name: projects/qwiklabs-gcp-3450558d2b043890/topics/myTopic --- name: projects/qwiklabs-gcp-3450558d2b043890/topics/Test2 --- name: projects/qwiklabs-gcp-3450558d2b043890/topics/Test1

4. 現在來清除主題。請執行下列指令刪除 Test1 和 Test2。

gcloud pubsub topics delete Test1 gcloud pubsub topics delete Test2

5. 再次執行 gcloud pubsub topics list 指令，確認兩個主題已經刪除：

gcloud pubsub topics list

您應該會看到以下輸出內容：

--- name: projects/qwiklabs-gcp-3450558d2b043890/topics/myTopic

工作 2：Pub/Sub 訂閱項目

現在您已熟悉建立、查看及刪除主題的方法，可以針對訂閱項目進行操作了。

1. 執行下列指令，為 myTopic 主題建立名為 mySubscription 的訂閱項目：

gcloud pubsub subscriptions create --topic myTopic mySubscription

測試已完成的工作

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

建立 Pub/Sub 訂閱項目。

2. 為 myTopic 加入兩個訂閱項目。執行下列指令建立 Test1 和 Test2 訂閱項目：

gcloud pubsub subscriptions create --topic myTopic Test1 gcloud pubsub subscriptions create --topic myTopic Test2

3. 執行以下指令，列出 myTopic 的訂閱項目：

gcloud pubsub topics list-subscriptions myTopic

輸出內容應該會類似以下示例：

--- projects/qwiklabs-gcp-3450558d2b043890/subscriptions/Test2 --- projects/qwiklabs-gcp-3450558d2b043890/subscriptions/Test1 --- projects/qwiklabs-gcp-3450558d2b043890/subscriptions/mySubscription

測試您的瞭解程度

您可透過下列選擇題更清楚本研究室的概念。請按照您的理解盡力回答。

4. 現在刪除 Test1 和 Test2 訂閱項目。執行下列指令：

gcloud pubsub subscriptions delete Test1 gcloud pubsub subscriptions delete Test2

5. 確認 Test1 和 Test2 訂閱項目是否已經刪除。再次執行 list-subscriptions 指令：

gcloud pubsub topics list-subscriptions myTopic

您應該會看到以下輸出內容：

--- projects/qwiklabs-gcp-3450558d2b043890/subscriptions/mySubscription

工作 3：透過 Pub/Sub 發布及提取單則訊息

接下來，您會學到如何發布訊息到 Pub/Sub 主題。

1. 執行下列指令，將 "hello" 訊息發布到您先前建立的主題 (myTopic)：

gcloud pubsub topics publish myTopic --message "Hello"

2. 發布幾則訊息到 myTopic。執行下列指令 (將 <YOUR NAME> 和 <FOOD> 替換成您的名稱和喜歡的食物)：

gcloud pubsub topics publish myTopic --message "Publisher's name is <YOUR NAME>" gcloud pubsub topics publish myTopic --message "Publisher likes to eat <FOOD>" gcloud pubsub topics publish myTopic --message "Publisher thinks Pub/Sub is awesome"

接著，使用 pull 指令從主題提取訊息。提取指令是以訂閱為前提，由於您先前已為 myTopic 主題設定了 mySubscription 訂閱項目，因此這項指令應該會產生作用。

3. 使用以下指令從 Pub/Sub 主題提取您剛才發布的訊息：

gcloud pubsub subscriptions pull mySubscription --auto-ack

輸出內容應該會類似以下示例：

這到底是怎麼一回事？您發布了 4 則訊息到主題中，但系統只輸出 1 則訊息。

在這裡特別提醒開發人員，pull 指令有以下特點，如未留意很容易出錯：

• 若使用提取指令而未加入任何旗標，即使您訂閱的主題有多則訊息，系統將只會輸出一則訊息。
• 以訂閱為前提的特定提取指令輸出某則訊息後，您就無法再使用提取指令存取同一則訊息。

4. 如想瞭解第二條內容的涵義，請執行最後一個指令三次。您會看到輸出內容包含先前發布的其他訊息。

5. 現在執行該指令第四次。您會看到以下輸出內容 (原因正是已無內容可傳回)：

gcpstaging20394_student@cloudshell:~ (qwiklabs-gcp-3450558d2b043890)$ gcloud pubsub subscriptions pull mySubscription --auto-ack Listed 0 items.

在最後一節中，您將瞭解如何使用 flag 旗標從某個主題提取多則訊息。

工作 4：透過 Pub/Sub 從訂閱項目提取所有訊息

由於在最後一個範例中，您已從主題提取了所有訊息，因此請將幾則訊息加到 myTopic 中。

1. 執行下列指令：

gcloud pubsub topics publish myTopic --message "Publisher is starting to get the hang of Pub/Sub" gcloud pubsub topics publish myTopic --message "Publisher wonders if all messages will be pulled" gcloud pubsub topics publish myTopic --message "Publisher will have to test to find out"

2. 在指令中加入 flag，就可以透過一次要求輸出所有三則訊息。

或許您尚未留意，但其實您一直在使用旗標：pull 指令的 --auto-ack 部分就是一種旗標，會對訊息設定格式，將提取的訊息放進工整方塊中。

limit 是另一種旗標，用來設定要提取的訊息數上限。

3. 請稍候幾分鐘，等待系統建立主題。執行加上 limit 旗標的提取指令：

gcloud pubsub subscriptions pull mySubscription --auto-ack --limit=3

輸出內容應符合以下示例：

您現已瞭解如何在 Pub/Sub 指令中加入旗標輸出較多訊息，順利邁向成為 Pub/Sub 專家的道路。

恭喜！

在這個研究室中，您學到了 Pub/Sub 主題、訂閱項目、提取指令和旗標的基本概念。

挑戰下一個研究室

本研究室是一系列稱為 Qwik Start 的研究室之一，這些研究室旨在讓您稍微瞭解 Google Cloud 提供的眾多功能。歡迎在研究室目錄中搜尋「Qwik Start」，看看接下來要參加哪個研究室！

Google Cloud 教育訓練與認證

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

使用手冊上次更新日期：2024 年 2 月 13 日

研究室上次測試日期：2023 年 5 月 25 日

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