Tutorial: creazione di un'applicazione di ricerca con Amazon OpenSearch Service

Per creare il pacchetto di implementazione

1. Apri un prompt dei comandi e crea una directory di progetto my-opensearch-function. Ad esempio, su macOS:

   mkdir my-opensearch-function

2. Passa alla directory del progetto my-sourcecode-function.

   cd my-opensearch-function

3. Copia il contenuto del seguente codice Python di esempio e salvalo in un nuovo file denominato. opensearch-lambda.py Aggiungi la tua regione e l'endpoint host al file.

   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. Installa le librerie esterne in una nuova package directory.

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

5. Crea un pacchetto di implementazione con le librerie installate nella directory principale. Il comando seguente genera un my-deployment-package.zip file nella directory del progetto.

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

6. Aggiungi il file opensearch-lambda.py alla radice del file .zip.

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

1. Accedi alla console Lambda all'indirizzo https://console.aws.amazon.com/lambda/home. Nel riquadro di navigazione a sinistra, scegli Funzioni.

2. Seleziona Crea funzione.

3. Configura i campi seguenti:

   • Nome della funzione: opensearch-function

   • Runtime: Python 3.9

   • Architettura: x86_64

   Mantieni tutte le altre opzioni predefinite e scegli Crea funzione.

4. Nella sezione Codice sorgente della pagina di riepilogo della funzione, scegli il menu a discesa Carica da e seleziona il file.zip. Individua il my-deployment-package.zip file che hai creato e scegli Salva.

5. Il gestore è il metodo nel codice della funzione che elabora gli eventi. In Impostazioni di runtime, scegli Modifica e modifica il nome del gestore in base al nome del file nel pacchetto di distribuzione in cui si trova la funzione Lambda. Poiché il file ha un nomeopensearch-lambda.py, rinomina il gestore in. opensearch-lambda.lambda_handler Per ulteriori informazioni, consulta Gestore della funzione Lambda in Python.

1. Accedi alla console API Gateway all'indirizzo https://console.aws.amazon.com/apigateway/home. Nel riquadro di navigazione a sinistra, scegli API.

2. Individuare REST API (non privato) e scegliere Crea.

3. Nella pagina seguente, individua la sezione Crea nuova API e assicurati che sia selezionata Nuova API.

4. Configura i campi seguenti:

   • Nome API: opensearch-api

   • Descrizione: API pubblica per la ricerca di un dominio Amazon OpenSearch Service

   • Tipo di endpoint: regionale

5. Seleziona Create API (Crea API).

6. Scegliere Operazioni quindi Crea metodo.

7. Selezionare GET nel menu a discesa e fare clic sul segno di spunta per confermare.

8. Configurare le impostazioni seguenti, quindi scegliere Salva:

1. Scegliere Operazioni e Implementa API.

2. Per Fase di implementazione, scegliere Nuova fase e nominare la fase opensearch-api-test.

3. Seleziona Deploy (Implementa).

4. Configurare le seguenti impostazioni nell'editor della fase, quindi scegliere Salva modifiche:

1. Vai all'URL delle OpenSearch dashboard per il dominio.

2. Dal menu principale, scegli Sicurezza, Ruoli e seleziona il link al all_access ruolo a cui devi mappare il ruolo Lambda.

3. Scegliere Utenti mappati, Gestisci mappatura.

4. In Backend roles (Ruoli di backend), aggiungi il nome della risorsa Amazon (ARN) del ruolo Lambda. L'ARN dovrebbe assumere la forma di. arn:aws:iam::123456789123:role/service-role/opensearch-lambda-role-1abcdefg

5. Selezionare Mappa e confermare che l'utente o il ruolo venga visualizzato in Utenti mappati.

Per testare l'applicazione Web

1. Scaricare sample-site.zip, decomprimerlo e aprire scripts/search.js nell'editor di testo preferito.

2. Aggiorna la apigatewayendpoint variabile in modo che punti all'endpoint API Gateway e aggiungi una barra rovesciata alla fine del percorso specificato. Puoi trovare rapidamente l'endpoint in API Gateway scegliendo Stages (Fasi) e selezionando il nome dell'API. La apigatewayendpoint variabile deve assumere la forma di /. https://some-id.execute-api.us-west-1.amazonaws.com/opensearch-api-test

3. Aprire index.html e provare a eseguire la ricerca di thor, house e qualche altro termine.

   

1. Abilita CORS sulla risorsa GET. In Advanced (Avanzati), imposta Access-Control-Allow-Credentials a 'true'.

2. Ridistribuisci la tua API in API Gateway (Actions (Operazioni),Deploy API (Distribuzione dell'API)).

3. Elimina e aggiungi nuovamente la tua attivazione della funzione Lambda. Aggiungila nuovamente, scegli Aggiungi trigger e crea l'endpoint HTTP che richiama la tua funzione. Il trigger deve avere la seguente configurazione:

   Trigger	API	Fase della distribuzione	Sicurezza
   API Gateway	opensearch-api	opensearch-api-test	Aperta