教學課程：使用 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. 將 opensearch-lambda.py 檔案新增至 zip 檔案的根目錄。

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

1. 導覽至位於 https：//https://console.aws.amazon.com/lambda/home 的 Lambda 主控台。在左側導覽窗格中，選擇函數。

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

3. 設定下列欄位：

   • 函數名稱：openearch-function

   • 執行時間：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：//https://console.aws.amazon.com/apigateway/home。在左側導覽窗格中，選擇 APIs。

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

3. 在下列頁面上，找到建立新 API 區段，並確認已選取新 API。

4. 設定下列欄位：

   • API 名稱：opensearch-api

   • 描述：搜尋 Amazon OpenSearch Service 網域的公有 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. 導覽至 IAM 主控台，網址為 https://console.aws.amazon.com/iam/。

2. 選擇角色並搜尋您的 Lambda 執行角色 （通常名為 opensearch-lambda-role-xxxxxxxx)。

3. 選擇新增許可，然後選擇建立內嵌政策。

4. 選擇 JSON 索引標籤，然後從上方貼上適當的政策，將預留位置值取代為您的實際資源 ARNs。

5. 選擇檢閱政策，提供類似 的名稱OpenSearchAccess，然後選擇建立政策。

1. 導覽至網域的 OpenSearch Dashboards 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 Gateway	opensearch-api	opensearch-api-test	開啟