您可以设置 Atlas 应开始对集群执行每周维护的时间。此设置是可选的，大多数集群都不需要此设置。从 项目设置中配置维护窗口。
通常无需手动配置维护窗口。Atlas 以滚动方式自动执行维护，以确保弹性应用程序的持续可用性。您可以使用测试故障转移功能，确保您的应用程序对副本集选举具有弹性。
通过允许在一天中的首选时间进行需要副本集选举的维护，并在业务关键时间之外进行其他标准更新，配置维护窗口可以更好地控制维护时机。
维护窗口注意事项
紧急维护活动
Atlas 可能会在必要时立即执行紧急维护活动（例如零日漏洞的安全补丁），而不考虑配置的维护窗口或受保护的时间。
持续维护操作
一旦为集群安排了维护窗口，在所有正在执行的维护操作完成之前，您将无法更改此维护窗口。
MongoDB 数据库升级
如果维护包括 MongoDB 修补程序版本升级，Atlas 会在控制台中显示当前版本和目标版本。
维护需要副本集选举
Atlas 的维护方式与 MongoDB 手册中所述的维护过程相同。此过程要求每个副本集在维护窗口期间至少进行一次副本集选举。
使用测试故障转移功能，确保应用程序对副本集选举具有弹性。
维护工作尽可能在靠近窗口开始的地方开始
维护总是尽可能接近预定时间开始，但正在进行的集群更新或意外的系统问题可能会延迟开始时间。
维护期间可能会出现短暂的性能下降
如果磁盘 IOPS 较低，则在 MongoDB 重新填充 WiredTiger 存储引擎时，集群可能会在维护期间出现短暂的性能下降。请参阅日志和 WiredTiger 存储引擎，以了解更多信息。
轨道维护完成
受保护时间的考虑因素
除了配置维护窗口之外，您还可以设置每日受保护时间，这是 Atlas 避免执行标准更新的时间段。
维护与标准更新
Atlas 会在维护窗口期间自动执行维护。然而，Atlas可能会在维护窗口之外执行不涉及集群重启或影响工作负载性能的标准更新。当您启用保护时间后，Atlas 会在保护时间窗口之外执行标准更新。
受保护时间范围
受保护时间窗口的长度不得超过 18 个小时。
必需的访问权限
要管理维护窗口，您必须拥有项目的 Organization Owner 或 Project Owner 访问权限。
步骤
打开项目设置
在 Atlas 中，转到 Project Settings（项目集成）页面。
如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。
如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。
在侧边栏中，单击 Project Settings。
显示项目设置页面。
查看和配置维护窗口
要使用 Atlas 用户界面查看和配置维护窗口：
单击 Set Maintenance Window 按钮以显示维护窗口设置。
设置您希望 Atlas 开始维护项目的日期和时间。
如果您希望 Atlas 自动将任何计划的维护推迟一周，请单击 Automatically defer maintenance for one week。
要设置 Atlas 在保护时间范围内避免执行标准更新，请将 Turn on protected hours 设置切换为 On。您可以将每天的最大时间范围设置为 18 小时。
单击 Save 以保留更改，或单击 Cancel 以放弃更改。
要使用 Atlas CLI 返回维护窗口的详情，请运行以下命令：
atlas maintenanceWindows describe [options]
要使用 Atlas CLI 更新维护窗口，请运行以下命令：
atlas maintenanceWindows update [options]
清除维护窗口配置设置
如果您配置了首选维护窗口开始时间，则可以使用 Atlas CLI 或 Atlas 用户界面清除设置。清除维护窗口配置可恢复默认的维护窗口设置。
要使用 Atlas 用户界面清除配置的维护窗口，请将 Set Maintenance Window 设置切换到 Off。
要使用 Atlas CLI 清除已配置的维护窗口，请运行以下命令：
atlas maintenanceWindows clear [options]
要了解有关命令语法和参数的更多信息，请参阅 Atlas CLI 文档中的 atlas maintenanceWindows clear。
响应所需的维护
需要维护时：
Atlas会在项目的集群列表中显示横幅，其中显示计划维护的日期和时间。
在计划维护前 到48 小时之间， Atlas会向具有72
Project Owner角色的用户发送一封电子邮件，并更新Atlas用户界面以显示立即开始维护或将维护推迟一周的选项。注意
要配置如何接收计划维护窗口通知，请参阅配置维护窗口警报。
立即开始维护
要立即开始维护：
单击横幅。出现标题为 Scheduled Maintenance Operations 的模式窗口。此窗口描述了当前计划的维护操作的内容。
单击 Begin Now 按钮。在 Start Cluster Maintenance Now 模式中，单击 Yes, start my maintenance now. 进行确认
要使用 Atlas CLI 更新维护窗口，请运行以下命令：
atlas maintenanceWindows update [options]
要学习；了解有关命令语法和参数的更多信息，请参阅Atlas CLI文档 的 atlas maintenanceWindows 更新。
重要提示：要立即触发维护，请传递 --startASAP选项。
# Trigger immediate maintenance for the project with the ID # 5e2211c17a3e5a48f5497de3: atlas maintenanceWindows update --startASAP --projectId 5e2211c17a3e5a48f5497de3 --output json
Atlas为一个项目端点提供更新一个维护窗口。您可以通过传入值为 的可选 字段来立即触发维护。startASAPtrue
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \ --digest --include \ --header "Accept: application/vnd.atlas.2025-03-12+json" \ --header "Content-Type: application/json" \ -X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/maintenanceWindow" \ --data ' { "startASAP": true }'
推迟维护
要推迟计划维护：
单击横幅。出现标题为 Scheduled Maintenance Operations 的模式窗口。此窗口描述了当前计划的维护操作的内容。
单击 Defer 1 Week 按钮。在 Defer Maintenance to Next Week 模式中，单击 Yes, defer maintenance until next week. 进行确认
要使用 Atlas CLI 推迟维护窗口，请运行以下命令：
atlas maintenanceWindows defer [options]
要了解有关命令语法和参数的更多信息，请参阅 Atlas CLI 文档以了解Atlas MaintenanceWindows 延迟。
维护窗口期间维护版本升级
如果 Atlas 将在下一个维护窗口期间升级其中一个集群上的 MongoDB 维护版本，则该集群的卡片会显示目标 MongoDB 维护版本。