Ce tutoriel explique comment déployer une solution Cloud Search simple et utilise GitHub comme dépôt de données à indexer. Plus précisément, comporte deux exemples d'applications:
- Un connecteur de contenu, créé avec le
SDK Cloud Search Connector, utilisé pour indexer
dans les dépôts GitHub. Les données indexées incluent les problèmes, les demandes d'extraction,
et le contenu principal de la branche par défaut (
master). - Une application Web qui utilise la widget Recherche pour fournir une interface de recherche personnalisée.
Prérequis
Pour suivre ce tutoriel, vous devez remplir les conditions préalables suivantes:
- un accès administrateur à un domaine Google Workspace ou Cloud Identity avec Cloud Search pour l'indexation des données tierces activé. Si vous ne parvenez pas à afficher dans le panneau de configuration de l'administrateur, contactez l'administrateur de votre domaine ou inscrivez-vous à Cloud Search.
- Un compte utilisateur GitHub.
- Connaissances de base sur Java et JavaScript
- Java 8 ou version ultérieure
- Maven
- Node.js 8.11 ou version ultérieure
Créer le projet du tutoriel
Pour commencer, vous devez créer un projet Google Cloud Platform. Ce permet de créer, d'activer et d'utiliser toutes les ressources les services de la plate-forme GCP, y compris la gestion des API, l'activation de la facturation, l'ajout et supprimer des collaborateurs et gérer les autorisations.
Ouvrez Google Cloud Console.
En haut de la page, cliquez sur à droite de "Console Google Cloud". Boîte de dialogue répertoriant les projets en cours s'affiche.
Cliquez sur NOUVEAU PROJET. L'écran "New Project" (Nouveau projet) s'affiche.
Dans le champ Nom du projet, saisissez un nom de projet, tel que « SearchTutorial ».
(Facultatif) Cliquez sur Modifier pour modifier l'ID du projet. L'ID du projet ne peut pas être modifiées après la création du projet. Par conséquent, choisissez ID qui répond à vos besoins pour toute la durée de vie du projet.
Pour parcourir les emplacements associés au projet, cliquez sur PARCOURIR.
Cliquez sur un emplacement pour votre projet, puis sur Sélectionner.
Cliquez sur CRÉER. La console permet d'accéder à la page "Tableau de bord". Le projet est créée en quelques minutes.
Pour en savoir plus sur la création et la gestion de projets, consultez Créer et gérer des projets
Activer l'API
Vous devez activer l'API Google Cloud Search et créer un compte de service pour : obtenir des identifiants.
- Dans le panneau de navigation de gauche, cliquez sur API et Services.
- Pour vérifier que vous êtes bien dans le projet que vous venez de créer, cliquez sur L'icône à droite de Bannière de la console Google Cloud, puis sélectionnez le projet que vous venez de créer.
- Cliquez sur ACTIVER DES API ET DES SERVICES. La page "Bienvenue dans la bibliothèque d'API" page s'affiche.
- Saisissez "API Cloud Search" dans le champ de recherche, puis appuyez sur Entrée. Une liste d'API est renvoyé.
- Cliquez sur API Cloud Search. L'API Cloud Search s'affiche.
- Cliquez sur ENABLE (ACTIVER). La page "Vue d'ensemble" s'affiche.
Pour en savoir plus sur l'activation et la désactivation des API, consultez Gérer les API dans la console Google Cloud
Cloner le dépôt du tutoriel
Pour cloner l'exemple de dépôt, exécutez la commande suivante:
git clone https://github.com/googleworkspace/cloud-search-samples.git