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 控制台
-
點選「Start Lab」按鈕。如果實驗室會產生費用,畫面上會出現選擇付款方式的對話方塊。左側的「Lab Details」窗格會顯示下列項目:
- 「Open Google Cloud console」按鈕
- 剩餘時間
- 必須在這個研究室中使用的臨時憑證
- 完成這個實驗室所需的其他資訊 (如有)
-
點選「Open Google Cloud console」;如果使用 Chrome 瀏覽器,也能按一下滑鼠右鍵,選取「在無痕視窗中開啟連結」。
接著,實驗室會啟動相關資源,並開啟另一個分頁,顯示「登入」頁面。
提示:您可以在不同的視窗中並排開啟分頁。
注意:如果頁面中顯示「選擇帳戶」對話方塊,請點選「使用其他帳戶」。
-
如有必要,請將下方的 Username 貼到「登入」對話方塊。
{{{user_0.username | "Username"}}}
您也可以在「Lab Details」窗格找到 Username。
-
點選「下一步」。
-
複製下方的 Password,並貼到「歡迎使用」對話方塊。
{{{user_0.password | "Password"}}}
您也可以在「Lab Details」窗格找到 Password。
-
點選「下一步」。
重要事項:請務必使用實驗室提供的憑證,而非自己的 Google Cloud 帳戶憑證。
注意:如果使用自己的 Google Cloud 帳戶來進行這個實驗室,可能會產生額外費用。
-
按過後續的所有頁面:
- 接受條款及細則。
- 由於這是臨時帳戶,請勿新增救援選項或雙重驗證機制。
- 請勿申請免費試用。
Google Cloud 控制台稍後會在這個分頁開啟。
注意:如要使用 Google Cloud 產品和服務,請點選「導覽選單」,或在「搜尋」欄位輸入服務或產品名稱。
啟動 Cloud Shell
Cloud Shell 是搭載多項開發工具的虛擬機器,提供永久的 5 GB 主目錄,而且在 Google Cloud 中運作。Cloud Shell 提供指令列存取權,方便您使用 Google Cloud 資源。
-
點按 Google Cloud 控制台頂端的「啟用 Cloud Shell」圖示
。
-
系統顯示視窗時,請按照下列步驟操作:
- 繼續操作 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 鍵自動完成功能。
- (選用) 您可以執行下列指令來列出使用中的帳戶:
gcloud auth list
- 點按「授權」。
輸出內容:
ACTIVE: *
ACCOUNT: {{{user_0.username | "ACCOUNT"}}}
To set the active account, run:
$ gcloud config set account `ACCOUNT`
- (選用) 您可以使用下列指令來列出專案 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 中,您不必進行任何安裝或設定即可開始使用。
- 執行下列指令,建立名為
myTopic 的主題:
gcloud pubsub topics create myTopic
測試已完成的工作
點選「Check my progress」,確認工作已完成。如果已順利完成工作,您就會看見評估分數。
建立 Pub/Sub 主題。
- 另外再建立兩個主題做為測試,分別命名為
Test1 和 Test2:
gcloud pubsub topics create Test1
gcloud pubsub topics create Test2
- 如要查看您剛才建立的三個主題,請執行下列指令:
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
- 現在來清除主題。請執行下列指令刪除
Test1 和 Test2。
gcloud pubsub topics delete Test1
gcloud pubsub topics delete Test2
- 再次執行
gcloud pubsub topics list 指令,確認兩個主題已經刪除:
gcloud pubsub topics list
您應該會看到以下輸出內容:
---
name: projects/qwiklabs-gcp-3450558d2b043890/topics/myTopic
工作 2:Pub/Sub 訂閱項目
現在您已熟悉建立、查看及刪除主題的方法,可以針對訂閱項目進行操作了。
- 執行下列指令,為
myTopic 主題建立名為 mySubscription 的訂閱項目:
gcloud pubsub subscriptions create --topic myTopic mySubscription
測試已完成的工作
點選「Check my progress」,確認工作已完成。如果已順利完成工作,您就會看見評估分數。
建立 Pub/Sub 訂閱項目。
- 為
myTopic 加入兩個訂閱項目。執行下列指令建立 Test1 和 Test2 訂閱項目:
gcloud pubsub subscriptions create --topic myTopic Test1
gcloud pubsub subscriptions create --topic myTopic Test2
- 執行以下指令,列出 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
測試您的瞭解程度
下列選擇題可以加深您對本實驗室概念的理解,請按照您的理解盡力回答。
- 現在刪除
Test1 和 Test2 訂閱項目。執行下列指令:
gcloud pubsub subscriptions delete Test1
gcloud pubsub subscriptions delete Test2
- 確認
Test1 和 Test2 訂閱項目是否已經刪除。再次執行 list-subscriptions 指令:
gcloud pubsub topics list-subscriptions myTopic
您應該會看到以下輸出內容:
---
projects/qwiklabs-gcp-3450558d2b043890/subscriptions/mySubscription
工作 3:透過 Pub/Sub 發布及提取單則訊息
接下來,您會學到如何發布訊息到 Pub/Sub 主題。
- 執行下列指令,將
"hello" 訊息發布到您先前建立的主題 (myTopic):
gcloud pubsub topics publish myTopic --message "Hello"
- 發布幾則訊息到
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 訂閱項目,因此這項指令應該會產生作用。
- 使用以下指令從 Pub/Sub 主題提取您剛才發布的訊息:
gcloud pubsub subscriptions pull mySubscription --auto-ack
輸出內容應該會類似以下示例:

這到底是怎麼一回事?您發布了 4 則訊息到主題中,但系統只輸出 1 則訊息。
在這裡特別提醒開發人員,pull 指令有以下特點,如未留意很容易出錯:
- 若使用提取指令而未加入任何旗標,即使您訂閱的主題有多則訊息,系統將只會輸出一則訊息。
- 以訂閱為前提的特定提取指令輸出某則訊息後,您就無法再使用提取指令存取同一則訊息。
-
如想瞭解第二條內容的涵義,請執行最後一個指令三次。您會看到輸出內容包含先前發布的其他訊息。
-
現在執行該指令第四次。您會看到以下輸出內容 (原因正是已無內容可傳回):
gcpstaging20394_student@cloudshell:~ (qwiklabs-gcp-3450558d2b043890)$ gcloud pubsub subscriptions pull mySubscription --auto-ack
Listed 0 items.
在最後一節中,您將瞭解如何使用 flag 旗標從某個主題提取多則訊息。
工作 4:透過 Pub/Sub 從訂閱項目提取所有訊息
由於在最後一個範例中,您已從主題提取了所有訊息,因此請將幾則訊息加到 myTopic 中。
- 執行下列指令:
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"
- 在指令中加入
flag,就可以透過一次要求輸出所有三則訊息。
或許您尚未留意,但其實您一直在使用旗標:pull 指令的 --auto-ack 部分就是一種旗標,會對訊息設定格式,將提取的訊息放進工整方塊中。
limit 是另一種旗標,用來設定要提取的訊息數上限。
- 請稍候幾分鐘,等待系統建立主題。然後執行加上
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 2025 Google LLC 保留所有權利。Google 和 Google 標誌是 Google LLC 的商標,其他公司和產品名稱則有可能是其關聯公司的商標。