Este tutorial mostra como implantar uma solução simples da Cloud Search e usa o GitHub como o repositório de dados a serem indexados. Especificamente, este tutorial consiste em dois aplicativos de exemplo:
- Um conector de conteúdo criado com o
SDK do Cloud Search Connector, usado para indexar
dados encontrados em repositórios do GitHub. Os dados indexados incluem problemas, solicitações de mesclagem
e o conteúdo principal da ramificação padrão (
master). - Um app da Web que usa o widget de pesquisa para fornecer uma interface de pesquisa personalizada.
Pré-requisitos
Este tutorial requer os seguintes pré-requisitos:
- Acesso de administrador a um domínio do Google Workspace ou do Cloud Identity com a indexação de dados de terceiros do Cloud Search ativada. Se não for possível visualizar as configurações no painel de controle do administrador, entre em contato com o administrador do domínio ou faça a inscrição no Cloud Search.
- Uma conta de usuário do GitHub.
- Familiaridade com Java e JavaScript.
- Java 8 ou mais recente.
- Maven.
- Node.js 8.11 ou mais recente.
Criar o projeto do tutorial
Para começar, crie um projeto do Google Cloud Platform. Esse projeto é a base para criar, ativar e usar todos os serviços do Google Cloud Platform (GCP), incluindo gerenciamento de APIs, habilitação de faturamento, adição e remoção de colaboradores e gerenciamento de permissões.
Abra o Console do Google Cloud.
Na parte de cima da página, clique em à direita de "Console do Google Cloud". Será exibida uma caixa de diálogo que lista os projetos atuais.
Clique em NOVO PROJETO. A tela "Novo projeto" será exibida.
No campo Project Name, digite um nome de projeto, como "SearchTutorial".
(opcional) Clique em Editar para editar o código do projeto. O código do projeto não pode ser alterado após a criação do projeto, portanto, escolha um código que atenda às suas necessidades durante a vida útil do projeto.
Para procurar locais para o projeto, clique em PROCURAR.
Clique em um local para o projeto e em Selecionar.
Clique em CRIAR. O Console acessa a página "Painel". O projeto é criado em poucos minutos.
Para mais informações sobre como criar e gerenciar projetos, consulte Como criar e gerenciar projetos.
Ativar a API
É necessário ativar a API Google Cloud Search e criar uma conta de serviço para conseguir as credenciais.
- No painel de navegação à esquerda, clique em APIs e serviços.
- Para garantir que você esteja no projeto mais recente, clique no ícone à direita do banner do console do Google Cloud e selecione o projeto recém-criado.
- Clique em ATIVAR APIS E SERVIÇOS. A página "Olá! Esta é a Biblioteca de APIs" aparece.
- Digite "API Cloud Search" no campo de pesquisa e pressione return. Uma lista de APIs é retornada.
- Clique em API Cloud Search. A página "API Cloud Search" vai aparecer.
- Clique em ATIVAR. A página "Visão geral" será exibida.
Para mais informações sobre como ativar e desativar APIs, consulte Gerenciar APIs no console do Google Cloud.
Clonar o repositório do tutorial
Para clonar o repositório de exemplo, execute o seguinte comando:
git clone https://github.com/googleworkspace/cloud-search-samples.git