Skip to content

Commit bd9d353

Browse files
committed
included scopes
changed the overview doc to include the various maintenance scopes maintenance configurations currently offer
1 parent 4b12f90 commit bd9d353

File tree

2 files changed

+40
-16
lines changed

2 files changed

+40
-16
lines changed

articles/virtual-machines/maintenance-configurations-portal.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ With Maintenance Configurations, you can now take more control over when to appl
3232
1. In the Basics tab, choose a subscription and resource group, provide a name for the configuration, choose a region, and select one of the scopes we offer which you wish to apply updates for. Click **Add a schedule** to add or modify the schedule for your configuration.
3333

3434
> [!IMPORTANT]
35-
> There are different **scopes** which support certain machine types and schedules, so please ensure you are selecting the right scope for your virtual machine.
35+
> There are different [scopes](maintenance-configurations.md#scopes) which support certain machine types and schedules, so please ensure you are selecting the right scope for your virtual machine.
3636
3737
:::image type="content" source="media/virtual-machines-maintenance-control-portal/maintenance-configurations-basics-tab.png" alt-text="Screenshot showing Maintenance Configuration basics":::
3838

articles/virtual-machines/maintenance-configurations.md

Lines changed: 39 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -8,30 +8,54 @@ ms.topic: conceptual
88
ms.workload: infrastructure-services
99
ms.date: 10/06/2021
1010
ms.author: cynthn
11-
#pmcontact: shants
11+
#pmcontact: pphillips
1212
---
1313

14-
# Managing platform updates with Maintenance Configurations
14+
# Managing VM updates with Maintenance Configurations
1515

16-
**Applies to:** :heavy_check_mark: Linux VMs :heavy_check_mark: Windows VMs :heavy_check_mark: Flexible scale sets :heavy_check_mark: Uniform scale sets
16+
**Applies to:** :heavy_check_mark: Linux VMs :heavy_check_mark: Windows VMs :heavy_check_mark: Flexible scale sets :heavy_check_mark: Uniform scale sets :heavy_check_mark: Azure Arc Enabled Servers
1717

18-
Manage platform updates, that don't require a reboot, using Maintenance Configurations. Azure frequently updates its infrastructure to improve reliability, performance, security or launch new features. Most updates are transparent to users. Some sensitive workloads, like gaming, media streaming, and financial transactions, can't tolerate even few seconds of a VM freezing or disconnecting for maintenance. Creating a Maintenance Configuration gives you the option to wait on platform updates and apply them within a 35-day rolling window.
18+
Maintenance Configurations give you the ability to control and manage updates for many Azure virtual machine resources since Azure frequently updates its infrastructure to improve reliability, performance, security or launch new features. Most updates are transparent to users, but some sensitive workloads, like gaming, media streaming, and financial transactions, can't tolerate even few seconds of a VM freezing or disconnecting for maintenance. Maintenance configurations is integrated with Azure Resource Graph (ARG) for low latency and high scale customer experience.
1919

20+
>[!IMPORTANT]
21+
> Users are required to have a role of at least contributor in order to use maintenance configurations.
2022
21-
With Maintenance Configurations, you can:
22-
- Batch updates into one update package.
23-
- Wait up to 35 days to apply updates for **Host** machines.
24-
- Automate platform updates by configuring your maintenance schedule.
25-
- Maintenance Configurations work across subscriptions and resource groups.
23+
## Scopes
2624

27-
## Limitations
25+
Maintenance Configurations currently supports three (3) scopes: Host, OS image and Guest. While each scope allows scheduling and managing updates, the major difference lies in the resource they each support. This section outlines the details on the various scopes and their supported types:
2826

29-
- Maintenance window duration can vary month over month and sometimes it can take up to 2 hours to apply the pending updates once it is initiated by the user.
30-
- After 35 days, an update will automatically be applied to your **Host** machines.
31-
- Rack level maintenance cannot be controlled through maintenance configurations.
32-
- User must have **Resource Contributor** access.
33-
- Users need to know the nuances of the scopes required for their machine.
3427

28+
| Scope | Support Resources |
29+
|----------|----------------------------|
30+
| Host | Isolated Virtual Machines, Isolated Virtual Machine Scale Sets, Dedicated Hosts |
31+
| OS Image | Virtual Machine Scale Sets |
32+
| Guest | Virtual Machines, Azure Arc Servers |
33+
34+
35+
### Host
36+
With this scope, you can manage platform updates that do not require a reboot on your *isolated VMs*, *isolated VM Scale Set instances* and *dedicated hosts*. Some features and limitations unique to the host scope are:
37+
38+
- Schedules can be set anytime within 35 days. After 35 days, updates are automatically applied.
39+
- A minimum of a 2 hour maintenance window is required for this scope.
40+
41+
[Learn more about Azure Dedicated Hosts](dedicated-hosts.md)
42+
43+
### OS image
44+
Using this scope with maintenance configurations lets you decide when to apply upgrades to OS disks in your *virtual machine scale sets* through an easier and more predictable experience. An upgrade works by replacing the OS disk of a VM with a new disk created using the latest image version. Any configured extensions and custom data scripts are run on the OS disk, while data disks are retained. Some features and limitations unique to this scope are:
45+
46+
- Scale sets need to have [automatic OS upgrades](/articles/virtual-machine-scale-sets/virtual-machine-scale-sets-automatic-upgrade.md) enabled in order to use maintenance configurations.
47+
- Schedule recurrence is defaulted to daily
48+
- A minimum of 5 hours is required for the maintenance window
49+
50+
### Guest
51+
This scope is integrated with [Azure Update Management Center](https://github.com/Azure/update-center-docs/blob/main/Docs/overview.md) which allows you to save recurring deployment schedules to install operating system updates for your Windows Server and Linux machines in Azure, in on-premises environments, and in other cloud environments connected using Azure Arc-enabled servers. Some features and limitations unique to this scope include:
52+
53+
- [Patch orchestration](automatic-vm-guest-patching.md#patch-orchestration-modes) for virtual machines need to be set to AutomaticByPlatform
54+
- A minimum of 3 hours and 55 minutes is required for the maintenance window
55+
- There is no limit to the recurrence of your schedule
56+
57+
[Learn more about update management center and scheduled patching](https://github.com/Azure/update-center-docs/blob/main/Docs/scheduled-patching.md)
58+
3559
## Management options
3660

3761
You can create and manage maintenance configurations using any of the following options:

0 commit comments

Comments
 (0)