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

使用 az aks maintenanceconfiguration add 命令将维护窗口配置添加到 AKS 群集。

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

# Add a new default configuration
az aks maintenanceconfiguration add --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name default --schedule-type Weekly --day-of-week Monday --interval-weeks 1 --duration 4 --utc-offset +00:00 --start-time 01:00

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

1. 在 Azure 门户中，导航到 AKS 群集资源。

2. 在服务菜单中的 “设置”下，选择“ 升级”。

3. 在“升级”“自动升级计划程序”下，选择“添加计划”>。

   

4. 在“添加维护计划”窗格上，配置以下维护时段设置：

   • 重复：选择维护时段的频率。 我们建议选择“每周”。
   • 频率：为维护时段选择一周中的某一天。 我们建议选择“周日”。
   • 维护开始日期：选择维护时段开始日期。
   • 维护开始时间：选择维护时段开始时间。
   • 选择维护时段的 UTC 偏移量。 默认值为+00:00。

   

5. 选择“保存”。

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

1. 使用维护窗口设置创建 JSON 文件。

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

   {
     "properties": {
       "maintenanceWindow": {
           "schedule": {
               "weekly": {
                   "intervalWeeks": 1,
                   "dayOfWeek": "Tuesday"
               }
           },
           "durationHours": 4,
           "utcOffset": "+00:00",
           "startTime": "01:00",
           "notAllowedDates": [
               {
                   "start": "2021-05-26",
                   "end": "2021-05-30"
               }
           ]
       }
     }
   }
   

   以下示例创建一个 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"
               }
           ]
       }
     }
   }
   

2. 使用具有参数的az aks maintenanceconfiguration add--config-file命令添加维护时段配置。

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

   # Add a new default configuration
   az aks maintenanceconfiguration add --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name default --config-file ./default.json
   
   # Add a new aksManagedAutoUpgradeSchedule configuration
   az aks maintenanceconfiguration add --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name aksManagedAutoUpgradeSchedule --config-file ./autoUpgradeWindow.json
   

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

以下示例将 default 配置更新为安排每周五凌晨 2:00 到 6:00 进行的维护操作：

az aks maintenanceconfiguration update --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name default --schedule-type Weekly --day-of-week Friday --interval-weeks 1 --duration 4 --utc-offset +00:00 --start-time 02:00

1. 在 Azure 门户中，导航到你的 AKS 群集资源。

2. 在服务菜单中的 “设置”下，选择“ 升级”。

3. 在“升级”“自动升级计划程序”下，选择“编辑计划”>。

   

4. 在“编辑维护计划”窗格中，根据需要更新维护窗口设置。

5. 选择“保存”。

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

   以下示例将default.json中的文件更新以安排维护计划，该计划将在每周一的凌晨 2:00 到上午 6:00 运行：

   {
     "properties": {
       "maintenanceWindow": {
           "schedule": {
               "weekly": {
                   "intervalWeeks": 1,
                   "dayOfWeek": "Monday"
               }
           },
           "durationHours": 4,
           "utcOffset": "+00:00",
           "startTime": "02:00",
           "notAllowedDates": [
               {
                   "start": "2021-05-26",
                   "end": "2021-05-30"
               }
           ]
       }
     }
   }
   

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

   az aks maintenanceconfiguration update --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name default --config-file ./default.json
   

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

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

az aks maintenanceconfiguration delete --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name autoUpgradeSchedule

1. 在 Azure 门户中，导航到你的 AKS 群集资源。

2. 在服务菜单中的“设置”下，选择“群集配置”。

3. 在“升级”“自动升级计划程序”下，选择“编辑计划”>。

   

4. 在“编辑维护计划”窗格上，选择“删除计划”。

   

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

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

az aks maintenanceconfiguration delete --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name autoUpgradeSchedule