En este instructivo, se muestra cómo implementar una solución simple de Cloud Search y se usa GitHub como el repositorio de datos que se indexarán. Específicamente, este instructivo consta de dos aplicaciones de ejemplo:
- Un conector de contenido, creado con el SDK de Cloud Search Connector, que se usa para indexar los datos que se encuentran en los repositorios de GitHub. Los datos indexados incluyen problemas, solicitudes de extracción y el contenido principal de la rama predeterminada (
master). - Una app web que usa el widget de búsqueda para proporcionar una interfaz de búsqueda personalizada.
Requisitos previos
Para este instructivo, se requieren los siguientes requisitos previos:
- Acceso de administrador a un dominio de Google Workspace o Cloud Identity con la búsqueda de Cloud habilitada para la indexación de datos de terceros Si no puedes ver la configuración en el panel de control de administrador, comunícate con el administrador de tu dominio o regístrate en la Búsqueda de Cloud.
- Una cuenta de usuario de GitHub
- Familiaridad Java y JavaScript.
- Java 8 o una versión posterior
- Maven.
- Node.js 8.11 o una versión posterior
Crea el proyecto del instructivo
Para comenzar, debes crear un proyecto de Google Cloud Platform. Este proyecto constituye la base para crear, habilitar y usar todos los servicios de Google Cloud Platform (GCP), que incluyen administrar las API, habilitar la facturación, agregar o quitar colaboradores y administrar los permisos.
Abre Google Cloud Console
En la parte superior de la página, haz clic en a la derecha de “Google Cloud Console”. Aparecerá un diálogo en el que se enumeran los proyectos actuales.
Haz clic en PROYECTO NUEVO. Aparecerá la pantalla Proyecto nuevo.
En el campo Nombre del proyecto, ingresa un nombre de proyecto, como "SearchTutorial".
(opcional) Haz clic en Editar para editar el ID del proyecto. El ID del proyecto no se puede cambiar luego de que se crea el proyecto. Por lo tanto, elige un ID que abarque tus necesidades durante todo el ciclo de vida del proyecto.
Para explorar las ubicaciones del proyecto, haz clic en EXPLORAR.
Haz clic en una ubicación para tu proyecto y, luego, en Seleccionar.
Haz clic en CREAR. La consola navega a la página Panel. El proyecto se crea en unos minutos.
Para obtener más información sobre crear y administrar proyectos, consulta Cómo crear y administrar proyectos.
Habilita la API
Debes habilitar la API de Google Cloud Search y crear una cuenta de servicio para obtener las credenciales.
- En el panel de navegación izquierdo, haz clic en APIs y servicios.
- Para asegurarte de que estás en el proyecto recién creado, haz clic en el ícono a la derecha del banner de la consola de Google Cloud y selecciona el proyecto que acabas de crear.
- Haz clic en HABILITAR API Y SERVICIOS. Aparece la página “Te damos la bienvenida a la Biblioteca de APIs”.
- Escribe "API de Cloud Search" en el campo de búsqueda y presiona return. Se muestra una lista de APIs.
- Haz clic en API de Cloud Search. Aparecerá la página "API de Cloud Search".
- Haz clic en HABILITAR. Aparecerá la página Descripción general.
Para obtener más información sobre inhabilitar y habilitar las APIs, consulta Administra las APIs en la consola de Google Cloud.
Clona el repositorio del instructivo
Para clonar el repositorio de muestra, ejecuta el siguiente comando:
git clone https://github.com/googleworkspace/cloud-search-samples.git