Merge pull request #228424 from ju-shim/spot-mix-ga

v-stsavell · web-flow · commit 34b8f20c4c1a · 2023-03-09T16:00:45.000-06:00
Spot Priority Mix - GA
diff --git a/articles/virtual-machine-scale-sets/TOC.yml b/articles/virtual-machine-scale-sets/TOC.yml
@@ -106,7 +106,7 @@
   items: 
   - name: Azure Spot Virtual Machines
     href: use-spot.md
-  - name: Spot Priority Mix (preview)
+  - name: Spot Priority Mix
     href: spot-priority-mix.md
   - name: Reserved instances
     href: ../cost-management-billing/reservations/save-compute-costs-reservations.md
diff --git a/articles/virtual-machine-scale-sets/spot-priority-mix.md b/articles/virtual-machine-scale-sets/spot-priority-mix.md
@@ -1,36 +1,33 @@
 ---
 title: Get high availability and cost savings with Spot Priority Mix for Virtual Machine Scale Sets
-description: Learn how to run a mix of Spot VMs and uninterruptible regular VMs for Virtual Machine Scale Sets to achieve high availability and cost savings.
+description: Learn how to run a mix of Spot VMs and uninterruptible standard VMs for Virtual Machine Scale Sets to achieve high availability and cost savings.
 author: ju-shim
 ms.author: jushiman
 ms.service: virtual-machine-scale-sets
 ms.subservice: spot
 ms.workload: infrastructure-services
 ms.topic: conceptual
-ms.date: 11/22/2022
+ms.date: 03/09/2023
 ms.reviewer: cynthn
 ms.custom: engagement-fy23
 ---
 
-# Spot Priority Mix for high availability and cost savings (preview)
+# Spot Priority Mix for high availability and cost savings
 
 **Applies to:** :heavy_check_mark: Flexible scale sets 
 
-> [!IMPORTANT]
-> **Spot Priority Mix** is currently in public preview.
-> This preview version is provided without a service-level agreement, and we don't recommend it for production workloads. Certain features might not be supported or might have constrained capabilities. 
-> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
-
-Azure allows you to have the flexibility of running a mix of uninterruptible regular VMs and interruptible Spot VMs for Virtual Machine Scale Set deployments. You're able to deploy this Spot Priority Mix using Flexible orchestration to easily balance between high-capacity availability and lower infrastructure costs according to your workload requirements. This feature allows you to easily manage your scale set capability to achieve the following:
+Azure allows you to have the flexibility of running a mix of uninterruptible standard VMs and interruptible Spot VMs for Virtual Machine Scale Set deployments. You're able to deploy this Spot Priority Mix using Flexible orchestration to easily balance between high-capacity availability and lower infrastructure costs according to your workload requirements. This feature allows you to easily manage your scale set capability to achieve the following goals:
 
 - Reduce compute infrastructure costs by applying the deep discounts of Spot VMs
-- Maintain capacity availability through uninterruptible regular VMs in the scale set deployment
+- Maintain capacity availability through uninterruptible standard VMs in the scale set deployment
 - Provide reassurance that all your VMs won't be taken away simultaneously due to evictions before the infrastructure has time to react and recover the evicted capacity
-- Simplify the scale-out and scale-in of compute workloads that require both Spot and regular VMs by letting Azure orchestrate the creation and deletion of VMs
+- Simplify the scale-out and scale-in of compute workloads that require both Spot and standard VMs by letting Azure orchestrate the creation and deletion of VMs
+
+## Configure your mix
 
-You can configure a custom percentage distribution across Spot and regular VMs. The platform automatically orchestrates each scale-out and scale-in operation to achieve the desired distribution by selecting an appropriate number of VMs to create or delete. You can also optionally configure the number of base regular uninterruptible VMs you would like to maintain in the Virtual Machine Scale Set during any scale operation.
+You can configure a custom percentage distribution across Spot and standard VMs. The platform automatically orchestrates each scale-out and scale-in operation to achieve the desired distribution by selecting an appropriate number of VMs to create or delete. You can also optionally configure the number of base standard VMs you would like to maintain in the Virtual Machine Scale Set during any scale operation.
 
-## [Template](#tab/template-1)
+### [Template](#tab/template-1)
 
 You can set your Spot Priority Mix by using a template to add the following properties to a scale set with Flexible orchestration using a Spot priority VM profile:
 
@@ -42,28 +39,25 @@ You can set your Spot Priority Mix by using a template to add the following prop
 ```
 
 **Parameters:**
-- `baseRegularPriorityCount` – Specifies a base number of VMs that will be *Regular* priority; if the Scale Set capacity is at or below this number, all VMs will be *Regular* priority.
-- `regularPriorityPercentageAboveBase` – Specifies the percentage split of *Regular* and *Spot* priority VMs that will be used when the Scale Set capacity is above the *baseRegularPriorityCount*.
+- `baseRegularPriorityCount` – Specifies a base number of VMs that are standard, *Regular* priority; if the Scale Set capacity is at or below this number, all VMs are *Regular* priority.
+- `regularPriorityPercentageAboveBase` – Specifies the percentage split of *Regular* and *Spot* priority VMs that are used when the Scale Set capacity is above the *baseRegularPriorityCount*.
 
 You can refer to this [ARM template example](https://paste.microsoft.com/f84d2f83-f6bf-4d24-aa03-175b0c43da32) for more context.
 
-## [Portal](#tab/portal-1) 
+### [Portal](#tab/portal-1) 
 
-You can set your Spot Priority Mix in the Scaling tab of the Virtual Machine Scale Sets creation process in the Azure portal. The following steps will instruct you on how to access this feature during that process. 
+You can set your Spot Priority Mix in the Scaling tab of the Virtual Machine Scale Sets creation process in the Azure portal. The following steps instruct you on how to access this feature during that process. 
 
 1. Log in to the [Azure portal](https://portal.azure.com).
 1. In the search bar, search for and select **Virtual Machine Scale Sets**.
 1. Select **Create** on the **Virtual Machine Scale Sets** page.
-1. In the **Basics** tab, fill out the required fields and select **Flexible** as the **Orchestration** mode.
+1. In the **Basics** tab, fill out the required fields, select **Flexible** as the **Orchestration** mode, and select the checkbox for **Run with Azure Spot discount**.
 1. Fill out the **Disks** and **Networking** tabs.
-1. In the **Scaling** tab, select the check-box next to *Scale with VMs and Spot VMs* option under the **Scale with VMs and discounted Spot VMs** section.
+1. In the **Spot** tab, select the check-box next to *Scale with VMs and Spot VMs* option under the **Scale with VMs and discounted Spot VMs** section.
 1. Fill out the **Base VM (uninterruptible) count** and **Instance distribution** fields to configure your priorities.
-
-    :::image type="content" source="./media/spot-priority-mix/scale-with-vms-and-discounted-spot-vms.png" alt-text="Screenshot of the Scale with VMs and discounted Spot VMs section in the Scaling tab within Azure portal.":::
-
 1. Continue through the Virtual Machine Scale Set creation process. 
 
-## [Azure CLI](#tab/cli-1)
+### [Azure CLI](#tab/cli-1)
 
 You can set your Spot Priority Mix using Azure CLI by setting the `priority` flag to `Spot` and including the `regular-priority-count` and `regular-priority-percentage` flags.  
 
@@ -81,7 +75,7 @@ az vmss create -n myScaleSet \
 		--single-placement-group False \
 ```
 
-## [Azure PowerShell](#tab/powershell-1)
+### [Azure PowerShell](#tab/powershell-1)
 
 You can set your Spot Priority Mix using Azure PowerShell by setting the `Priority` flag to `Spot` and including the `BaseRegularPriorityCount` and `RegularPriorityPercentage` flags.  
 
@@ -106,6 +100,76 @@ New-AzVmss `
 
 ---
 
+## Examples
+
+The following examples have scenario assumptions, a table of actions, and walk-through of results to help you understand how Spot Priority Mix configuration works. 
+
+Some important terminology to notice before referring to these examples:
+- **sku.capacity** is the total number of VMs in the Virtual Machine Scale Set
+- **Base (standard) VMs** are the number of standard non-Spot VMs, akin to a minimum VM number
+
+### Scenario 1
+
+The following scenario assumptions apply to this example:
+- **sku.capacity** is variable, as the autoscaler will add or remove VMs from the scale set
+- **Base (standard) VMs:** 10
+- **Extra standard VMs:** 0
+- **Spot priority VMs:** 0
+- **regularPriorityPercentageAboveBase:** 50%
+- **Eviction policy:** Delete
+
+| Action | sku.capacity | Base (standard) VMs | Extra standard VMs | Spot priority VMs |
+|---|---|---|---|---|
+| Create | 10 | 10 | 0 | 0 |
+| Scale out | 20 | 10 | 5 | 5 |
+| Scale out | 30 | 10 | 10 | 10 |
+| Scale out | 40 | 10 | 15 | 15 |
+| Scale out | 41 | 10 | 15 | 16 |
+| Scale out | 42 | 10 | 16 | 16 |
+| Evict-Delete (all Spot instances) | 26 | 10 | 16 | 0 |
+| Scale out | 30 | 10 | 16 | 4 |
+| Scale out | 42 | 10 | 16 | 16 |
+| Scale out | 44 | 10 | 17 | 17 |
+
+Example walk-through:
+1. You start out with a Virtual Machine Scale Set with 10 VMs.
+    - The `sku.capacity` is variable and doesn't set a starting number of VMs. The Base VMs are set at 10, thus your total starting VMs are just 10 Base (standard) VMs.
+1. You then scale-out 5 times, with 50% standard VMs and 50% Spot VMs.
+    - Note, because there's a 50/50 split, in the fourth scale-out, there's one more Spot VM than standard VM. Once it's scaled out again (5th scale-out), the 50/50 balance is restored with another standard VM.
+1. You then scale in your scale set with the eviction policy being delete, which deletes all the Spot VMs.
+1. With the scale-out operations mentioned in this scenario, you restore the 50/50 balance in your scale set by only creating Spot VMs.
+1. By the last scale-out, your scale set is already balanced, so one of each type of VM is created. 
+
+### Scenario 2
+
+The following scenario assumptions apply to this example:
+- **sku.capacity** is variable, defined by autoscaler; starting with 20
+- **Base (standard) VMs:** 10
+- **Extra standard VMs:** 2
+- **Spot priority VMs:** 8
+- **regularPriorityPercentageAboveBase:** 25%
+- **Eviction policy:** Deallocate
+
+| Action | sku.capacity | Base (standard) VMs | Extra standard VMs | Spot priority VMs |
+|---|---|---|---|---|
+| Create | 20 | 10 | 2 | 8 |
+| Scale out | 50 | 10 | 10 | 30 |
+| Scale out | 110 | 10 | 25 | 75 |
+| Evict-Delete (10 instances) | 100 | 10 | 25 | 75 (65 running VMs, 10 Stop-Deallocated VMs) |
+| Scale out | 120 | 10 | 27 | 83 (73 running VMs, 10 Stop-Deallocated VMs) |
+
+Example walk-through:
+1. With the initial creation of the Virtual Machine Scale Set and Spot Priority Mix, you have 20 VMs.
+    - 10 of those VMs are the Base (standard) VMs, 2 extra standard VMs, and 8 Spot priority VMs for your 25% *regularPriorityPercentageAboveBase*. 
+    - Another way to look at this ratio is you have 1 standard VM for every 4 Spot VMs in the scale set. 
+1. You then scale-out twice to create 90 more VMs; 23 standard VMs and 67 Spot VMs.
+1. When you scale in by 10 VMs, 10 Spot VMs are *stop-deallocated*, creating an imbalance in your scale set.
+1. Your next scale-out operation creates another 2 standard VMs and 8 Spot VMs, bringing you closer to your 25% above base ratio.
+
+## Troubleshooting 
+
+If Spot Priority Mix is not available to you, be sure to configure the `priorityMixPolicy` to specify a *Spot* priority in the `virtualMachineProfile`. Without that configuration, you will not be able to access this Spot feature.
+
 ## Next steps
 
 > [!div class="nextstepaction"]
