更新 Amazon OpenSearch Ingestion 管道 - 亚马逊 OpenSearch 服务
注意事项所需权限更新管道使用蓝绿部署进行管道更新
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

更新 Amazon OpenSearch Ingestion 管道

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

注意事项

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

  • 无法更新管道的名称或网络设置。

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

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

  • 更新管道的源、处理器或接收器配置时， OpenSearch Ingestion 将启动蓝绿部署。有关更多信息，请参阅 使用蓝绿部署进行管道更新。

  • 更新管道的源、处理器或接收器配置时， OpenSearch Ingestion 会自动将管道升级到管道正在运行的 Data Prepper 主版本支持的最新次要版本。此过程可让您的管道及时获取最新错误修复和性能改进。

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

所需权限

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

  • osis:UpdatePipeline – 更新管道。

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

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

例如，以下策略授予更新管道的权限：

{
   "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、或 OpenSearch Ingestion API 更新 Amazon OpenSearch Ingestion 管道。 Amazon CLI

更新管道

  1. 在https://console.aws.amazon.com/aos/家中登录亚马逊 OpenSearch 服务控制台。

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

  3. 选择一个管道以打开其设置。然后，选择其中一个 “编辑” 选项。

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

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

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

Blue/green refers to the practice of creating a new environment for pipeline updates and routing traffic to the new environment after those updates are complete. The practice minimizes downtime and maintains the original environment in the event that deployment to the new environment is unsuccessful. Blue/green部署本身不会对性能产生任何影响；但是，如果管道配置以某种方式改变了性能，则性能可能会发生变化。

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

更新管道的源、处理器或接收器配置时， OpenSearch Ingestion 可以自动将管道升级到管道正在运行的主要版本支持的最新次要版本。例如，管道配置version: "2"中可能包含 In OpenSearch gestion 最初使用版本 2.1.0 预置管道。添加版本 2.1.1 支持并更改管道配置后， OpenSearch Ingestion 会将管道升级到版本 2.1.1。

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