Tutoriel : Création d'une application de recherche avec Amazon OpenSearch Service

Pour créer le package de déploiement

1. Ouvrez une invite de commandes et créez un répertoire de projet my-opensearch-function. Par exemple, sur macOS :

   mkdir my-opensearch-function

2. Accédez au répertoire du projet my-sourcecode-function.

   cd my-opensearch-function

3. Copiez le contenu de l'exemple de code Python suivant et enregistrez-le dans un nouveau fichier nomméopensearch-lambda.py. Ajoutez votre région et votre point de terminaison hôte au fichier.

   import boto3
   import json
   import requests
   from requests_aws4auth import AWS4Auth
   
   region = '' # For example, us-west-1
   service = 'es'
   credentials = boto3.Session().get_credentials()
   awsauth = AWS4Auth(credentials.access_key, credentials.secret_key, region, service, session_token=credentials.token)
   
   host = '' # The OpenSearch domain endpoint with https:// and without a trailing slash
   index = 'movies'
   url = host + '/' + index + '/_search'
   
   # Lambda execution starts here
   def lambda_handler(event, context):
   
       # Put the user query into the query DSL for more accurate search results.
       # Note that certain fields are boosted (^).
       query = {
           "size": 25,
           "query": {
               "multi_match": {
                   "query": event['queryStringParameters']['q'],
                   "fields": ["title^4", "plot^2", "actors", "directors"]
               }
           }
       }
   
       # Elasticsearch 6.x requires an explicit Content-Type header
       headers = { "Content-Type": "application/json" }
   
       # Make the signed HTTP request
       r = requests.get(url, auth=awsauth, headers=headers, data=json.dumps(query))
   
       # Create the response and add some extra content to support CORS
       response = {
           "statusCode": 200,
           "headers": {
               "Access-Control-Allow-Origin": '*'
           },
           "isBase64Encoded": False
       }
   
       # Add the search results to the response
       response['body'] = r.text
       return response

4. Installez les bibliothèques externes dans un nouveau package répertoire.

   pip3 install --target ./package boto3
   pip3 install --target ./package requests
   pip3 install --target ./package requests_aws4auth

5. Créez un package de déploiement avec la bibliothèque installée à la racine. La commande suivante génère un my-deployment-package.zip fichier dans le répertoire de votre projet.

   cd package
   zip -r ../my-deployment-package.zip .

6. Ajoutez le fichier opensearch-lambda.py à la racine du fichier .zip.

   cd ..
   zip my-deployment-package.zip opensearch-lambda.py

1. Accédez à la console Lambda à l'adresse https://console.aws.amazon.com/lambda/home. Dans le volet de navigation de gauche, sélectionnez Functions.

2. Sélectionnez Create function (Créer une fonction).

3. Configurez les champs suivants :

   • Nom de la fonction : opensearch-function

   • Temps d'exécution : Python 3.9

   • Architecture : x86_64

   Conservez toutes les autres options par défaut et choisissez Créer une fonction.

4. Dans la section Source du code de la page de résumé des fonctions, choisissez le menu déroulant Télécharger depuis et sélectionnez le fichier .zip. Localisez le my-deployment-package.zip fichier que vous avez créé et choisissez Enregistrer.

5. Le gestionnaire est la méthode de votre code de fonction qui traite les événements. Sous Paramètres d'exécution, choisissez Modifier et modifiez le nom du gestionnaire en fonction du nom du fichier dans votre package de déploiement où se trouve la fonction Lambda. Puisque votre fichier est nomméopensearch-lambda.py, renommez le gestionnaire en. opensearch-lambda.lambda_handler Pour plus d'informations, consultez Gestionnaire de fonctions Lambda dans Python.

1. Accédez à la console API Gateway à l'adresse https://console.aws.amazon.com/apigateway/home. Dans le volet de navigation de gauche, choisissez APIs.

2. Recherchez API REST (non privée) et choisissez Créer.

3. Sur la page suivante, recherchez la section Créer une nouvelle API et assurez-vous que l'option Nouvelle API est sélectionnée.

4. Configurez les champs suivants :

   • Nom d'API :opensearch-api

   • Description : API publique pour rechercher un domaine Amazon OpenSearch Service

   • Type de point de terminaison : régional

5. Sélectionnez Create API (Créer une API).

6. Choisissez Actions (Actions) et Create Method (Créer une méthode).

7. Choisissez GET dans la liste déroulante et cliquez sur la coche pour confirmer.

8. Configurez les paramètres suivants, puis cliquez sur Save (Enregistrer) :

1. Choisissez Actions (Actions) et Deploy API (Déployer l'API).

2. Pour Étape de déploiement, choisissez Nouvelle étape et nommez l'étape opensearch-api-test.

3. Choisissez Deploy (Déployer).

4. Configurez les paramètres suivants dans l'éditeur d'étape, puis choisissez Enregistrer les modifications :

1. Accédez à l'URL OpenSearch des tableaux de bord du domaine.

2. Dans le menu principal, choisissez Sécurité, Rôles, puis sélectionnez le lien vers all_access le rôle auquel vous devez associer le rôle Lambda.

3. Choisissez Mapped users (Utilisateurs mappés), Manage mapping (Gérer le mappage).

4. Sous Backend roles (Rôles backend), ajoutez l'Amazon Resource Name (ARN) du rôle Lambda. L'ARN doit prendre la forme dearn:aws:iam::123456789123:role/service-role/opensearch-lambda-role-1abcdefg.

5. Sélectionnez Mapper et vérifiez que l'utilisateur ou le rôle s'affiche sous Utilisateurs mappés.

Pour tester l'application web

1. Téléchargez sample-site.zip, décompressez-le et ouvrez scripts/search.js dans votre éditeur de texte favori.

2. Mettez à jour la apigatewayendpoint variable pour qu'elle pointe vers votre point de terminaison API Gateway et ajoutez une barre oblique inverse à la fin du chemin indiqué. Vous pouvez rapidement trouver le point de terminaison dans API Gateway en choisissant Stages (Étapes) et en sélectionnant le nom de l'API. La apigatewayendpoint variable doit prendre la forme https://some-id.execute-api.us-west-1.amazonaws.com/opensearch-api-test /.

3. Ouvrez index.html et essayez d'effectuer des recherches pour thor, house et d'autres termes.

   

1. Activez CORS sur la ressource GET. Sous Advanced (Avancé), configurez Access-Control-Allow-Credentials comme 'true'.

2. Redéployez votre API dans API Gateway (Actions, Deploy API) (Actions, Déploiement de l'API).

3. Supprimez et ajoutez à nouveau votre déclencheur de fonction Lambda. Ajoutez-le à nouveau, choisissez Ajouter un déclencheur et créez le point de terminaison HTTP qui invoque votre fonction. Le déclencheur doit présenter la configuration suivante :

   Déclencheur	API	Étape de déploiement	Sécurité
   API Gateway	opensearch-api	opensearch-api-test	Ouvrir