Hướng dẫn này cho biết cách triển khai một giải pháp Cloud Search đơn giản và sử dụng GitHub làm kho lưu trữ dữ liệu cần được lập chỉ mục. Cụ thể, hướng dẫn này bao gồm hai ứng dụng mẫu:
- Một trình kết nối nội dung (được tạo bằng Cloud Search Connector SDK) dùng để lập chỉ mục dữ liệu có trong kho lưu trữ GitHub. Dữ liệu được lập chỉ mục bao gồm các vấn đề, yêu cầu kéo và nội dung đầu của nhánh mặc định (
master). - Một ứng dụng web sử dụng tiện ích tìm kiếm để cung cấp giao diện tìm kiếm tuỳ chỉnh.
Điều kiện tiên quyết
Hướng dẫn này yêu cầu các điều kiện tiên quyết sau:
- Quyền quản trị đối với miền Google Workspace hoặc Cloud Identity đã bật tính năng Lập chỉ mục dữ liệu của bên thứ ba trong Cloud Search. Nếu bạn không thể xem các chế độ cài đặt trong Bảng điều khiển dành cho quản trị viên, hãy liên hệ với quản trị viên miền của bạn hoặc đăng ký sử dụng Cloud Search.
- Tài khoản người dùng GitHub.
- Quen thuộc với Java và JavaScript.
- Java 8 trở lên.
- Maven.
- Node.js 8.11 trở lên.
Tạo dự án hướng dẫn
Để bắt đầu, bạn phải tạo một dự án trên Google Cloud Platform. Dự án này là cơ sở để tạo, bật và sử dụng tất cả các dịch vụ của Google Cloud Platform (GCP), bao gồm cả việc quản lý API, bật tính năng thanh toán, thêm và xoá cộng tác viên cũng như quản lý quyền.
Ở đầu trang, hãy nhấp vào biểu tượng ở bên phải "Google Cloud Console". Một hộp thoại liệt kê các dự án hiện tại sẽ xuất hiện.
Nhấp vào NEW PROJECT (DỰ ÁN MỚI). Màn hình New Project (Dự án mới) sẽ xuất hiện.
Trong trường Project Name (Tên dự án), hãy nhập tên dự án, chẳng hạn như "SearchTutorial".
(không bắt buộc) Nhấp vào Chỉnh sửa để chỉnh sửa Mã dự án. Bạn không thể thay đổi mã dự án sau khi tạo dự án, vì vậy, hãy chọn một mã đáp ứng nhu cầu của bạn trong suốt thời gian hoạt động của dự án.
Để duyệt qua các vị trí cho dự án, hãy nhấp vào DUYỆT TRA.
Nhấp vào một vị trí cho dự án của bạn rồi nhấp vào Chọn.
Nhấp vào TẠO. Bảng điều khiển sẽ chuyển đến trang Tổng quan. Dự án sẽ được tạo trong vòng vài phút.
Để biết thêm thông tin về cách tạo và quản lý dự án, hãy tham khảo bài viết Tạo và quản lý dự án.
Bật API
Bạn cần bật API Google Cloud Search và tạo một tài khoản dịch vụ để lấy thông tin xác thực.
- Trong bảng điều hướng bên trái, hãy nhấp vào API và dịch vụ.
- Để đảm bảo bạn đang ở dự án mới tạo, hãy nhấp vào biểu tượng ở bên phải biểu ngữ Bảng điều khiển Google Cloud rồi chọn dự án mới tạo.
- Nhấp vào BẬT API VÀ DỊCH VỤ. Trang "Chào mừng bạn đến với Thư viện API" sẽ xuất hiện.
- Nhập "Cloud Search API" vào trường tìm kiếm rồi nhấn phím return. Danh sách API được trả về.
- Chọn Cloud Search API. Trang "Cloud Search API" sẽ xuất hiện.
- Nhấp vào BẬT. Trang Tổng quan sẽ xuất hiện.
Để biết thêm thông tin về cách bật và tắt API, hãy tham khảo bài viết Quản lý API trong Google Cloud Console
Sao chép kho lưu trữ hướng dẫn
Để sao chép kho lưu trữ mẫu, hãy chạy lệnh sau:
git clone https://github.com/googleworkspace/cloud-search-samples.git