检查点
Create a cloud storage bucket
/ 50
Deploy the function
/ 50
Cloud Functions:Qwik Start - 指令列
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 控制台
-
按一下「Start Lab」(開始研究室) 按鈕。如果研究室會產生費用,畫面中會出現選擇付款方式的彈出式視窗。左側的「Lab Details」(研究室詳細資料) 面板會顯示下列項目:
- 「Open Google Console」(開啟 Google 控制台) 按鈕
- 剩餘時間
- 必須在這個研究室中使用的暫時憑證
- 完成這個研究室所需的其他資訊 (如有)
-
按一下「Open Google Console」(開啟 Google 控制台)。接著,研究室會啟動相關資源並開啟另一個分頁,當中會顯示「Sign in」(登入) 頁面。
提示:您可以在不同的視窗中並排開啟分頁。
注意事項:如果頁面中顯示了「Choose an account」(選擇帳戶) 對話方塊,請按一下「Use Another Account」(使用其他帳戶)。 -
如有必要,請複製「Lab Details」(研究室詳細資料) 面板中的使用者名稱,然後貼到「Sign in」(登入) 對話方塊。按一下「Next」(下一步)。
-
複製「Lab Details」(研究室詳細資料) 面板中的密碼,然後貼到「Welcome」(歡迎使用) 對話方塊。按一下「Next」(下一步)。
重要注意事項:請務必使用左側面板中的憑證,而非 Google Cloud 技能重點加強的憑證。 注意事項:如果使用自己的 Google Cloud 帳戶來進行這個研究室,可能會產生額外費用。 -
按過後續的所有頁面:
- 接受條款及細則。
- 由於這是臨時帳戶,請勿新增救援選項或雙重驗證機制。
- 請勿申請免費試用。
Cloud 控制台稍後會在這個分頁中開啟。
啟動 Cloud Shell
Cloud Shell 是搭載多項開發工具的虛擬機器,提供永久的 5 GB 主目錄,而且在 Google Cloud 中運作。Cloud Shell 提供指令列存取權,方便您使用 Google Cloud 資源。
- 點按 Google Cloud 控制台上方的「啟用 Cloud Shell」圖示 。
連線完成即代表已通過驗證,且專案已設為您的 PROJECT_ID。輸出內容中有一行宣告本工作階段 PROJECT_ID 的文字:
gcloud
是 Google Cloud 的指令列工具,已預先安裝於 Cloud Shell,並支援 Tab 鍵自動完成功能。
- (選用) 您可以執行下列指令來列出使用中的帳戶:
-
點按「授權」。
-
輸出畫面應如下所示:
輸出內容:
- (選用) 您可以使用下列指令來列出專案 ID:
輸出內容:
輸出內容範例:
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 函式,請按照下列指示操作:
- 在 Cloud Shell 中執行下列指令,設定預設區域:
- 為函式程式碼建立目錄:
- 前往
gcf_hello_world
目錄:
- 建立並開啟
index.js
來編輯內容:
- 將下列內容複製到
index.js
檔案:
- 同時按下 Ctrl 與 X 鍵退出 nano 編輯器,並按下 Y 鍵儲存檔案。
工作 2:建立 Cloud Storage 值區
- 請輸入下列指令,為函式建立新的 Cloud Storage 值區:
PROJECT_ID 是專案 ID,可在這個研究室左側的研究室詳細資料面板中找到:
BUCKET_NAME 是您為值區指定的名稱。您可以將專案 ID 做為值區名稱,確保指定的是全域不重複的名稱:
如要進一步瞭解如何為值區命名,請參閱 Cloud Storage 說明文件中的「值區命名指南」。
測試已完成的工作
點選「Check my progress」,確認工作已完成。如果已順利完成工作,您就會看見評估分數。
工作 3:部署函式
部署新函式時,您必須指定 --trigger-topic
、--trigger-bucket
或 --trigger-http
。更新現有函式時,如未另行指定,函式會沿用原有的觸發條件。
在這個研究室中,您會將 --trigger-topic
設為 hello_world
。
- 停用 Cloud Functions API:
- 重新啟用 Cloud Functions API:
- 在您的 Appspot 服務帳戶新增
artifactregistry.reader
權限。將 [PROJECT_ID] 改成您的 qwiklabs 專案 ID。
- 將函式部署至 Pub/Sub 主題 hello_world,並將
[BUCKET_NAME]
改成您的值區名稱:
如果出現提示訊息,請輸入 Y
,允許未經驗證就叫用新函式。
- 驗證函式的狀態:
如果狀態為「ACTIVE」,代表函式已部署完畢。
在主題中發布的每則訊息都會觸發函式執行作業,訊息內容則會以輸入資料的形式傳遞。
測試已完成的工作
點選「Check my progress」,確認工作已完成。如果已順利完成工作,您就會看見評估分數。
工作 4:測試函式
部署函式並確認函式狀態為「ACTIVE」之後,請測試函式是否會在偵測到事件時,將訊息寫入雲端記錄檔。
- 請輸入下列指令,為函式建立訊息測試:
如果 Cloud 工具傳回函式的執行作業 ID,代表訊息已寫入記錄檔。
輸出內容範例:
請查看記錄檔,確認記錄訊息含有該組執行作業 ID。
工作 5:查看記錄檔
- 請查看記錄檔,確認歷史記錄中有您的訊息:
如果函式成功執行,記錄檔中會顯示下列訊息:
應用程式已部署並測試完畢,您可以查看記錄檔。
工作 6:測試您的瞭解程度
完成下列選擇題能加深您的印象,更清楚本研究室介紹的概念,請盡您所能回答。
恭喜!
您已使用 Google Cloud 控制台來建立、部署及測試使用指令列的 Cloud 函式
挑戰下一個研究室
本研究室屬於 Qwik Start 研究室系列,旨在帶您一窺 Google Cloud 的眾多功能。在研究室目錄中搜尋「Qwik Start」,即可找到要進行的下一個研究室!
後續步驟/瞭解詳情
- 您已透過指令列啟動 Cloud 函式,接著請前往「Cloud Functions:Qwik Start - 控制台」研究室,嘗試使用 Cloud 控制台啟動 Cloud 函式。
- 如要進一步瞭解如何建立觸發條件並連結至函式,請參閱 Cloud Functions 指南中的「事件與觸發條件」部分。
Google Cloud 教育訓練與認證
協助您瞭解如何充分運用 Google Cloud 的技術。我們的課程會介紹專業技能和最佳做法,讓您可以快速掌握要領並持續進修。我們提供從基本到進階等級的訓練課程,並有隨選、線上和虛擬課程等選項,方便您抽空參加。認證可協助您驗證及證明自己在 Google Cloud 技術方面的技能和專業知識。
使用手冊上次更新日期:2024 年 4 月 8 日
研究室上次測試日期:2024 年 4 月 8 日
Copyright 2024 Google LLC 保留所有權利。Google 和 Google 標誌是 Google LLC 的商標,其他公司和產品名稱則有可能是其關聯公司的商標。