本教學課程說明如何部署簡單的 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」(新專案)。畫面上會顯示「New Project」畫面。
在「Project Name」欄位中輸入專案名稱,例如「SearchTutorial」。
(選用) 按一下「編輯」即可編輯專案 ID。專案建立後就無法變更專案 ID,因此請選用符合您在整個專案執行期間需求的 ID。
如要瀏覽專案的位置,請按一下「瀏覽」。
按一下專案位置,然後按一下「選取」。
按一下「建立」。控制台會前往「資訊主頁」頁面。專案會在幾分鐘內建立完成。
如要進一步瞭解如何建立及管理專案,請參閱「建立及管理專案」。
啟用 API
您必須啟用 Google Cloud Search API 並建立服務帳戶,才能取得憑證。
- 在左側導覽列中,按一下「API 和服務」。
- 如要確認您位於新建立的專案中,請按一下 Google Cloud 控制台橫幅右側的 圖示,然後選取新建立的專案。
- 按一下「啟用 API 和服務」。系統會顯示「歡迎使用 API 程式庫」頁面。
- 在搜尋欄位中輸入「Cloud Search API」,然後按下 Enter 鍵。系統會傳回 API 清單。
- 按一下「Cloud Search API」。畫面上會顯示「Cloud Search API」頁面。
- 按一下「啟用」。系統隨即會顯示「總覽」頁面。
如要進一步瞭解如何啟用及停用 API,請參閱「在 Google Cloud 控制台中管理 API」。
複製教學課程存放區
如要複製範例存放區,請執行下列指令:
git clone https://github.com/googleworkspace/cloud-search-samples.git