使用计划内维护来计划和控制 Azure Kubernetes 服务群集的升级

2025-07-06

本文介绍如何在 Azure Kubernetes 服务 (AKS) 中使用计划内维护来计划和控制群集和节点映像升级。

对 AKS 群集的定期维护是自动进行的。有两种类型的维护操作：

AKS 发起的维护涉及 AKS 执行的用于使群集与最新功能和修补程序保持一致的每周发布。
用户发起的维护包括群集自动升级和节点操作系统 (OS) 自动安全更新。

使用 AKS 中的计划内维护功能时，可以按照自己选择的节奏运行两种类型的维护，以最大程度地减少工作负荷影响。

注意

可以使用计划内维护来计划自动升级的时间，但启用或禁用计划内维护不会启用或禁用自动升级。

开始之前

本文假定你拥有现有的 AKS 群集。如果还没有 AKS 群集，请参阅创建 AKS 群集。
如果使用 Azure CLI，请通过使用 az upgrade 命令升级到最新版本。

注意事项

使用计划内维护时，以下注意事项适用：

对于紧急或关键的计划外、反应性维护操作，AKS 保留在计划内维护时段外进行操作的权利。这些维护操作甚至可以在配置中定义的 notAllowedTime 或 notAllowedDates 期间运行。
我们会尽最大努力执行维护操作，但不保证在指定时段内执行。

计划内维护的计划配置类型

计划内维护可使用三种计划配置类型：

default 是用于控制 AKS 发布的基本配置。由于 Azure 安全部署做法，这些发布可能需要长达两周的时间才能推出到所有区域（从最初的发布时间算起）。

选择 default 可安排这些更新，使其对你造成的影响最小。可使用每周发布跟踪器按区域监视正在进行的 AKS 发布的状态。
aksManagedAutoUpgradeSchedule 控制何时执行由指定的自动升级通道计划的群集升级。与 default 配置相比，使用此设置可以配置控制更加精细的节奏和重复设置。有关群集自动升级的详细信息，请参阅自动升级 Azure Kubernetes 服务群集。
aksManagedNodeOSUpgradeSchedule 控制何时执行由节点 OS 自动升级通道计划的节点 OS 安全修补。与 default 配置相比，使用此配置可以更精细地控制频率和定期设置。有关节点 OS 自动升级通道的详细信息，请参阅自动修补和更新 AKS 群集节点映像。

建议对所有群集升级方案使用 aksManagedAutoUpgradeSchedule，对所有节点 OS 安全修补方案使用 aksManagedNodeOSUpgradeSchedule。

default 专用于 AKS 每周发布。可以使用 default 命令将 aksManagedAutoUpgradeSchedule 配置切换为 aksManagedNodeOSUpgradeSchedule 或 az aks maintenanceconfiguration update 配置。

创建维护时段

注意

使用自动升级时，为了确保正常运行，请使用持续时间为 4 小时或 4 小时以上的维护时段。

计划内维护时段以协调世界时 (UTC) 方式指定。

default 维护时段具有以下旧属性（不再推荐）：

名称	说明	默认值
`timeInWeek`	在 `default` 配置中，此属性包含定义维护时段的 `day` 和 `hourSlots` 值。	不适用
`timeInWeek.day`	`default` 配置中要执行维护的一周中的某一天。	不适用
`timeInWeek.hourSlots`	`default` 配置中要在特定的一天执行维护的小时长的时间槽列表。	不适用
`notAllowedTime`	维护无法运行的日期范围，由 `start` 和 `end` 子属性确定。仅当你使用配置文件创建维护时段时，此属性才适用。	不适用

注意

从 2023-05-01 API 版本开始，请使用以下属性进行 default 配置。

从 2023-05-01 API 版本开始，aksManagedAutoUpgradeSchedule 或 aksManagedNodeOSUpgradeSchedule 维护时段和 default 配置具有以下属性：

名称	说明	默认值
`utcOffset`	群集维护的时区。	`+00:00`
`startDate`	维护时段开始生效的日期。	创建时的当前日期
`startTime`	维护开始的时间，基于由 `utcOffset` 确定的时区。	不适用
`schedule`	升级频率。提供三种类型：`Weekly`、`AbsoluteMonthly` 和 `RelativeMonthly`。	不适用
`intervalDays`	维护运行的间隔（以天为单位）。它仅适用于 `aksManagedNodeOSUpgradeSchedule`。	不适用
`intervalWeeks`	维护运行的间隔（以周为单位）。	不适用
`intervalMonths`	维护运行的间隔（以月为单位）。	不适用
`dayOfWeek`	要开始维护的一周中的指定某一天。	不适用
`durationHours`	要运行维护的时段的持续时间。	不适用
`notAllowedDates`	维护无法运行的日期范围，由 `start` 和 `end` 子属性确定。仅当你使用配置文件创建维护时段时，它才适用。	不适用

计划类型

支持Daily四种计划类型，WeeklyAbsoluteMonthly以及RelativeMonthly。
下表显示了可用于每个维护配置选项的类型。

注释
从2025年6月开始，Daily计划类型也将为aksManagedClusterAutoUpgradeSchedule提供支持。

计划类型	`default`	`aksManagedClusterAutoUpgradeSchedule`	`aksManagedNodeOSUpgradeSchedule`
每日	?	? （2025年6月之后）	?
每周	?	?	?
AbsoluteMonthly	?	?	?
RelativeMonthly	?	?	?

为每个计划类型显示的所有字段都是必填字段。

Daily 计划可能类似于“每三天一次”：

"schedule": {
    "daily": {
        "intervalDays": 3
    }
}

Weekly 计划可能类似于“每两周一次，在星期五进行”：

"schedule": {
    "weekly": {
        "intervalWeeks": 2,
        "dayOfWeek": "Friday"
    }
}

AbsoluteMonthly 计划可能类似于“每三个月一次，在当月的第一天进行”：

"schedule": {
    "absoluteMonthly": {
        "intervalMonths": 3,
        "dayOfMonth": 1
    }
}

RelativeMonthly 计划可能类似于“每两个月一次，在最后一个星期一进行”：

"schedule": {
    "relativeMonthly": {
        "intervalMonths": 2,
        "dayOfWeek": "Monday",
        "weekIndex": "Last"
    }
}

weekIndex 的有效值包括 First、Second、Third、Fourth 和 Last。

添加维护时段配置

使用 az aks maintenanceconfiguration add 命令向 AKS 群集添加维护时段配置。

第一个示例添加一个新的 default 配置，该配置计划的维护在每星期一从凌晨 1:00 运行到凌晨 2:00。第二个示例添加一个新的 aksManagedAutoUpgradeSchedule 配置，该配置计划的维护每三周进行一次，在星期五的凌晨 0:00 到上午 8:00 之间运行（UTC+5:30 时区）。

# Add a new default configuration
az aks maintenanceconfiguration add --resource-group myResourceGroup --cluster-name myAKSCluster --name default --weekday Monday --start-hour 1

# Add a new aksManagedAutoUpgradeSchedule configuration
az aks maintenanceconfiguration add --resource-group myResourceGroup --cluster-name myAKSCluster --name aksManagedAutoUpgradeSchedule --schedule-type Weekly --day-of-week Friday --interval-weeks 3 --duration 8 --utc-offset +05:30 --start-time 00:00

注意

使用 default 配置类型时，可以省略 --start-time 参数，这样就可以在一天内随时进行维护。

可以使用 JSON 文件而不是参数来创建维护配置。使用此方法时，可以通过为 notAllowedTimes 配置指定 default 并为 notAllowedDates 配置指定 aksManagedAutoUpgradeSchedule 来防止在某个日期范围内进行维护。

使用维护时段设置创建 JSON 文件。

以下示例创建一个 default.json 文件，该文件计划的维护在每星期二和星期三从凌晨 1:00 运行到凌晨 3:00（UTC 时区）。此外，从 2021-05-26T03:00:00Z 到 2021-05-30T12:00:00Z 是一个例外时段，即使该时段与维护时段重叠，也不允许在该时段进行维护。

{
  "timeInWeek": [
    {
      "day": "Tuesday",
      "hour_slots": [
        1,
        2
      ]
    },
    {
      "day": "Wednesday",
      "hour_slots": [
        1,
        6
      ]
    }
  ],
  "notAllowedTime": [
    {
      "start": "2021-05-26T03:00:00Z",
      "end": "2021-05-30T12:00:00Z"
    }
  ]
}

以下示例创建一个 autoUpgradeWindow.json 文件，该文件计划的维护每三个月运行一次，在当月第一天的上午 9:00 到下午 1:00 之间运行（UTC-08 时区）。此外，从 2023-12-23 到 2024-01-05 是一个例外时段，即使该时段与维护时段重叠，也不允许在该时段进行维护。

{
  "properties": {
    "maintenanceWindow": {
        "schedule": {
            "absoluteMonthly": {
                "intervalMonths": 3,
                "dayOfMonth": 1
            }
        },
        "durationHours": 4,
        "utcOffset": "-08:00",
        "startTime": "09:00",
        "notAllowedDates": [
            {
                "start": "2023-12-23",
                "end": "2024-01-05"
            }
        ]
    }
  }
}

配合使用 az aks maintenanceconfiguration add 命令和 --config-file 参数添加维护时段配置。

第一个示例使用 default 文件添加一个新的 default.json 配置。第二个示例使用 aksManagedAutoUpgradeSchedule 文件添加一个新的 autoUpgradeWindow.json 配置。

# Add a new default configuration
az aks maintenanceconfiguration add -g myResourceGroup --cluster-name myAKSCluster --name default --config-file ./default.json

# Add a new aksManagedAutoUpgradeSchedule configuration
az aks maintenanceconfiguration add -g myResourceGroup --cluster-name myAKSCluster --name aksManagedAutoUpgradeSchedule --config-file ./autoUpgradeWindow.json

更新现有的维护时段

使用 az aks maintenanceconfiguration update 命令更新现有的维护配置。

以下示例将 default 配置更新为让计划的维护在每星期一从凌晨 2:00 运行到凌晨 3:00：

az aks maintenanceconfiguration update --resource-group myResourceGroup --cluster-name myAKSCluster --name default --weekday Monday --start-hour 2

使用新的维护时段设置更新配置 JSON 文件。

以下示例将default.json的文件更新为让计划的维护在每星期一从凌晨 2:00 运行到凌晨 3:00：

{
  "timeInWeek": [
    {
      "day": "Monday",
      "hour_slots": [
        2,
        3
      ]
    }
  ],
  "notAllowedTime": [
    {
      "start": "2021-05-26T03:00:00Z",
      "end": "2021-05-30T12:00:00Z"
    }
  ]
}

配合使用 az aks maintenanceconfiguration update 命令和 --config-file 参数更新维护时段配置：

az aks maintenanceconfiguration update --resource-group myResourceGroup --cluster-name myAKSCluster --name default --config-file ./default.json

在现有群集中列出所有维护时段

使用 az aks maintenanceconfiguration list 命令列出 AKS 群集中的当前维护配置时段：

az aks maintenanceconfiguration list --resource-group myResourceGroup --cluster-name myAKSCluster

显示现有群集中的特定维护配置时段

配合使用 az aks maintenanceconfiguration show 命令和 --name 参数查看 AKS 群集中的特定维护配置时段：

az aks maintenanceconfiguration show --resource-group myResourceGroup --cluster-name myAKSCluster --name aksManagedAutoUpgradeSchedule

以下示例输出显示了 aksManagedAutoUpgradeSchedule 的维护时段：

{
  "id": "/subscriptions/<subscription>/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster/maintenanceConfigurations/aksManagedAutoUpgradeSchedule",
  "maintenanceWindow": {
    "durationHours": 4,
    "notAllowedDates": [
      {
        "end": "2024-01-05",
        "start": "2023-12-23"
      }
    ],
    "schedule": {
      "absoluteMonthly": {
        "dayOfMonth": 1,
        "intervalMonths": 3
      },
      "daily": null,
      "relativeMonthly": null,
      "weekly": null
    },
    "startDate": "2023-01-20",
    "startTime": "09:00",
    "utcOffset": "-08:00"
  },
  "name": "aksManagedAutoUpgradeSchedule",
  "notAllowedTime": null,
  "resourceGroup": "myResourceGroup",
  "systemData": null,
  "timeInWeek": null,
  "type": null
}

删除现有群集中的维护配置时段

使用 az aks maintenanceconfiguration delete 命令删除 AKS 群集中的维护配置时段。

以下示例删除 autoUpgradeSchedule 维护配置：

az aks maintenanceconfiguration delete --resource-group myResourceGroup --cluster-name myAKSCluster --name autoUpgradeSchedule