本教學課程說明如何部署簡單的 Cloud Search 解決方案,並使用 GitHub 做為要建立索引的資料存放區。具體來說,本教學課程包含兩個應用程式範例:
- 使用 Cloud Search Connector SDK 建立的內容連接器,用於為 GitHub 存放區中的資料建立索引。索引資料包括問題、提取要求,以及預設分支 (
master
) 的首要內容。 - 使用搜尋小工具提供自訂搜尋介面的網頁應用程式。
必要條件
本教學課程需要下列先決條件:
- 管理員可存取已啟用第三方資料索引功能的 Google Workspace 或 Cloud Identity 網域。如果無法在管理控制台中查看設定,請與網域管理員聯絡,或註冊 Cloud Search。
- GitHub 使用者帳戶。
- 熟悉 Java 和 JavaScript。
- Java 8 以上版本。
- Maven。
- Node.js 8.11 以上版本。
建立教學課程專案
首先,您必須建立 Google Cloud Platform 專案。這項專案是建立、啟用和使用所有 Google Cloud Platform (GCP) 服務的基礎,包括管理 API、啟用計費功能、新增和移除協作者,以及管理權限。
開啟 Google Cloud 控制台。
在頁面頂端,按一下「Google Cloud 主控台」右側的
。畫面上會顯示一個對話方塊,其中列出目前的專案。按一下「新專案」。畫面上會顯示「New Project」畫面。
在「Project Name」欄位中輸入專案名稱,例如「SearchTutorial」。
(選用) 按一下「Edit」來編輯專案 ID。專案 ID 建立後就無法變更,因此請選用符合專案整個生命週期需求的 ID。
如要瀏覽專案的位置,請按一下「瀏覽」。
按一下專案的位置,然後點選「選取」。
按一下「建立」。控制台會前往「Dashboard」(資訊主頁) 頁面。專案會在幾分鐘內建立。
如要進一步瞭解如何建立及管理專案,請參閱「建立及管理專案」。
啟用 API
您必須啟用 Google Cloud Search API,並建立服務帳戶才能取得憑證。
- 在左側導覽區中,按一下「API 和服務」。
- 為確保您使用的是新建立的專案,請按一下 Google Cloud 控制台橫幅右側的 圖示,然後選取新建立的專案。
- 按一下「啟用 API 和服務」。畫面上會顯示「Welcome to API Library」(歡迎使用 API 程式庫) 頁面。
- 在搜尋欄位中輸入「Cloud Search API」,然後按下 return。系統會傳回 API 清單。
- 按一下「Cloud Search API」。畫面上會顯示「Cloud Search API」頁面。
- 按一下「啟用」。「總覽」頁面隨即顯示。
如要進一步瞭解如何啟用及停用 API,請參閱在 Google Cloud 控制台中管理 API。
複製教學課程存放區
如要複製範例存放區,請執行下列指令:
git clone https://github.com/googleworkspace/cloud-search-samples.git