이 튜토리얼에서는 간단한 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 콘솔' 오른쪽에 있는 아이콘을 클릭합니다. 현재 프로젝트 목록을 보여주는 대화 상자가 나타납니다.
새 프로젝트를 클릭합니다. 새 프로젝트 화면이 나타납니다.
프로젝트 이름 필드에 프로젝트 이름(예: '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