教學：使用 Amazon OpenSearch 服務建立搜尋應用程式

建立部署套件

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. 將 opensearch-lambda.py 檔案新增至 zip 檔案的根目錄。

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

1. 瀏覽至 Lambda 主控台，網址為 https://console.aws.amazon.com/lambda/home。在左側導覽窗格中，選擇 [函數]。

2. 選取 Create function (建立函數)。

3. 設定下列欄位：

   • 功能名稱：打開搜索功能

   • 執行階段:Python 3.9

   • 架構：x86_64

   保留所有其他默認選項，然後選擇創建功能。

4. 在函數摘要頁面的 [程式碼原始碼] 區段中，選擇 [上傳自] 下拉式清單，然後選取 .zip 檔案。找到您建立的my-deployment-package.zip檔案，然後選擇 [儲存]。

5. 處理常式是函數程式碼中處理事件的方法。在 [執行階段設定] 下，選擇 [編輯]，然後根據 Lambda 函數所在部署套件中的檔案名稱變更處理常式名稱。由於您的檔案已命名opensearch-lambda.py，請將處理常式重新命名為opensearch-lambda.lambda_handler。如需詳細資訊，請參閱 Python 中的 Lambda 函數處理常式。

1. 瀏覽至 API Gateway 主控台，網址為 https://console.aws.amazon.com/apigateway/home。在左側導覽窗格中，選擇 [API]。

2. 找到 REST API (非私有) 並選擇 Build (建置)。

3. 在下一頁上，找到「建立新 API」區段，並確定已選取「新建 API」。

4. 設定下列欄位：

   • API 名稱：opensearch-api

   • 說明：用於搜索 Amazon OpenSearch 服務域的公共 API

   • 端點類型：區域

5. 選擇建立 API。

6. 選擇 Actions (動作) 和 Create Method (建立方法)。

7. 在下拉式選單中選擇 GET，然後按一下核取記號以確認。

8. 進行下列設定，然後選擇 Save (儲存)：

1. 選擇 Actions (動作) 和 Deploy API (部署 API)。

2. 對於 Deployment stage (部署階段)，選擇 New Stage (新增階段) 並將階段命名為 opensearch-api-test。

3. 選擇部署。

4. 在階段編輯器中進行下列設定，然後選擇 Save Changes (儲存變更)：

1. 導覽至網域的 OpenSearch 儀表板 URL。

2. 從主功能表中選擇安全性、角色，然後選取要all_access對應 Lambda 角色所需角色的連結。

3. 選擇 Mapped users (已映射的使用者)、Manage mapping (管理映射)。

4. 在 Backend roles (後端角色) 下方，新增 Lambda 角色的 Amazon Resource Name (ARN)。ARN 應採取的arn:aws:iam::123456789123:role/service-role/opensearch-lambda-role-1abcdefg形式.

5. 選擇 Map (映射)，並確認使用者或角色顯示在 Mapped users (已映射的使用者) 中。

若要測試 web 應用程式

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 (動作)、Deploy API (部署 API))。

3. 刪除並重新新增您的 Lambda 函數觸發程序。添加重新添加它，選擇添加觸發器並創建調用您的函數的 HTTP 端點。觸發必須具有以下組態：

   觸發條件	API	部署階段	安全
   API 閘道	opensearch-api	opensearch-api-test	開啟