チュートリアル: 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. Lambda コンソール (https://console.aws.amazon.com/lambda/home) に進みます。ナビゲーションペインで、[Functions] (関数) を選択します。

2. [Create Function] (関数を作成) を選択します。

3. 次のフィールドを設定します。

   • 関数名: opensearch-function

   • ランタイム: Python 3.9

   • アーキテクチャ: x86_64

   他のオプションはすべてデフォルトのままにして、[Create function] を選択します。

4. 関数の概要ページの[Code source] (コードソース) セクションで、ドロップダウンから [Upload from] (アップロード元) を選択し、[.zip file] (.zip ファイル) を選択します。my-deployment-package.zip 作成したファイルを見つけて、[Save] (保存) を選択します。

5. ハンドラーとは、イベントを処理する関数コード内のメソッドです。[Runtime settings] (ランタイム設定) の下で [Edit] (編集) を選択し、Lambda 関数が配置されているデプロイパッケージ内の、ファイルの名前に従ってハンドラー名を変更します。例えば、ファイルの名前が opensearch-lambda.py の場合、ハンドラー名を opensearch-lambda.lambda_handler に変更します。詳細については、「Python の Lambda 関数ハンドラー」を参照してください。

1. API Gateway コンソール (https://console.aws.amazon.com/apigateway/home) に移動します。ナビゲーションペインで、[API] を選択します。

2. [REST API] (プライベートではない) を見つけ、[構築] を選択します。

3. 次のページの [Create new API] (新しい API を作成) セクションで、[New API] (新規 API) が選択されていることを確認します。

4. 次のフィールドを設定します。

   • API 名: opensearch-api

   • 説明: Amazon OpenSearch Service ドメイン検索用のパブリック API

   • エンドポイントタイプ: リージョン別

5. API の作成 を選択します。

6. [アクション] および [メソッドの作成] を選択します。

7. ドロップダウンで [GET] を選択し、チェックマークをクリックして確定します。

8. 以下の設定を行い、[保存] を選択します。

1. [アクション] および [API のデプロイ] を選択します。

2. [デプロイステージ] では、[新しいステージ] を選択し、ステージ opensearch-api-test に名前を付けます。

3. [デプロイ] を選択します。

4. ステージエディタで以下の設定を行い、[変更の保存] を選択します。

1. ドメインの OpenSearch Dashboards URL に移動します。

2. メインメニューから [Security] (セキュリティ)、[Roles] (ロール) の順に選択し、Lambda ロールをマッピングするロールである all_access へのリンクを選択します。

3. [マッピングされたユーザー]、[マッピングの管理] を選択します。

4. [Backend roles] (バックエンドロール) で、Lambda ロールの Amazon リソースネーム (ARN) を追加します。ARN は arn:aws:iam::123456789123:role/service-role/opensearch-lambda-role-1abcdefg の形式にします。

5. [マップ] を選択し、ユーザーまたはロールが [マッピングされたユーザー] の下に表示されていることを確認します。

ウェブアプリケーションをテストするには

1. sample-site.zip をダウンロードして解凍し、お気に入りのテキストエディタで scripts/search.js を開きます。

2. API Gateway エンドポイントを指すように apigatewayendpoint 変数を更新し、所定のパスの最後にバックスラッシュを追加します。[Stages] (ステージ) と API の名前を選択することで、API ゲートウェイでエンドポイントをすばやく見つけることができます。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 ゲートウェイ ([Actions] (アクション)、[Deploy API] (API のデプロイ)) で API を再デプロイします。

3. Lambda 関数トリガーを削除して再追加します。[re-add] (再追加) を追加し、[Add trigger] (トリガーを追加) を選択して、関数を呼び出す HTTP エンドポイントを作成します。トリガーには、次の設定がある必要があります。

   トリガー	API	デプロイされるステージ	セキュリティ
   API Gateway	opensearch-api	opensearch-api-test	開く