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 setup and access」面板會顯示下列項目：

   • 「Open Google Cloud console」按鈕
   • 此實驗室所需的臨時憑證 (使用者名稱和密碼)
   • 完成此實驗室所需的其他資訊 (如有)

   請注意，實驗室計時器位於頁面頂端附近，會顯示剩餘時間。

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

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

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

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

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

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

   您也可以在「Lab setup and access」面板找到「Username」。

4. 點選「下一步」。

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

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

   您也可以在「Lab setup and access」面板找到「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」圖示 。

2. 系統顯示視窗時，請按照下列步驟操作：

   • 繼續操作 Cloud Shell 視窗。
   • 授權 Cloud Shell 使用您的憑證發出 Google Cloud API 呼叫。

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

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

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

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

gcloud auth list

4. 點按「授權」。

輸出內容：

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (選用) 您可以使用下列指令來列出專案 ID：

gcloud config list project

輸出內容：

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} 注意：如需 gcloud 的完整說明，請前往 Google Cloud 參閱 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

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

--- messageStoragePolicy: allowedPersistenceRegions: - us-central1 name: projects/qwiklabs-gcp-01-af5b4aaa2d32/topics/myTopic --- messageStoragePolicy: allowedPersistenceRegions: - us-central1 name: projects/qwiklabs-gcp-01-af5b4aaa2d32/topics/Test1 --- messageStoragePolicy: allowedPersistenceRegions: - us-central1 name: projects/qwiklabs-gcp-01-af5b4aaa2d32/topics/Test2

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 --limit=3

輸出內容應該會和以下示例相同：

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

恭喜！

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

挑戰下一個研究室

本實驗室屬於 Qwik Start 實驗室系列，旨在帶您一窺 Google Cloud 的眾多功能。歡迎在實驗室目錄搜尋「Qwik Start」，看看接下來要參加哪個實驗室！

Google Cloud 教育訓練與認證

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

使用手冊上次更新日期：2025 年 3 月 10 日

實驗室上次測試日期：2025 年 3 月 10 日

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