Tutorial: criação de uma aplicação de pesquisa com o Amazon OpenSearch Service

Para criar o pacote de implantação

1. Abra um prompt de comando e crie um diretório de projeto do my-opensearch-function. Por exemplo, no macOS:

   mkdir my-opensearch-function

2. Navegue até o diretório de projeto do my-sourcecode-function.

   cd my-opensearch-function

3. Copie o conteúdo do seguinte código Python de exemplo e salve-o em um novo arquivo chamado opensearch-lambda.py. Adicione sua região e o endpoint do host ao arquivo.

   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 a biblioteca externa em um novo diretório de package.

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

5. Crie um pacote de implantação com a biblioteca instalada na raiz. O seguinte comando gera um arquivo my-deployment-package.zip no diretório do projeto.

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

6. Adicione o arquivo opensearch-lambda.py à raiz do arquivo zip.

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

1. Navegue até o console do Lambda em https://console.aws.amazon.com/lambda/home. No painel de navegação à esquerda, escolha Funções.

2. Selecione Criar função.

3. Configure os campos a seguir.

   • Nome da função: opensearch-function

   • Runtime: Python 3.9

   • Arquitetura: x86_64

   Mantenha todas as outras opções padrão e escolha Criar função.

4. Na seção Fonte do código da página de resumo da função, escolha Carregar no menu suspenso e selecione .zip. file. Localize o arquivo my-deployment-package.zip que você criou e escolha Salvar.

5. O manipulador é o método no código da sua função que processa eventos. Em Configurações do Runtime, escolha Editar e altere o nome do manipulador de acordo com o nome do arquivo no pacote de implantação onde a função do Lambda está localizada Como seu arquivo se chama opensearch-lambda.py, renomeie o manipulador para opensearch-lambda.lambda_handler. Para obter mais informações, consulte Manipulador de função do Lambda em Python.

1. Navegue até o console do Gateway da API em https://console.aws.amazon.com/apigateway/home. No painel de navegação à esquerda, escolha APIs.

2. Localize a API REST (não privada) e escolha Compilar.

3. Na página seguinte, localize a seção Criar nova API e verifique se a opção Nova API está selecionada.

4. Configure os campos a seguir.

   • Nome da API: opensearch-api

   • Descrição: API pública para pesquisar um domínio do Amazon OpenSearch Service

   • Tipo do endpoint: Regional

5. Selecione Criar API.

6. Escolha Ações e Criar método.

7. Select GET no menu suspenso e clique na marca de seleção para confirmar.

8. Defina as seguintes configurações e escolha Salvar:

1. Escolha Ações e Implantar API.

2. Para Estágio da implantação), escolha Novo estágio e atribua o nome opensearch-api-test ao estágio.

3. Escolha Deploy (Implantar).

4. Defina as seguintes configurações no editor de estágios e, em seguida, escolha Salvar alterações:

1. Navegue até o URL do OpenSearch Dashboards do domínio.

2. No menu principal, escolha Segurança, Funções e selecione o link para all_access, a função para a qual precisa mapear a função do Lambda.

3. Escolha Usuários mapeados e Gerenciar mapeamento.

4. Em Funções de backend, adicione o nome do recurso da Amazon (ARN) da função do Lambda. O ARN deve assumir a forma de arn:aws:iam::123456789123:role/service-role/opensearch-lambda-role-1abcdefg.

5. Selecione Mapa e confirme se o usuário ou função aparece em Usuários mapeados.

Para testar o aplicativo web

1. Faça download do sample-site.zip, descompacte-o e abra scripts/search.js em seu editor de texto de preferência.

2. Atualize a variável apigatewayendpoint para apontar para o endpoint do API Gateway Você pode encontrar rapidamente o endpoint no API Gateway escolhendo Estágios e selecionando o nome da API. A variável apigatewayendpoint deve assumir a forma de https://some-id.execute-api.us-west-1.amazonaws.com/opensearch-api-test.

3. Abra index.html e tente executar pesquisas para thor, casa e alguns outros termos.

   

1. Habilite o CORS no recurso GET. Em Avançado, defina Access-Control-Allow-Credentials como 'true'.

2. Reimplante a API no API Gateway [Ações, Implantar API].

3. Exclua e torne a adicionar o acionador da função do Lambda. Adicione readicionar, escolha Adicionar acionador e crie o endpoint HTTP que invoca sua função. O acionador deve ter a seguinte configuração:

   Trigger	API	Estágio de implantação	Segurança
   API Gateway	opensearch-api	opensearch-api-test	Abra o