이 가이드에서는 간단한 Cloud Search 솔루션을 배포하는 방법을 보여주고 색인을 생성할 데이터 저장소로 GitHub를 사용합니다. 이 튜토리얼은 다음 두 가지 샘플 애플리케이션으로 구성됩니다.
- Cloud Search 커넥터 SDK로 만든 콘텐츠 커넥터로, GitHub 저장소에 있는 데이터의 색인을 생성하는 데 사용됩니다. 색인 생성된 데이터에는 문제, 풀 리퀘스트, 기본 브랜치 (
master)의 헤드 콘텐츠가 포함됩니다. - 검색 위젯을 사용하여 맞춤 검색 인터페이스를 제공하는 웹 앱입니다.
기본 요건
이 가이드에는 다음과 같은 기본 요건이 필요합니다.
- 서드 파티 데이터 색인 생성을 위한 Cloud Search가 사용 설정된 Google Workspace 또는 Cloud Identity 도메인에 대한 관리자 액세스 권한 관리 콘솔에서 설정을 볼 수 없는 경우 도메인 관리자에게 문의하거나 Cloud Search에 가입하세요.
- GitHub 사용자 계정
- Java 및 JavaScript에 익숙해야 합니다.
- Java 8 이상
- Maven
- Node.js 8.11 이상
튜토리얼 프로젝트 만들기
시작하려면 Google Cloud Platform 프로젝트를 만들어야 합니다. 이 프로젝트는 API 관리, 결제 사용 설정, 공동작업자 추가 및 삭제, 권한 관리를 포함하여 모든 Google Cloud Platform(GCP) 서비스를 만들고 사용 설정하고 사용하기 위한 기반을 형성합니다.
Google Cloud 콘솔을 엽니다.
페이지 상단에서 'Google Cloud 콘솔' 오른쪽에 있는 를 클릭합니다. 현재 프로젝트 목록을 보여주는 대화 상자가 나타납니다.
새 프로젝트를 클릭합니다. 새 프로젝트 화면이 나타납니다.
Project Name 필드에 'SearchTutorial'과 같은 프로젝트 이름을 입력합니다.
(선택사항) 수정을 클릭하여 프로젝트 ID를 편집합니다. 프로젝트가 만들어진 후에는 프로젝트 ID를 변경할 수 없으므로 프로젝트의 수명 동안 필요에 맞는 ID를 선택하세요.
프로젝트의 위치를 찾아보려면 찾아보기를 클릭합니다.
프로젝트 위치를 클릭하고 선택을 클릭합니다.
만들기를 클릭합니다. Console이 대시보드 페이지로 이동합니다. 몇 분 안에 프로젝트가 생성됩니다.
프로젝트를 만들고 관리하는 방법에 대한 자세한 내용은 프로젝트 만들기 및 관리를 참조하세요.
API 사용 설정
사용자 인증 정보를 얻으려면 Google Cloud Search API를 사용 설정하고 서비스 계정을 만들어야 합니다.
- 왼쪽 탐색에서 API 및 서비스를 클릭합니다.
- 새로 만든 프로젝트에 있으려면 Google Cloud 콘솔 배너 오른쪽에 있는 아이콘을 클릭하고 새로 만든 프로젝트를 선택합니다.
- API 및 서비스 사용 설정을 클릭합니다. '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