Amazon Elasticsearch Service
开发人员指南 (API 版本 2015-01-01)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

步骤 1:创建 Amazon ES 域

重要

此过程简要介绍了如何配置测试域。不应使用它来创建生产域。有关相同过程的综合版本,请参阅创建和配置 Amazon Elasticsearch Service 域

An Amazon ES domain is synonymous with an Elasticsearch cluster. Domains are clusters with the settings, instance types, instance counts, and storage resources that you specify. 您可以使用控制台、AWS CLI 或 AWS 开发工具包创建 Amazon ES 域。

创建 Amazon ES 域(控制台)

  1. 转至 https://aws.amazon.com,然后选择 Sign In to the Console (登录控制台)

  2. Analytics (分析) 下,选择 Elasticsearch Service

  3. Define domain (定义域) 页面上,对于 Elasticsearch domain name (Elasticsearch 域名),为域键入一个名称。在本入门教程中,我们在稍后提供的示例中使用域名 movies

  4. 对于 Version (版本),为您的域选择 Elasticsearch 版本。建议您选择最新的受支持版本。有关更多信息,请参阅支持的 Elasticsearch 版本

  5. 选择 Next (下一步)

  6. 对于 Instance count (实例计数),选择所需的实例数量。在本教程中,您可以使用默认值 1。

  7. 对于 Instance type (实例类型),选择 Amazon ES 域的实例类型。在本教程中,我们建议使用 t2.small.elasticsearch,这是一种便宜的小型实例类型,适合用于测试目的。

  8. 现在,您可以忽略 Enable dedicated masterEnable zone awareness 复选框。有关这两项的更多信息,请参阅关于专用主节点启用区域感知

  9. 对于 Storage type,选择 EBS

    1. 对于 EBS volume type (EBS 卷类型),请选择“General Purpose (SSD) (通用型 (SSD))”。有关更多信息,请参阅 Amazon EBS 卷类型

    2. 对于 EBS volume size (EBS 卷大小),为每个 数据节点键入外部存储的大小 (GiB)。在本教程中,您可以使用默认值 10。

  10. 目前,您可以忽略 Enable encryption at rest。有关此功能的更多信息,请参阅Amazon Elasticsearch Service 的静态数据的加密

  11. 对于 Automated snapshot start hour (自动快照开始时间),请使用默认值。有关更多信息,请参阅配置自动快照

  12. 选择 Next (下一步)

  13. 为简单起见,在本教程中,我们建议使用基于 IP 的访问策略。在 Set up access (设置访问权限) 页面上的 Network configuration (网络配置) 部分中,选择 Public access (公有访问权限)

  14. 目前,您可以忽略 Kibana authentication (Kibana 身份验证)。有关此功能的更多信息,请参阅用于 Kibana 的 Amazon Cognito 身份验证

  15. 对于 Set the domain access policy to (将域访问策略设置为),选择 Allow access to the domain from specific IP(s) (允许从特定 IP 访问域),然后输入您的公有 IP 地址,您可以在大多数搜索引擎上搜索“我的 IP 地址是什么”来查找该 IP 地址。然后选择 OK

    要了解有关公有访问权限、VPC 访问和访问策略的更多一般性信息,请参阅Amazon Elasticsearch Service 访问控制Amazon Elasticsearch Service 域的 VPC 支持

  16. 选择 Next (下一步)

  17. Review (审核) 页面上,查看您的域配置,然后选择 Confirm (确认)

    注意

    初始化新域大约需要十分钟时间。初始化您的域后,您可以上传数据和更改域。

创建 Amazon ES 域 (AWS CLI)

  • 运行以下命令来创建一个 Amazon ES 域。

    此命令使用 Elasticsearch 版本 6.0 创建一个名为 movies 的域。它指定一个 t2.small.elasticsearch 实例类型的实例。此实例类型需要 EBS 存储,因此它指定了一个 10GiB 的卷。最后,此命令应用基于 IP 的访问策略来将对域的访问限制为单个 IP 地址。

    您需要将命令中的 your_ip_address 替换为您的公有 IP 地址,您可以通过在 Google 上搜索“我的 IP 地址是什么”来查找该 IP 地址。

    aws es create-elasticsearch-domain --domain-name movies --elasticsearch-version 6.0 --elasticsearch-cluster-config InstanceType=t2.small.elasticsearch,InstanceCount=1 --ebs-options EBSEnabled=true,VolumeType=standard,VolumeSize=10 --access-policies '{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"AWS":"*"},"Action":["es:*"],"Condition":{"IpAddress":{"aws:SourceIp":["your_ip_address"]}}}]}'

注意

初始化新域大约需要十分钟时间。初始化您的域后,您可以上传数据和更改域。

使用以下命令查询新域的状态:

aws es describe-elasticsearch-domain --domain movies

创建 Amazon ES 域(AWS 开发工具包)

AWS 开发工具包(Android 和 iOS 开发工具包除外)支持 Amazon ES 配置 API 参考中定义的所有操作,包括 CreateElasticsearchDomain 操作。有关安装和使用 AWS 开发工具包的更多信息,请参阅 AWS 软件开发工具包