本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Amazon OpenSearch 服务重命名-变更摘要
2021 年 9 月 8 日,我们的搜索和分析套件更名为亚马逊 OpenSearch 服务。 OpenSearch 服务支持 OpenSearch 以及传统的 Elasticsearch OSS。以下各节介绍了随重命名而更改的不同服务部分,以及您需要执行哪些操作来确保域继续正常运行。
其中一些更改仅在您将域名从 Elasticsearch 升级到时才适用。 OpenSearch在其他情况下(例如,在“账单和成本管理”控制台中),体验将立即更改。
请注意,此列表并不详尽。虽然产品的其他部分也发生了更改,但这些更新是最相关的。
新 API 版本
新版本的 OpenSearch 服务配置 API (2021-01-01) 适用于传统的 Elasticsearc OpenSearch h OSS。21 个 API 操作被更简洁且与引擎无关的名称所取代(例如,CreateElasticsearchDomain
更改为CreateDomain
),但是 S OpenSearch ervice 继续支持这两个 API 版本。
我们建议您使用新的 API 操作来创建和管理后续域。请注意,当您使用新 API 操作创建域时,您需要指定采用格式 Elasticsearch_X.Y
或者 OpenSearch_X.Y
的 EngineVersion
参数,而不仅仅是版本号。如果您未指定版本,则默认为最新版本的 OpenSearch。
Amazon CLI 将您的域名升级到 1.20.40 或更高版本,aws opensearch
...
以便用于创建和管理您的域名。有关新的 CLI 格式,请参阅 OpenSearch CLI 参考
重命名的实例类型
Amazon S OpenSearch ervice 中的实例类型现在采用了格式,<type>.<size>.search
例如,m6g.large.search
而不m6g.large.elasticsearch
是。您不需要采取任何措施。现有域将自动启动引用 API 以及“账单和成本管理”控制台中的新实例类型。
如果您有预留实例 (RIs),则您的合同不会受到变更的影响。旧的配置 API 版本仍与旧的命名格式兼容,但如果要使用新的 API 版本,则需要使用新格式。
访问策略更改
以下各节介绍了更新访问策略需要执行的操作。
IAM 策略
我们建议您更新 IAM 策略以使用重命名的 API 操作。但是,S OpenSearch ervice 将继续通过在内部复制旧的 API 权限来遵守现有政策。例如,如果您当前有权执行 CreateElasticsearchDomain
操作,则您现在可以调用 CreateElasticsearchDomain
(旧的 API 操作)和 CreateDomain
(新的 API 操作)。这同样适用于显式拒绝。有关更新的 API 操作的列表,请参阅策略元素引用。
SCP 策略
与标准 IAM 相比,服务控制策略 (SCPs) 增加了复杂性。为了防止 SCP 策略中断,您需要将旧的和新的 API 操作添加到您的每个 SCP 策略中。例如,如果用户当前具有 CreateElasticsearchDomain
的允许权限,您还需要授予它们 CreateDomain
的允许权限,以便他们能够保留创建域的能力。这同样适用于显式拒绝。
例如:
"Statement": [ { "Effect": "Allow", "Action": [ "es:CreateElasticsearchDomain", "es:CreateDomain" ... ], }, "Effect": "Deny", "Action:" [ "es:DeleteElasticsearchDomain", "es:DeleteDomain" ...
新资源类型
OpenSearch 服务引入了以下新的资源类型:
资源 | 描述 |
---|---|
|
代表 Amazon OpenSearch 服务域名。此资源存在于服务级别,并不特定于域上运行的软件。它适用于 Amazon CloudFormation 有关将内定义的域 CloudFormation 从 Elasticsearch 升级到的说明 OpenSearch,请参阅 CloudFormation 用户指南中的备注。 |
|
代表在域上运行的 OpenSearch /Elasticsearch 软件。此资源适用于Amazon CloudTrailAWS::Elasticsearch::Domain ) 的域的不同资源类型。 OpenSearch AWS::OpenSearch::Domain |
注意
在中 Amazon ConfigAWS::Elasticsearch::Domain
资源类型下看到您的数据 OpenSearch。
Kibana 已重命名为控制面板 OpenSearch
OpenSearch 仪表板是 Kibana 的 Amazon 替代品,是一种开源可视化工具,专为与之配合使用而设计。 OpenSearch将域名从 Elasticsearch 升级到后 OpenSearch,/_plugin/kibana
终端节点将变为。/_dashboards
OpenSearch 服务会将所有请求重定向到新的终端节点,但是如果您在任何 IAM 策略中使用 Kibana 终端节点,请更新这些策略以同时包含新的/_dashboards
终端节点。
如果您正在使用仪表板的 SAML 身份验证 OpenSearch ,则在将域升级到之前 OpenSearch,您需要将身份提供商 (IdP) 中 URLs 配置的所有 Kibana 从更改为。/_plugin/kibana
/_dashboards
最常见 URLs 的是断言消费者服务 (ACS) URLs 和接收方 URLs。
OpenSearch 仪表板的默认kibana_read_only
角色已重命名为opensearch_dashboards_read_only
,该kibana_user
角色已重命名为opensearch_dashboards_user
。此更改适用于所有新创建的 1 OpenSearch . x 个运行服务软件 R20211203 或更高版本的域。如果将现有域升级到服务软件 R20211203,则角色名称将保持不变。
已重命名的 CloudWatch 指标
域名正在运行的几个 CloudWatch 指标会发生变化 OpenSearch。当您将域名升级到时 OpenSearch,指标会自动更改,您当前的 CloudWatch 警报将中断。在将集群从 Elasticsearch OpenSearch 版本升级到某个版本之前,请务必更新 CloudWatch 警报以使用新的指标。
更改了以下指标:
原始指标名称 | 新名称 |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
有关 OpenSearch 服务发送给 Amazon 的指标的完整列表 CloudWatch,请参阅使用 Amazon 监控 OpenSearch 集群指标 CloudWatch。
账单和成本管理控制台更改
账单和成本管理控制台以及成本
除了服务名称以外,所有报告、账单和价格列表 API 操作的以下字段也将更改:
字段 | 旧格式 | 新格式 |
---|---|---|
实例类型 |
|
|
产品系列 |
Elasticsearch 实例 Elasticsearch 卷 |
Amazon OpenSearch 服务实例 亚马逊 OpenSearch 服务量 |
定价说明 |
c5.18xlarge.elasticsearch 实例小时(或部分小时)5.098 美元 - 欧盟 |
c5.18xlarge.search 实例小时(或部分小时)5.098 美元 - 欧盟 |
实例系列 |
|
|
新事件格式
OpenSearch 服务发送给亚马逊 EventBridge 和亚马逊的事件格式 CloudWatch 已更改,特别是该detail-type
字段。源字段 (aws.es
) 保持不变。有关每种事件类型的完整格式,请参阅 使用 Amazon 监控 OpenSearch 服务事件 EventBridge。如果您具有取决于旧格式的现有事件规则,请确保更新它们以符合新格式。
什么保持不变?
以下特性和功能以及未列出的其他特性和功能将保持不变:
-
服务委托人 (
es.amazonaws.com
) -
供应商代码
-
域名 ARNs
-
域终端节点
开始吧:将您的域名升级到 OpenSearch 1.x
OpenSearch 1。 x 支持从 Elasticsearch 版本 6.8 和 7 进行升级。 x。有关升级域的说明,请参阅 升级域(控制台)。如果您使用 Amazon CLI 或配置 API 来升级您的域名,则需要指定TargetVersion
为OpenSearch_1.x
。
OpenSearch 1。 x 引入了一个名为 “启用兼容模式” 的附加域设置。由于某些 Elasticsearch OSS 客户端和插件在连接之前会检查集群版本,因此兼容模式设置 OpenSearch 为将其版本报告为 7.10,因此这些客户端可以继续工作。
在首次创建 OpenSearch 域名时,或者 OpenSearch 从 Elasticsearch 版本升级到时,您可以启用兼容模式。如果未设置,则创建域时参数默认为 false
,并且在升级域时默认为 true
。
要使用配置 API 启用兼容模式,请将 override_main_response_version
设置为 true
:
POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/upgradeDomain { "DomainName": "
domain-name
", "TargetVersion": "OpenSearch_1.0", "AdvancedOptions": { "override_main_response_version": "true" } }
要在现有 OpenSearch域名上启用或禁用兼容模式,您需要使用 OpenSearch _cluster/
PUT /_cluster/settings { "persistent" : { "compatibility.override_main_response_version" : true } }