자습서: Amazon OpenSearch Service를 사용하여 검색 애플리케이션 생성

배포 패키지를 만드는 방법

1. 명령 프롬프트를 열고 my-opensearch-function 프로젝트 디렉터리를 만듭니다. 예를 들어, macOS에서는 다음을 수행합니다.

   mkdir my-opensearch-function

2. my-sourcecode-function 프로젝트 디렉터리로 이동합니다.

   cd my-opensearch-function

3. 다음과 같은 샘플 Python 코드의 콘텐츠를 복사하고 이름이 opensearch-lambda.py인 새 파일에 저장합니다. 리전 및 호스트 엔드포인트를 파일에 추가합니다.

   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. 외부 라이브러리를 새 package 디렉터리에 설치합니다.

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

5. 루트에서 설치된 라이브러리를 포함하는 배포 패키지를 만듭니다. 다음 명령을 실행하면 프로젝트 디렉터리에 my-deployment-package.zip 파일이 생성됩니다.

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

6. zip 파일의 루트에 opensearch-lambda.py 파일을 추가합니다.

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

1. https://console.aws.amazon.com/lambda/home에서 Lambda 콘솔로 이동합니다. 왼쪽 탐색 창에서 함수를 선택합니다.

2. 함수 생성을 선택합니다.

3. 다음 필드를 구성합니다.

   • 함수 이름: opensearch-function

   • 런타임 – Python 3.9

   • 아키텍처: x86_64

   다른 모든 기본 옵션은 그대로 두고 함수 생성을 선택합니다.

4. 함수 요약 페이지의 코드 소스 섹션에서 드롭다운에서 업로드를 선택하고 .zip 파일을 선택합니다. 생성한 my-deployment-package.zip 파일을 찾아 저장을 선택합니다.

5. 핸들러는 이벤트를 처리하는 함수 코드의 메서드입니다. 런타임 설정에서 편집을 선택하고 Lambda 함수가 있는 배포 패키지의 파일 이름에 따라 핸들러 이름을 변경합니다. 파일 이름이 opensearch-lambda.py이므로 핸들러 이름을 opensearch-lambda.lambda_handler로 변경합니다. 자세한 내용은 Python의 Lambda 함수 핸들러를 참조하세요.

1. https://console.aws.amazon.com/apigateway/home에서 API Gateway 콘솔로 이동합니다. 왼쪽 탐색 창에서 API를 선택합니다.

2. REST API(비공개 아님)를 찾고 빌드(Build)를 선택합니다.

3. 다음 페이지에서 새 API 생성 섹션을 찾아 새 API가 선택되어 있는지 확인합니다.

4. 다음 필드를 구성합니다.

   • API 이름: OpenSearch-api

   • 설명: Amazon OpenSearch Service 도메인을 검색하기 위한 퍼블릭 API

   • 엔드포인트 유형: 리전별

5. API 생성(Create API)을 선택합니다.

6. 작업(Actions) 및 메서드 생성(Create Method)을 선택합니다.

7. 드롭다운에서 GET을 선택하고 확인 표시를 클릭하여 확인합니다.

8. 다음 설정을 구성한 다음 저장(Save)을 선택합니다.

1. 작업(Actions) 및 API 배포(Deploy API)를 선택합니다.

2. 배포 단계(Deployment stage)에서 새 단계(New Stage)를 클릭하고 단계 이름을 opensearch-api-test로 지정합니다.

3. 배포(Deploy)를 선택합니다.

4. 단계 편집기에서 다음 설정을 구성한 다음 변경 내용 저장(Save Changes)을 선택합니다.

1. 도메인에 대한 OpenSearch 대시보드 URL로 이동합니다.

2. 기본 메뉴에서 보안, 역할을 선택한 후 Lambda 역할을 매핑해야 할 역할인 all_access에 대한 링크를 선택합니다.

3. 매핑된 사용자(Mapped users), 매핑 관리(Manage mapping)를 차례로 선택합니다.

4. Backend roles(백엔드 역할)에서 Lambda 역할의 Amazon 리소스 이름(ARN)을 추가합니다. ARN은 arn:aws:iam::123456789123:role/service-role/opensearch-lambda-role-1abcdefg 형식을 취해야 합니다.

5. Map(맵)을 선택하고 Mapped users(매핑된 사용자)에 사용자 또는 역할이 나타나는지 확인합니다.

웹 애플리케이션을 테스트하려면

1. sample-site.zip을 다운로드하고 압축을 해제하여 자주 사용하는 텍스트 편집기에서 scripts/search.js를 엽니다.

2. apigatewayendpoint 변수를 업데이트하여 API Gateway 엔드포인트를 가리키도록 하고 지정된 경로의 끝에 백슬래시를 추가합니다. 단계(Stages)를 선택하고 API의 이름을 선택하여 API Gateway에서 엔드포인트를 빠르게 찾을 수 있습니다. apigatewayendpoint 변수는 https://some-id.execute-api.us-west-1.amazonaws.com/opensearch-api-test/의 형식을 취해야 합니다.

3. index.html을 열고 thor, house 등 몇 가지 단어를 검색해 봅니다.

   

1. GET 리소스에서 CORS를 활성화합니다. 고급(Advanced)에서 Access-Control-Allow-Credentials를 'true'로 설정합니다.

2. API Gateway에서 API를 재배포합니다(작업(Actions), API 배포(Deploy API)).

3. Lambda 함수 트리거를 삭제하고 다시 추가합니다. 다시 추가하려면 트리거 추가를 선택하고 함수를 호출하는 HTTP 엔드포인트를 생성합니다. 트리거 구성은 다음과 같아야 합니다.

   트리거	API	배포 단계	보안
   API Gateway	OpenSearch-api	OpenSearch-api-test	열기