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, ce tutoriel se compose de deux exemples d'applications :
- Un connecteur de contenu, créé avec le
SDK Cloud Search Connector, utilisé pour indexer
les données trouvées dans les dépôts GitHub. Les données indexées incluent les problèmes, les requêtes d'extraction et le contenu principal de la branche par défaut (
master). - Une application Web qui utilise le widget de recherche pour fournir une interface de recherche personnalisée.
Prérequis
Les prérequis de ce tutoriel sont les suivants :
- Un accès administrateur à un domaine Google Workspace ou Cloud Identity avec l'indexation des données tierces Cloud Search activée. Si vous ne parvenez pas à afficher les paramètres dans le panneau de configuration de l'administrateur, contactez l'administrateur de votre domaine ou inscrivez-vous à Cloud Search.
- Un compte utilisateur GitHub.
- Une bonne connaissance de Java et de JavaScript.
- Java 8 ou une version ultérieure.
- Maven.
- Node.js 8.11 ou une version ultérieure.
Créer le projet du tutoriel
Pour commencer, vous devez créer un projet Google Cloud Platform. Ce projet constitue la base permettant de créer, d'activer et d'utiliser tous les services Google Cloud Platform (GCP), entre autres pour gérer les API, activer la facturation, ajouter ou exclure des collaborateurs et gérer les autorisations.
Ouvrez la console Google Cloud.
En haut de la page, cliquez sur à droite de "Google Cloud Console". Une boîte de dialogue répertoriant les projets en cours apparaît.
Cliquez sur NOUVEAU PROJET. L'écran "Nouveau projet" s'affiche.
Dans le champ Nom du projet, saisissez un nom de projet, par exemple "SearchTutorial".
(Facultatif) Cliquez sur Modifier pour modifier l'ID du projet. Vous ne pourrez plus modifier cet ID une fois le projet créé, donc choisissez un ID répondant à vos besoins pour toute la durée de vie du projet.
Pour parcourir les emplacements du projet, cliquez sur PARCOURIR.
Cliquez sur un emplacement pour votre projet, puis sur Sélectionner.
Cliquez sur CRÉER. La console vous redirige vers la page "Tableau de bord". Le projet est créé en quelques minutes.
Pour plus d'informations sur la création et la gestion de projets, consultez la page 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 volet de navigation de gauche, cliquez sur API et services.
- Pour vérifier que vous êtes bien dans le projet nouvellement créé, cliquez sur l' icône à droite de la bannière Google Cloud Console, 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" s'affiche.
- Saisissez "API Cloud Search" dans le champ de recherche, puis appuyez sur Entrée. Une liste d'API s'affiche.
- Cliquez sur API Cloud Search. La page "API Cloud Search" s'affiche.
- Cliquez sur ACTIVER. La page "Vue d'ensemble" apparaît.
Pour plus d'informations sur l'activation et la désactivation des API, consultez la page Gérer les API dans Google Cloud Console.
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