维护 Amazon MQ 代理 - Amazon MQ
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

维护 Amazon MQ 代理

Amazon MQ 定期对消息代理的硬件、操作系统或引擎软件进行维护。维护的持续时间有所不同,但最多可持续两小时,具体取决于为消息代理安排的操作。例如,如果您已激活自动次要引擎版本升级或更改了代理实例类型,Amazon MQ 将在下一个计划的维护时段内应用您的更改。

为了最大限度地减少维护时段内的停机时间,建议选择跨多个可用区(AZ)且具有高可用性的代理部署模式。根据您的代理引擎类型,Amazon MQ 提供以下多可用区部署模式。

  • Amazon MQ for ActiveMQ – Amazon MQ for ActiveMQ 提供主动/备用部署,以实现高可用性。在主动/备用模式下,Amazon MQ 一次执行一个实例的维护操作,确保至少有一个实例保持可用。此外,您还可以将代理网络维护时段分散在整个周。

  • Amazon MQ for RabbitMQ – Amazon MQ for RabbitMQ 提供集群部署,以实现高可用性。在集群部署中,Amazon MQ 一次执行一个节点的维护操作,并始终保持至少两个正在运行的节点。

有关 Amazon MQ 建议的最佳实践以确保您的代理在维护时段期间和之后高效执行操作的更多信息,请参阅以下有关您的代理引擎类型的文档。

您可以安排每周进行一次维护,指定最多持续两小时。这将通过 Amazon MQ 设置维护操作时段,以便安排和启动。

您可以在首次创建代理时或通过更新代理首选项来安排维护时段。以下主题介绍了如何使用Amazon Web Services Management Console、Amazon CLI 和 Amazon MQ API 调整代理维护时段。

调整代理维护时段

要调整代理维护时段,您可以使用Amazon Web Services Management Console、Amazon CLI 或 Amazon MQ API。

重要

在下一个计划的维护时段开始之前,您最多只能调整代理的维护时段次。Amazon MQ 会限制四次维护时段调整,以确保关键软件和安全补丁以及重要的硬件升级不会被无限期延迟和延期。

代理维护时段完成后,Amazon MQ 会重置限制,允许您在下一个维护时段出现之前调整计划。

使用Amazon Web Services Management Console调整代理维护时段

  1. 登录 Amazon MQ 控制台

  2. 在左侧导航窗格中,选择 Brokers (代理),然后从列表中选择您要升级的代理。

  3. 在代理详细信息页上,选择 Edit (编辑)

  4. Maintenance (维护) 下,执行以下操作。

    1. 对于 Start day(开始日),从下拉列表中选择星期几,例如 Sunday(星期日)。

    2. 对于 Start time(开始时间),选择您要为下一个代理维护时段安排的一天中的小时和分钟,例如 12:00

      注意

      Start time (开始时间) 选项采用 UTC+0 时区进行配置。

  5. 滚动到页面底部并选择 Save (保存)。立即调整维护时段。

  6. 在代理详细信息页面上的 Maintenance widnow(维护时段)下,验证是否显示了新的首选计划。

使用 Amazon CLI 调整代理维护时段

  1. 使用 update-broker CLI 命令并指定以下参数,如示例所示。

    • --broker-id – Amazon MQ 为代理生成的唯一 ID。您可以通过代理 ARN 解析 ID。例如,给定以下 ARN arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9,代理 ID 将为 b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9

    • --maintenance-window-start-time – 确定以下结构中提供的每周维护时段开始时间的参数。

      • DayOfWeek – 星期几,使用以下语法:MONDAY| TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY | SUNDAY

      • TimeOfDay – 时间,采用 24 小时制。

      • TimeZone –(可选)时区,可以采用国家/地区/城市或 UTC 偏移量格式。默认设置为 UTC。

    aws mq update-broker --broker-id broker-id \ --maintenance-window-start-time DayOfWeek=SUNDAY,TimeOfDay=13:00,TimeZone=America/Los_Angeles
  2. (可选)使用 describe-broker CLI 命令来验证维护时段是否已成功更新。

    aws mq describe-broker --broker-id broker-id

使用 Amazon MQ API 调整代理维护时段

  1. 使用 UpdateBroker API 操作。指定 broker-id 作为路径参数。以下示例假定代理在 us-west-2 区域中。有关可用的 Amazon MQ 终端节点的更多信息,请参阅《Amazon一般参考》中的 Amazon MQ 终端节点和配额

    PUT /v1/brokers/broker-id HTTP/1.1 Host: mq.us-west-2.amazonaws.com Date: Wed, 7 July 2021 12:00:00 GMT x-amz-date: Wed, 7 July 2021 12:00:00 GMT Authorization: authorization-string

    在请求负载中使用使用 maintenanceWindowStartTime 参数和 WeeklyStartTime资源类型。

    { "maintenanceWindowStartTime": { "dayOfWeek": "SUNDAY", "timeZone": "America/Los_Angeles", "timeOfDay": "13:00" } }
  2. (可选)使用 DescribeBroker API 操作来验证维护时段是否已成功更新。broker-id 已指定为路径参数。

    GET /v1/brokers/broker-id HTTP/1.1 Host: mq.us-west-2.amazonaws.com Date: Wed, 7 July 2021 12:00:00 GMT x-amz-date: Wed, 7 July 2021 12:00:00 GMT Authorization: authorization-string