更新 Amazon OpenSearch Ingestion 管道 - 亚马逊 OpenSearch 服务
注意事项所需权限更新管道使用蓝绿部署进行管道更新

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

更新 Amazon OpenSearch Ingestion 管道

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

注意事项

更新管道时，请注意以下事项：

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

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

  • 您可以随时在公共 OpenSearch 服务域和 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"
         ]
      }
   ]
}

更新管道

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

更新管道

  1. 登录亚马逊 OpenSearch 服务控制台，网址为 https://console.aws.amazon.com/aos/home。

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

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

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

要使用更新管道 AWS 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 摄取管道，请调用该操作。UpdatePipeline

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

OpenSearch 当您更新管道的 YAML 配置时，Ingestion 会启动蓝/绿部署流程。

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

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

更新管道的 YAML 配置文件时， OpenSearch Ingestion 可以自动将您的管道升级到工作流配置中指定的 Data Prepper 主版本支持的最新次要版本。例如，您的工作流配置version: "2"中可能有， OpenSearch Ingestion 最初使用版本 2.1.0 配置了管道。添加对版本 2.1.1 的支持并且您更改工作流配置后， OpenSearch Ingestion 会将您的管道升级到 2.1.1 版。

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