Skip to content

Commit 836bf3f

Browse files
Merge pull request #279528 from hilaryw29/patch-27
[Updated] Remove Preview tags for repairAction on Automatic Instance …
2 parents 99f51c5 + dcffc8a commit 836bf3f

File tree

1 file changed

+5
-35
lines changed

1 file changed

+5
-35
lines changed

articles/virtual-machine-scale-sets/virtual-machine-scale-sets-automatic-instance-repairs.md

Lines changed: 5 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -6,19 +6,14 @@ ms.author: jushiman
66
ms.topic: conceptual
77
ms.service: azure-virtual-machine-scale-sets
88
ms.subservice: instance-protection
9-
ms.date: 06/14/2024
9+
ms.date: 08/09/2024
1010
ms.reviewer: mimckitt
1111
ms.custom: devx-track-azurecli, devx-track-azurepowershell
1212
---
1313

1414
# Automatic instance repairs for Azure Virtual Machine Scale Sets
1515

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.
2217

2318
## Requirements for using automatic instance repairs
2419

@@ -36,7 +31,7 @@ For instances marked as "Unhealthy" or "Unknown" (*Unknown* state is only availa
3631

3732
Automatic repairs policy is supported for compute API version 2018-10-01 or higher.
3833

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.
4035

4136
**Restrictions on resource or subscription moves**
4237

@@ -64,11 +59,7 @@ The automatic instance repairs process goes as follows:
6459

6560
### Available repair actions
6661

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.
7263

7364
- **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.
7465

@@ -80,7 +71,7 @@ The following table compares the differences between all three repair actions:
8071

8172
| Repair action | VM instance ID preserved? | Private IP preserved? | Managed data disk preserved? | Managed OS disk preserved? | Local (temporary) disk preserved? |
8273
|--|--|--|--|--|--|
83-
| Replace | No | No | No | No | No |
74+
| Replace (default) | No | No | No | No | No |
8475
| Reimage | Yes | Yes | Yes | No | Yes |
8576
| Restart | Yes | Yes | Yes | Yes | Yes |
8677

@@ -272,29 +263,8 @@ az vmss update \
272263

273264
---
274265

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
283-
```
284-
### [Azure PowerShell](#tab/powershell-3)
285-
286-
```azurepowershell-interactive
287-
Register-AzProviderFeature -FeatureName "AutomaticRepairsWithConfigurableRepairActions" -ProviderNamespace "Microsoft.Compute"
288-
```
289-
290-
---
291-
292266
## Configure a repair action on automatic repairs policy
293267

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-
298268
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.
299269

300270
### [REST API](#tab/rest-api-4)

0 commit comments

Comments
 (0)