Tutorial: Eine Suchanwendung mit Amazon OpenSearch Service erstellen

Erstellen des Bereitstellungspakets

1. Öffnen Sie eine Eingabeaufforderung und erstellen Sie ein my-opensearch-function-Projektverzeichnis. Zum Beispiel unter macOS:

   mkdir my-opensearch-function

2. Navigieren Sie zum my-sourcecode-function-Projektverzeichnis.

   cd my-opensearch-function

3. Kopieren Sie den Inhalt des folgenden Python-Beispielcodes und speichern Sie ihn in einer neuen Datei mit dem Namenopensearch-lambda.py. Fügen Sie der Datei Ihre Region und Ihren Host-Endpunkt hinzu.

   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. Installieren Sie die externen Bibliotheken in einem neuen package Verzeichnis.

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

5. Erstellen Sie ein Bereitstellungspaket, an dessen Stamm die installierte Bibliothek angefügt ist. Der folgende Befehl generiert eine my-deployment-package.zip Datei in Ihrem Projektverzeichnis.

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

6. Fügen Sie die opensearch-lambda.py-Datei dem Stamm der ZIP-Datei hinzu.

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

1. Navigieren Sie zur Lambda-Konsole unter https://console.aws.amazon.com/lambda/home. Wählen Sie im linken Navigationsbereich Funktionen aus.

2. Wählen Sie Funktion erstellen aus.

3. Konfigurieren Sie die folgenden Felder:

   • Funktionsname: opensearch-function

   • Laufzeit: Python 3.9

   • Architektur: x86_64

   Behalten Sie alle anderen Standardoptionen bei und wählen Sie Funktion erstellen.

4. Wählen Sie auf der Seite mit der Funktionsübersicht im Abschnitt „Codequelle“ die Dropdownliste „Von hochladen“ und wählen Sie „.zip-Datei“ aus. Suchen Sie die my-deployment-package.zip Datei, die Sie erstellt haben, und wählen Sie Speichern aus.

5. Der Handler ist die Methode in Ihrem Funktions-Code, die Ereignisse verarbeitet. Wählen Sie unter Runtime-Einstellungen die Option Bearbeiten und ändern Sie den Namen des Handlers entsprechend dem Namen der Datei in Ihrem Bereitstellungspaket, in der sich die Lambda-Funktion befindet. Da Ihre Datei benannt istopensearch-lambda.py, benennen Sie den Handler in umopensearch-lambda.lambda_handler. Weitere Informationen finden Sie unter Lambda-Funktions-Handler in Python.

1. Navigieren Sie zur API Gateway Gateway-Konsole unter https://console.aws.amazon.com/apigateway/home. Wählen Sie im linken Navigationsbereich APIs aus.

2. Suchen Sie die REST-API (nicht privat) und wählen Sie Build aus.

3. Suchen Sie auf der folgenden Seite nach dem Abschnitt Neue API erstellen und stellen Sie sicher, dass Neue API ausgewählt ist.

4. Konfigurieren Sie die folgenden Felder:

   • API-Name: opensearch-api

   • Beschreibung: Öffentliche API für die Suche nach einer Amazon OpenSearch Service-Domain

   • Endpunkttyp: Regional

5. Wählen Sie Create API (API erstellen) aus.

6. Wählen Sie Aktionen und Methode erstellen aus.

7. Wählen Sie im Dropdown-Menü GET aus und klicken Sie zur Bestätigung auf das Häkchen.

8. Konfigurieren Sie die folgenden Einstellungen und wählen Sie dann Speichern:

1. Wählen Sie Aktionen und Bereitstellen der API aus.

2. Für Bereitstellungsstufe, wählen Sie Neue Stufe und nennen Sie die Stufe opensearch-api-test.

3. Wählen Sie Bereitstellen aus.

4. Konfigurieren Sie die folgenden Einstellungen im Stufen-Editor und wählen Sie dann Änderungen speichern:

1. Navigieren Sie zur OpenSearch Dashboard-URL für die Domain.

2. Wählen Sie im Hauptmenü Sicherheit, Rollen und dann den Link zu der Rolle ausall_access, der Sie die Lambda-Rolle zuordnen müssen.

3. Wählen Sie Zugeordnete Benutzer, Mapping verwalten.

4. Fügen Sie unter Backend roles (Backend-Rollen) den Amazon-Ressourcennamen (ARN) der Lambda-Rolle hinzu. Der ARN sollte die Form von habenarn:aws:iam::123456789123:role/service-role/opensearch-lambda-role-1abcdefg.

5. Wählen Sie Zuordnen und bestätigen Sie, dass der Benutzer oder die Rolle unter Zugeordnete Benutzer angezeigt wird.

So testen Sie die Webanwendung

1. Laden Sie sample-site.zip herunter, dekomprimieren Sie sie und öffnen Sie scripts/search.js in Ihrem bevorzugten Texteditor.

2. Aktualisieren Sie die apigatewayendpoint Variable so, dass sie auf Ihren API-Gateway-Endpunkt zeigt, und fügen Sie am Ende des angegebenen Pfads einen Backslash hinzu. Sie können den Endpunkt schnell im API Gateway finden, indem Sie Phasen und den Namen der API auswählen. Die apigatewayendpoint Variable sollte die Form von/haben. https://some-id.execute-api.us-west-1.amazonaws.com/opensearch-api-test

3. Öffnen Sie index.html und versuchen Sie, nach thor, house und einigen anderen Begriffen zu suchen.

   

1. Aktivieren Sie CORS in der GET-Ressource. Unter Advanced legen Sie Access-Control-Allow-Credentials auf 'true' fest.

2. Stellen Sie Ihre API erneut in API Gateway (Aktionen,API bereitstellen) bereit.

3. Löschen Sie Ihren Lambda-Funktionsauslöser und fügen Sie ihn erneut hinzu. Fügen Sie sie hinzu, fügen Sie sie erneut hinzu, wählen Sie Auslöser hinzufügen und erstellen Sie den HTTP-Endpunkt, der Ihre Funktion aufruft. Der Auslöser muss die folgende Konfiguration haben:

   Auslöser	API	Bereitstellungsstufe	Sicherheit
   API Gateway	opensearch-api	opensearch-api-test	Öffnen