Tutorial: Creación de una aplicación de búsqueda con Amazon OpenSearch Service

Creación del paquete de implementación

1. Abra un símbolo del sistema y cree un directorio del proyecto my-opensearch-function. Por ejemplo, en macOS:

   mkdir my-opensearch-function

2. Desplácese hasta el directorio del proyecto my-sourcecode-function.

   cd my-opensearch-function

3. Copie el contenido del siguiente código Python de ejemplo y guárdelo en un nuevo archivo denominado opensearch-lambda.py. Añada su región y el punto de conexión del host al archivo.

   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. Instale las bibliotecas externas en un nuevo directorio package.

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

5. Cree un paquete de implementación con las bibliotecas instaladas en la raíz. El siguiente comando genera un archivo my-deployment-package.zip en el directorio de su proyecto.

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

6. Agregue el archivo opensearch-lambda.py a la raíz del archivo zip.

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

1. Navegue hasta la consola de Lambda en https://console.aws.amazon.com/lambda/home. En el panel de navegación izquierdo, seleccione Funciones.

2. Seleccione Crear función.

3. Configure los siguientes campos:

   • Nombre de función: opensearch-function

   • Tiempo de ejecución: Python 3.9

   • Arquitectura: x86_64

   Mantenga todas las demás opciones predeterminadas y elija Crear función.

4. En la sección Código fuente de la página de resumen de la función, seleccione el menú desplegable Cargar desde y seleccione el archivo .zip. Busque el archivo my-deployment-package.zip que ha creado y seleccione Guardar.

5. El controlador es el método de su código de función que procesa eventos. En Configuración de tiempo de ejecución, seleccione Editar y cambie el nombre del controlador de acuerdo con el nombre del archivo en el paquete de implementación donde se encuentra la función de Lambda. Como el archivo se denomina opensearch-lambda.py, cambie el nombre del controlador a opensearch-lambda.lambda_handler. Para más información, consulte Controlador de funciones de Lambda en Python.

1. Navegue hasta la consola de API Gateway en https://console.aws.amazon.com/apigateway/home. En el panel de navegación izquierdo, seleccione APIs.

2. Localice API de REST (no privado) y elija Crear.

3. En la siguiente página, busque la sección Crear nueva API y asegúrese de que Nueva API esté seleccionada.

4. Configure los siguientes campos:

   • Nombre de la API: opensearch-api

   • Descripción: API pública para buscar un dominio de Amazon OpenSearch Service

   • Tipo de punto de conexión: Regional

5. Seleccione Crear API.

6. Seleccione Acciones y Crear método.

7. Seleccione GET (Obtener) en el menú desplegable y haga clic en la marca de verificación para confirmar.

8. Configure los siguientes ajustes y, a continuación, elija Guardar:

1. Seleccione Acciones e Implementar API.

2. Para Etapa de implementación elija Nueva etapa y nombre la etapa opensearch-api-test.

3. Seleccione Implementar.

4. Configure los siguientes ajustes en el editor de etapas y, a continuación, elija Guardar los cambios:

1. Desplácese hasta la URL de OpenSearch Dashboards para el dominio.

2. En el menú principal, seleccione Seguridad, Roles y elija el enlace a all_access, el rol al que necesita asignar el rol de Lambda.

3. Seleccione Usuarios asignados, Administrar mapeo.

4. En Roles de backend, agregue el nombre de recurso de Amazon (ARN) del rol de Lambda. El ARN debe adoptar la forma de arn:aws:iam::123456789123:role/service-role/opensearch-lambda-role-1abcdefg.

5. Seleccione Asignar y confirme que el usuario o el rol aparecen en Usuarios asignados.

Para probar la aplicación web

1. Descargue sample-site.zip, descomprímalo y abra scripts/search.js en el editor de texto de su elección.

2. Actualice la variable apigatewayendpoint para que apunte al punto de conexión de API Gateway y añada una barra oblicua al final de la ruta en cuestión. Puede encontrar rápidamente el punto de conexión en API Gateway seleccionando Etapas y seleccionando el nombre de la API. La variable apigatewayendpoint debe adoptar la forma de https://some-id.execute-api.us-west-1.amazonaws.com/opensearch-api-test/.

3. Abra index.html e intente ejecutar búsquedas de thor, house y algunos otros términos.

   

1. Habilitar CORS en el recurso GET. En Avanzado, configure Access-Control-Allow-Credentials en 'true'.

2. Vuelva a implementar su API en API Gateway (Acciones, Implementar API).

3. Elimine y vuelva a agregar el activador de la función de Lambda. Agregue volver a añadirlo, seleccione Agregar desencadenador y cree el punto de conexión HTTP que invoca su función. El desencadenador debe tener la siguiente configuración:

   Desencadenador	API	Etapa de implementación	Seguridad
   API Gateway	opensearch-api	opensearch-api-test	Abra