本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用指令碼建立新的叢集並安裝外掛程式
<a name="opensearch-install-with-script"></a>

如果您尚未建立 OpenSearch 叢集，您可以使用快速入門 bash 指令碼來建立叢集。此指令碼會在 Docker 容器中設定 OpenSearch 叢集、使用您的預設 AWS 設定檔設定登入資料，以及安裝 Amazon Personalize Search Ranking 外掛程式。

 如需有關手動建立 OpenSearch 叢集的資訊，請參閱 OpenSearch 文件中的[快速入門](https://opensearch.org/docs/quickstart)說明。

**使用快速入門 bash 指令碼安裝外掛程式**

1.  執行指令碼之前，請為您的作業系統下載並安裝 [Docker Desktop](https://docs.docker.com/get-docker/)。

1. 從 GitHub 下載[快速入門 bash 指令碼](https://github.com/opensearch-project/search-processor/blob/main/helpers/personalized_search_ranking_quickstart.sh)。

1. 在您的工作目錄中，使用下列命令執行指令碼。

   ```
   sh personalized_search_ranking_quickstart.sh
   ```

   透過此命令，指令碼會使用預設 AWS 設定檔中的登入資料。若要提供替代設定檔，請使用 `--profile`引數。

   ```
   sh personalized_search_ranking_quickstart.sh --profile profile-name
   ```

   執行指令碼後，您可以在位於指令碼建立之唯一目錄中的 README 檔案中找到指令碼的詳細資訊。此目錄存放指令碼使用的 Dockerfile 和 docker-compose.yml 檔案。例如：`../opensearch-personalize-intelligent-ranking-docker.1234/README`。

1. 將目錄資料上傳至 OpenSearch 叢集。當您上傳資料時，您可以建立 OpenSearch 索引並定義欄位映射。然後，您將資料上傳到該索引。如需範例，請參閱[使用範例資料建立索引和欄位映射](https://opensearch.org/docs/latest/quickstart/#create-an-index-and-field-mappings-using-sample-data)。

 在您設定 OpenSearch 並安裝 Amazon Personalize Search Ranking 外掛程式之後，即可進行設定。您可以透過建立搜尋管道並指定`personalized_search_ranking`回應處理器來設定外掛程式。如需詳細資訊，請參閱[建立管道](opensearch-plugin-pipeline-example.md)。