Neste tutorial, mostramos como implantar uma solução simples do Cloud Search e usa o GitHub como o repositório de dados a serem indexados. Especificamente, este tutorial consiste em dois exemplos de aplicativos:
- Um conector de conteúdo, criado com o SDK do conector do Cloud Search, usado para indexar dados encontrados em repositórios do GitHub. Os dados indexados incluem problemas, solicitações de envio
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 o Cloud Search para indexação de dados de terceiros ativada. Se você não conseguir visualizar as configurações no painel de controle do administrador, entre em contato com seu administrador de domínio ou inscreva-se no Cloud Search.
- Uma conta de usuário do GitHub.
- Conhecimento sobre Java e JavaScript
- Java 8 ou uma versão mais recente
- Maven
- Node.js 8.11 ou mais recente
Criar o projeto de 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 superior 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 "New Project" (Novo projeto) é exibida.
No campo Nome do projeto, insira um nome de projeto, como "SearchTutorial".
(Opcional) Clique em Edit para editar o ID do projeto. O ID do projeto não pode ser alterado após a criação do projeto. Portanto, escolha um ID que atenda às suas necessidades durante a vida útil do projeto.
Para procurar locais para o projeto, clique em BROWSE.
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
Você precisa ativar a API Google Cloud Search e criar uma conta de serviço para receber credenciais.
- Na navegação à esquerda, clique em APIs e serviços.
- Para garantir que você esteja no projeto recém-criado, 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 "Conheça a biblioteca de APIs" vai aparecer.
- 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" será exibida.
- 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 amostra, execute o seguinte comando:
git clone https://github.com/googleworkspace/cloud-search-samples.git