Tutoriel de mise en route de Google Cloud Search

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 comprend deux exemples d'application:

  • Un connecteur de contenu, créé avec le SDK Cloud Search Connector, permet d'indexer les données trouvées 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).
  • Application Web qui utilise le widget Recherche pour fournir une interface de recherche personnalisée

Conditions préalables

Ce tutoriel nécessite les conditions préalables suivantes:

  • Accès administrateur à un domaine Google Workspace ou Cloud Identity avec Cloud Search pour l'indexation de données tierces activé. Si vous ne parvenez pas à afficher les paramètres dans le panneau de configuration de l'administrateur, contactez votre administrateur de domaine ou inscrivez-vous à Cloud Search.
  • Un compte utilisateur GitHub.
  • Connaissance de Java et 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 pour la création, l'activation et l'utilisation de tous les services Google Cloud Platform (GCP), y compris la gestion des API, l'activation de la facturation, l'ajout et la suppression de collaborateurs et la gestion des autorisations.

  1. Ouvrez Google Cloud Console.

  2. En haut de la page, cliquez sur à droite de "Console Google Cloud". Une boîte de dialogue listant les projets en cours s'affiche.

  3. Cliquez sur NOUVEAU PROJET. L'écran "Nouveau projet" s'affiche.

  4. Dans le champ Project Name (Nom du projet), saisissez un nom de projet, par exemple "SearchTutorial".

  5. (Facultatif) Cliquez sur Modifier pour modifier l'ID du projet. Une fois le projet créé, l'ID du projet ne peut plus être modifié. Par conséquent, choisissez un ID qui répond à vos besoins tout au long de la durée de vie du projet.

  6. Pour parcourir les emplacements du projet, cliquez sur PARCOURIR.

  7. Cliquez sur l'emplacement de votre projet, puis sur Sélectionner.

  8. Cliquez sur CRÉER. La console accède à la page "Tableau de bord". Le projet est créé en quelques minutes.

Pour en savoir plus 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.

  1. Dans le volet de navigation de gauche, cliquez sur API et services.
  2. Pour vous assurer que vous êtes bien dans le projet que vous venez de créer, cliquez sur l'icône à droite de la bannière de la console Google Cloud, puis sélectionnez le projet que vous venez de créer.
  3. Cliquez sur ACTIVER DES API ET DES SERVICES. La page "Bienvenue dans la bibliothèque d'API" s'affiche.
  4. Saisissez "API Cloud Search" dans le champ de recherche, puis appuyez sur return. Une liste d'API est renvoyée.
  5. Cliquez sur API Cloud Search. La page "API Cloud Search" s'affiche.
  6. 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 la page 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

Suivant