更新 Amazon OpenSearch Ingestion 管道 - 亚马逊 OpenSearch 服务
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

更新 Amazon OpenSearch Ingestion 管道

您可以使用 Amazon Web Services Management Console、Amazon CLI 或 OpenSearch Ingestion API 更新 Amazon OpenSearch Ingestion 管道。更新管道的 YAML 配置时,OpenSearch Ingestion 将启动蓝绿部署。有关更多信息,请参阅 使用蓝绿部署进行管道更新

注意事项

更新管道时,请注意以下事项:

  • 您可以编辑管道的容量限制、日志发布选项和 YAML 配置。无法编辑其名称或网络设置。

  • 如果管道写入 VPC 域接收器,则在创建管道后将无法返回,也无法将接收器更改为其他 VPC 域。您必须删除,然后使用新的接收器重新创建管道。您仍然可以将接收器从 VPC 域切换到公有域、从公有域切换到 VPC 域,或者从一个公有域切换到另一个公有域。

  • 您可以随时在公有 OpenSearch Service 域与 OpenSearch 无服务器集合之间切换管道接收器。

  • 更新管道的 YAML 配置时,OpenSearch Ingestion 将启动蓝绿部署。有关更多信息,请参阅 使用蓝绿部署进行管道更新

  • 更新管道的 YAML 配置时,OpenSearch Ingestion 会自动将管道升级到管道配置中所指定 Data Prepper 主版本支持的最新次要版本。此过程可让您的管道及时获取最新错误修复和性能改进。

  • 管道停止后,仍然可以对管道进行更新。

所需权限

OpenSearch Ingestion 使用以下 IAM 权限来更新管道:

  • osis:UpdatePipeline – 更新管道。

  • osis:ValidatePipeline – 检查管道配置是否有效。

  • iam:PassRole – 将管道角色传递给 OpenSearch Ingestion,以便向域写入数据。只有在更新管道 YAML 配置时才需要此权限,而修改日志发布或容量限制等其他设置则不需要此权限。

例如,以下策略授予更新管道的权限:

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Resource":"*", "Action":[ "osis:UpdatePipeline", "osis:ValidatePipeline" ] }, { "Resource":[ "arn:aws:iam::{your-account-id}:role/{pipeline-role}" ], "Effect":"Allow", "Action":[ "iam:PassRole" ] } ] }

更新管道

您可以使用 Amazon Web Services Management Console、Amazon CLI 或 OpenSearch Ingestion API 更新 Amazon OpenSearch Ingestion 管道。

更新管道
  1. 登录到位于 https://console.aws.amazon.com/aos/home 的 Amazon OpenSearch Service 控制台。

  2. 在左侧导航窗格中,选择管道

  3. 选择一个管道以打开其设置。您可以编辑管道的容量限制、日志发布选项和 YAML 配置。无法编辑其名称或网络设置。

  4. 完成更改后,选择 Save (保存)

要使用 Amazon CLI 更新管道,请发送 更新-管道 请求。以下示例请求上传新配置文件并更新最小和最大容量值:

aws osis update-pipeline \ --pipeline-name "my-pipeline" \ --pipline-configuration-body "file://new-pipeline-config.yaml" \ --min-units 11 \ --max-units 18

要使用 OpenSearch Ingestion API 更新 OpenSearch Ingestion 管道,请调用 UpdatePipeline 操作。

使用蓝绿部署进行管道更新

更新管道的 YAML 配置时,OpenSearch Ingestion 将启动蓝绿部署过程。

蓝绿部署是指创建用于管道更新的新环境并在这些更新完成后将流量路由至新环境的实践。此实践可在部署到新环境未成功的情况下最大程度地减少停机时间并维护原始环境。蓝绿部署本身不会对性能产生任何影响;但是,如果管道配置以某种方式改变了性能,则性能可能会发生变化。

OpenSearch Ingestion 将在蓝绿部署期间阻止自动扩缩。在将旧管道重定向到新管道之前,只需继续为其支付流量费。重定向流量后,只需支付新管道费用。永远不需要同时为两条管道付费。

更新管道的 YAML 配置文件时,OpenSearch Ingestion 可以自动将管道升级到管道配置中指定的 Data Prepper 主版本支持的最新次要版本。例如,管道配置中可能包含 version: "2",而 OpenSearch Ingestion 最初使用版本 2.1.0 预置管道。添加版本 2.1.1 支持并更改管道配置后,OpenSearch Ingestion 会将管道升级到版本 2.1.1。

此过程可让您的管道及时获取最新错误修复和性能改进。除非在管道配置中手动更改 version 选项,否则 OpenSearch Ingestion 无法更新管道的主要版本。