You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Automatic instance repairs for Azure Virtual Machine Scale Sets
15
15
16
-
> [!IMPORTANT]
17
-
> The **Reimage** and **Restart** repair actions are currently in PREVIEW.
18
-
> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability. Some aspects of this feature may change prior to general availability (GA).
19
-
20
-
21
-
Enabling automatic instance repairs for Azure Virtual Machine Scale Sets helps achieve high availability for applications by maintaining a set of healthy instances. If an unhealthy instance is found by [Application Health extension](./virtual-machine-scale-sets-health-extension.md) or [Load balancer health probes](../load-balancer/load-balancer-custom-probe-overview.md), automatic instance repairs will attempt to recover the instance by triggering repair actions such as deleting the unhealthy instance and creating a new one to replace it, reimaging the unhealthy instance (Preview), or restarting the unhealthy instance (Preview).
16
+
Enabling automatic instance repairs for Azure Virtual Machine Scale Sets helps achieve high availability for applications by maintaining a set of healthy instances. If an unhealthy instance is found by [Application Health extension](./virtual-machine-scale-sets-health-extension.md) or [Load balancer health probes](../load-balancer/load-balancer-custom-probe-overview.md), automatic instance repairs will attempt to recover the instance by triggering repair actions such as deleting the unhealthy instance and creating a new one to replace it, reimaging the unhealthy instance, or restarting the unhealthy instance.
22
17
23
18
## Requirements for using automatic instance repairs
24
19
@@ -36,7 +31,7 @@ For instances marked as "Unhealthy" or "Unknown" (*Unknown* state is only availa
36
31
37
32
Automatic repairs policy is supported for compute API version 2018-10-01 or higher.
38
33
39
-
The `repairAction` setting for Reimage (Preview) and Restart (Preview) is supported for compute API versions 2021-11-01 or higher.
34
+
The `repairAction` setting for Reimage and Restart is supported for compute API versions 2021-11-01 or higher.
40
35
41
36
**Restrictions on resource or subscription moves**
42
37
@@ -64,11 +59,7 @@ The automatic instance repairs process goes as follows:
64
59
65
60
### Available repair actions
66
61
67
-
> [!CAUTION]
68
-
> The `repairAction` setting, is currently under PREVIEW and not suitable for production workloads. To preview the **Restart** and **Reimage** repair actions, you must register your Azure subscription with the AFEC flag `AutomaticRepairsWithConfigurableRepairActions` and your compute API version must be 2021-11-01 or higher.
69
-
> For more information, see [feature registration](#feature-registration).
70
-
71
-
There are three available repair actions for automatic instance repairs – Replace, Reimage (Preview), and Restart (Preview). The default repair action is Replace, but you can switch to Reimage (Preview) or Restart (Preview) by enrolling in the preview and modifying the `repairAction` setting under `automaticRepairsPolicy` object.
62
+
There are three available repair actions for automatic instance repairs – Replace, Reimage, and Restart. The default repair action is Replace, but you can configure automatic repairs to use Reimage or Restart by modifying the `repairAction` setting under `automaticRepairsPolicy` object.
72
63
73
64
-**Replace** deletes the unhealthy instance and creates a new instance to replace it. The latest Virtual Machine Scale Set model is used to create the new instance. This repair action is the default.
74
65
@@ -80,7 +71,7 @@ The following table compares the differences between all three repair actions:
80
71
81
72
| Repair action | VM instance ID preserved? | Private IP preserved? | Managed data disk preserved? | Managed OS disk preserved? | Local (temporary) disk preserved? |
82
73
|--|--|--|--|--|--|
83
-
| Replace | No | No | No | No | No |
74
+
| Replace (default) | No | No | No | No | No |
84
75
| Reimage | Yes | Yes | Yes | No | Yes |
85
76
| Restart | Yes | Yes | Yes | Yes | Yes |
86
77
@@ -272,29 +263,8 @@ az vmss update \
272
263
273
264
---
274
265
275
-
## Feature Registration
276
-
277
-
Before configuring `repairAction` setting under `automaticRepairsPolicy`, register the feature providers to your subscription.
278
-
279
-
### [Azure CLI](#tab/cli-3)
280
-
281
-
```azurecli-interactive
282
-
az feature register --name AutomaticRepairsWithConfigurableRepairActions --namespace Microsoft.Compute
## Configure a repair action on automatic repairs policy
293
267
294
-
> [!CAUTION]
295
-
> The `repairAction` setting, is currently under PREVIEW and not suitable for production workloads. To preview the **Restart** and **Reimage** repair actions, you must register your Azure subscription with the AFEC flag `AutomaticRepairsWithConfigurableRepairActions` and your compute API version must be 2021-11-01 or higher.
296
-
> For more information, see [feature registration](#feature-registration).
297
-
298
268
The `repairAction` setting under `automaticRepairsPolicy` allows you to specify the desired repair action performed in response to an unhealthy instance. If you are updating the repair action on an existing automatic repairs policy, you must first disable automatic repairs on the scale set and re-enable with the updated repair action. This process is illustrated in the examples below.
0 commit comments