arrow_back

Google Cloud Pub/Sub:Qwik Start - 指令列

加入 登录

Google Cloud Pub/Sub:Qwik Start - 指令列

40 分钟 免费

GSP095

Google Cloud 自修研究室標誌

總覽

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

課程內容

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

  • 瞭解 Pub/Sub 的基本概念。

  • 建立、刪除及列出 Pub/Sub 主題。

  • 建立、刪除及列出 Pub/Sub 訂閱項目。

  • 將訊息發布至主題。

  • 使用提取訂閱者指令輸出單則主題訊息。

  • 使用加上旗標的提取訂閱者指令輸出多則訊息。

事前準備

這是入門等級的研究室,預設對象為 Pub/Sub 使用經驗不多或未曾用過的使用者。您可以在本研究室中學到設定及使用這項 Google Cloud 服務的基本概念。

開始本研究室前,請評估您對 Pub/Sub 的熟悉程度。以下是一些較具挑戰性的研究室課程,可讓您將 Pub/Sub 知識應用在其他雲端服務和用途:

準備好後請向下捲動頁面,並按照步驟設定研究室環境。

設定和需求

點選「Start Lab」(開始研究室) 按鈕前的須知事項

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

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

如要完成這個研究室活動,請先確認:

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

現在您的研究室環境已就緒,接著請登入 Google Cloud Shell 控制台,然後啟動指令列工具。

如何開始研究室及登入 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」圖示 「啟動 Cloud Shell」圖示

  2. 按一下「繼續」

佈建並連線至環境的作業需要一些時間才能完成。連線完成即代表已通過驗證,且專案已設為您的「PROJECT_ID」。輸出內容中有一行宣告本工作階段 PROJECT_ID 的文字:

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

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

  1. (選用) 您可以使用下列指令來列出使用中的帳戶:

gcloud auth list

輸出內容:

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 總覽指南)。

Pub/Sub 基本概念

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

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

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

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

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

工作 1:Pub/Sub 主題

Pub/Sub 服務已預先安裝在 Google Cloud Shell 中,不必再安裝或設定即可開始使用。

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

gcloud pubsub topics create myTopic

測試已完成的工作

點選「Check my progress」(檢查我的進度) 確認工作已完成。如果已成功完成工作,就會看到評估分數。

建立 Pub/Sub 主題。
  1. 另外再建立兩個主題做為測試,分別命名為 Test1Test2

gcloud pubsub topics create Test1 gcloud pubsub topics create Test2
  1. 如要查看您剛才建立的三個主題,請執行下列指令:

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
  1. 現在來清除主題。請執行下列指令刪除 Test1Test2

gcloud pubsub topics delete Test1 gcloud pubsub topics delete Test2
  1. 再次執行 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 訂閱項目。
  1. myTopic 加入兩個訂閱項目。執行下列指令建立 Test1Test2 訂閱項目:

gcloud pubsub subscriptions create --topic myTopic Test1 gcloud pubsub subscriptions create --topic myTopic Test2
  1. 執行以下指令,列出 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

測試您的瞭解程度

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

  1. 現在刪除 Test1Test2 訂閱項目。執行下列指令:

gcloud pubsub subscriptions delete Test1 gcloud pubsub subscriptions delete Test2
  1. 確認 Test1Test2 訂閱項目是否已遭刪除。再次執行 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"
  1. 發布幾則訊息到 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 訂閱項目,因此這項指令應該會產生作用。

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

gcloud pubsub subscriptions pull mySubscription --auto-ack

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

有三個資料欄的表格,欄位名稱分別為「Data」、「Message_ID」和「Attributes」。「Data」欄含有以下內容:Publisher likes to eat <FOOD>。

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

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

  • 使用提取指令而未加入任何旗標,系統就只會輸出一則訊息,即使您訂閱的主題有多則訊息亦然。

  • 以訂閱為前提的特定提取指令輸出某則訊息後,您就無法再使用提取指令存取同一則訊息。

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

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

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"
  1. 在指令中加入 flag,就可以透過一次要求輸出所有三則訊息。

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

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

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

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

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

有三個資料欄的表格,欄位名稱分別為:「Data」、「Message_ID」和「Attributes」。「Data」欄包含三行資料。

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

恭喜!

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

完成您的任務

這個自修研究室是「基本概念:基礎架構」任務的一部分。任務是指一系列相關的研究室課程,這些研究室構成一個完整的學習路徑。完成這項任務後即可獲得徽章,以表彰您的成就。您可以公開展示徽章並連結到自己的線上履歷或社群媒體帳戶。歡迎報名參加這個任務,立即取得完成學分。請參閱 Google Cloud 技能重點加強目錄查看所有可參加的任務。

挑戰下個研究室

本研究室是一系列稱為 Qwik Start 的研究室之一,這些研究室旨在讓您稍微瞭解 Google Cloud 提供的眾多功能。在研究室目錄中搜尋「Qwik Start」,即可找到您想進行的下一個研究室!

後續步驟/瞭解詳情

如想瞭解完全不同的內容,請參閱「適用於行動應用程式的 Google 地圖網路服務 Proxy」。

Google Cloud 教育訓練與認證

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

使用手冊上次更新日期:2022 年 8 月 8 日

研究室上次測試日期:2019 年 9 月 9 日

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