Configurer la mise à l’échelle automatique avec Azure PowerShell

La mise à l’échelle automatique permet de vérifier que la quantité appropriée de ressources s’exécute pour gérer la charge fluctuante de votre application. Vous pouvez configurer la mise à l’échelle automatique à l’aide du portail Azure, Azure CLI, Azure PowerShell, ou des modèles ARM ou Bicep.

Cet article vous montre comment configurer l’autoscale pour un ensemble d'échelles de machines virtuelles avec PowerShell. Les étapes de configuration sont les suivantes :

• Créez un groupe identique que vous pouvez automatiquement mettre à l’échelle.
• Créez des règles pour effectuer un scale-in et un scale-out.
• Créez un profil qui utilise vos règles.
• Appliquez les paramètres de mise à l’échelle automatique.
• Mettez à jour vos paramètres de mise à l’échelle automatique avec des notifications.

Prérequis

Il vous faut un compte Azure avec un abonnement actif pour configurer la mise à l’échelle automatique à l’aide de PowerShell. Vous pouvez créer un compte gratuitement.

Configurer votre environnement

# Set variables
$resourceGroupName = "<ResourceGroupName>"
$vmssName = "<VirtualMachineScaleSetName>"
$autoscaleName = "<AutoscaleSettingName>"
$azureRegion = "<AzureRegion>"
$virtualNetworkName = "<VirtualNetworkName>"
$subnetName = "<SubnetName>"
$publicIpAddressName = "<PublicIpAddressName>"
$loadBalancerName = "<LoadBalancerName>"

# Get the subscription ID from the current Azure PowerShell context
$subscriptionId = (Get-AzContext).Subscription.Id

# Build virtual machine scale set resource ID
$vmssPath = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName"
$vmssProvider = "Microsoft.Compute/virtualMachineScaleSets/$vmssName"
$vmssResourceId = "$vmssPath/providers/$vmssProvider"

Crée un groupe de machines virtuelles identiques

L’exemple Azure PowerShell suivant utilise les applets de commande New-AzVmss et New-AzResourceGroup.

# Create the resource group
New-AzResourceGroup -ResourceGroupName $resourceGroupName -Location $azureRegion

# Get credentials for the virtual machine scale set
$vmCredential = Get-Credential

# Define parameters for New-AzVmss
$newAzVmssParams = @{
    ResourceGroupName   = $resourceGroupName
    Location            = $azureRegion
    VMScaleSetName      = $vmssName
    Credential          = $vmCredential
    VirtualNetworkName  = $virtualNetworkName
    SubnetName          = $subnetName
    PublicIpAddressName = $publicIpAddressName
    LoadBalancerName   = $loadBalancerName
    OrchestrationMode  = "Flexible"
}

# Create the virtual machine scale set
New-AzVmss @newAzVmssParams

Créez des paramètres de mise à l’échelle automatique

Suivez la séquence ci-dessous pour créer un paramètre de mise à l’échelle automatique à l’aide de PowerShell :

1. Créez des règles à l’aide de New-AzAutoscaleScaleRuleObject.
2. Créez un profil à l’aide de New-AzAutoscaleProfileObject.
3. Créez les paramètres de mise à l’échelle automatique à l’aide de New-AzAutoscaleSetting.
4. Mettez à jour les paramètres à l’aide de Update-AzAutoscaleSetting.

Création de règles

Créez des règles de scale-in et de scale-out, puis associez-les à un profil.

L’exemple de Azure PowerShell suivant utilise l’applet New-AzAutoscaleScaleRuleObject de commande.

# Define parameters for New-AzAutoscaleScaleRuleObject
$newAzAutoscaleScaleRuleObjectParams = @{
    MetricTriggerMetricName        = "Percentage CPU"
    MetricTriggerMetricResourceUri  = $vmssResourceId
    MetricTriggerTimeGrain          = New-TimeSpan -Minutes 1
    MetricTriggerStatistic         = "Average"
    MetricTriggerTimeWindow         = New-TimeSpan -Minutes 5
    MetricTriggerTimeAggregation    = "Average"
    MetricTriggerOperator          = "GreaterThan"
    MetricTriggerThreshold         = 70
    MetricTriggerDividePerInstance = $false
    ScaleActionDirection           = "Increase"
    ScaleActionType                = "ChangeCount"
    ScaleActionValue               = "1"
    ScaleActionCooldown            = New-TimeSpan -Minutes 5
}
$scaleOutRule = New-AzAutoscaleScaleRuleObject @newAzAutoscaleScaleRuleObjectParams

# Define parameters for New-AzAutoscaleScaleRuleObject
$newAzAutoscaleScaleRuleObjectParams = @{
    MetricTriggerMetricName        = "Percentage CPU"
    MetricTriggerMetricResourceUri  = $vmssResourceId
    MetricTriggerTimeGrain          = New-TimeSpan -Minutes 1
    MetricTriggerStatistic         = "Average"
    MetricTriggerTimeWindow         = New-TimeSpan -Minutes 5
    MetricTriggerTimeAggregation    = "Average"
    MetricTriggerOperator          = "LessThan"
    MetricTriggerThreshold         = 30
    MetricTriggerDividePerInstance = $false
    ScaleActionDirection           = "Decrease"
    ScaleActionType                = "ChangeCount"
    ScaleActionValue               = "1"
    ScaleActionCooldown            = New-TimeSpan -Minutes 5
}
$scaleInRule = New-AzAutoscaleScaleRuleObject @newAzAutoscaleScaleRuleObjectParams

Le tableau suivant décrit les paramètres utilisés dans la cmdlet New-AzAutoscaleScaleRuleObject.

Créer un profil de mise à l’échelle automatique par défaut et associer les règles

Après avoir défini les règles d’échelle, créez un profil. Le profil spécifie les limites du nombre d’instances par défaut, supérieures et inférieures, ainsi que les heures auxquelles les règles associées peuvent être appliquées.

L’exemple de Azure PowerShell suivant utilise l’applet New-AzAutoscaleProfileObject de commande.

# Define parameters for New-AzAutoscaleProfileObject
$newAzAutoscaleProfileObjectParams = @{
    Name            = "default"
    CapacityDefault = "1"
    CapacityMaximum = "10"
    CapacityMinimum = "1"
    Rule            = @($scaleOutRule, $scaleInRule)
}
$defaultProfile = New-AzAutoscaleProfileObject @newAzAutoscaleProfileObjectParams

Le tableau suivant décrit les paramètres utilisés dans la cmdlet New-AzAutoscaleProfileObject.

Appliquez les paramètres de mise à l’échelle automatique

Après avoir défini les règles et le profil, appliquez les paramètres de mise à l’échelle automatique. Pour mettre à jour un paramètre de mise à l’échelle automatique existant, utilisez Update-AzAutoscaleSetting.

L’exemple de Azure PowerShell suivant utilise l’applet New-AzAutoscaleSetting de commande.

# Define parameters for New-AzAutoscaleSetting
$newAzAutoscaleSettingParams = @{
    Name              = $autoscaleName
    ResourceGroupName = $resourceGroupName
    Location          = $azureRegion
    Profile           = @($defaultProfile)
    Enabled           = $true
    PropertiesName    = $autoscaleName
    TargetResourceUri = $vmssResourceId
}

# Create the autoscale setting
New-AzAutoscaleSetting @newAzAutoscaleSettingParams

Ajoutez des notifications à vos paramètres de mise à l’échelle automatique

Ajoutez des notifications à votre paramètre de mise à l’échelle automatique pour déclencher un webhook ou envoyer des notifications par e-mail lorsqu’un événement de mise à l’échelle se produit.

L’exemple de Azure PowerShell suivant utilise l’applet New-AzAutoscaleWebhookNotificationObject de commande.

# Set variables
$webhookUri = "<WebhookUri>"

# Create the webhook notification
$webhook = New-AzAutoscaleWebhookNotificationObject -Property @{} -ServiceUri $webhookUri

L’exemple Azure PowerShell suivant utilise le cmdlet New-AzAutoscaleNotificationObject pour configurer le webhook et les notifications par e-mail.

# Set variables
$notificationEmail = "<NotificationEmail>"

# Define parameters for New-AzAutoscaleNotificationObject
$newAzAutoscaleNotificationObjectParams = @{
    EmailCustomEmail                      = @($notificationEmail)
    EmailSendToSubscriptionAdministrator   = $true
    EmailSendToSubscriptionCoAdministrator = $true
    Webhook                               = @($webhook)
}
$notification = New-AzAutoscaleNotificationObject @newAzAutoscaleNotificationObjectParams

L’exemple Azure PowerShell suivant utilise le cmdlet Update-AzAutoscaleSetting pour appliquer la notification.

# Define parameters for Update-AzAutoscaleSetting
$updateAzAutoscaleSettingParams = @{
    Name              = $autoscaleName
    ResourceGroupName = $resourceGroupName
    Notification      = @($notification)
}

# Update the autoscale notification
Update-AzAutoscaleSetting @updateAzAutoscaleSettingParams

Passez vos paramètres de mise à l’échelle automatique en revue

L’exemple Azure PowerShell suivant utilise le cmdlet Get-AzAutoscaleSetting pour récupérer la configuration de mise à l’échelle automatique.

# Define parameters for Get-AzAutoscaleSetting
$getAzAutoscaleSettingParams = @{
    ResourceGroupName = $resourceGroupName
    Name              = $autoscaleName
}
$autoscaleSetting = Get-AzAutoscaleSetting @getAzAutoscaleSettingParams
$autoscaleSetting | Select-Object -Property *

L’exemple de Azure PowerShell suivant utilise l’applet Get-AzAutoscaleHistory de commande.

# Build autoscale setting resource ID
$autoscalePath = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName"
$autoscaleProvider = "Microsoft.Insights/autoscaleSettings/$autoscaleName"
$autoscaleResourceId = "$autoscalePath/providers/$autoscaleProvider"

# Retrieve the autoscale history
Get-AzAutoscaleHistory -ResourceId $autoscaleResourceId

Profils planifiés et récurrents

Ajouter un profil planifié pour un événement spécial

Configurez des profils de mise à l’échelle automatique pour qu’ils évoluent différemment selon des événements spécifiques. Par exemple, pour les jours où la demande est plus élevée que d’habitude, créez un profil avec des limites d’instances maximales et minimales élargies.

L’exemple Azure PowerShell suivant utilise les applets de commande Update-AzAutoscaleSetting et New-AzAutoscaleProfileObject.

# Set variables
$startTime = "<StartTime>"
$endTime = "<EndTime>"

# Define parameters for New-AzAutoscaleProfileObject
$newAzAutoscaleProfileObjectParams = @{
    Name              = "High-demand-day"
    CapacityDefault   = "7"
    CapacityMaximum   = "30"
    CapacityMinimum   = "5"
    FixedDateEnd      = [datetime]::Parse($endTime)
    FixedDateStart    = [datetime]::Parse($startTime)
    FixedDateTimeZone = "UTC"
    Rule              = @($scaleOutRule, $scaleInRule)
}
$highDemandDay = New-AzAutoscaleProfileObject @newAzAutoscaleProfileObjectParams

# Define parameters for Update-AzAutoscaleSetting
$updateAzAutoscaleSettingParams = @{
    Name              = $autoscaleName
    ResourceGroupName = $resourceGroupName
    Profile           = @($defaultProfile, $highDemandDay)
}

# Update the autoscale profiles
Update-AzAutoscaleSetting @updateAzAutoscaleSettingParams

Ajouter un profil planifié récurrent

Les profils récurrents vous permettent de planifier un profil de mise à l’échelle qui se répète chaque semaine.

Bien que les profils planifiés aient une date de début et de fin, les profils récurrents n’ont pas d’heure de fin. Un profil reste actif jusqu’à l’heure de début du profil suivant. Ainsi, lorsque vous créez un profil récurrent, vous devez créer un profil récurrent par défaut qui commence lorsque vous souhaitez que le profil récurrent précédent se termine.

L’exemple Azure PowerShell suivant utilise les applets de commande Update-AzAutoscaleSetting et New-AzAutoscaleProfileObject.

# Define parameters for New-AzAutoscaleProfileObject
$newAzAutoscaleProfileObjectParams = @{
    Name                = "Weekend"
    CapacityDefault     = "1"
    CapacityMaximum     = "1"
    CapacityMinimum     = "1"
    RecurrenceFrequency = "Week"
    ScheduleDay         = @("Friday")
    ScheduleHour        = @(22)
    ScheduleMinute      = @(0)
    ScheduleTimeZone    = "Pacific Standard Time"
    Rule                = @($scaleOutRule, $scaleInRule)
}
$fridayProfile = New-AzAutoscaleProfileObject @newAzAutoscaleProfileObjectParams

# Define parameters for New-AzAutoscaleProfileObject
$newAzAutoscaleProfileObjectParams = @{
    Name                = "default recurring profile"
    CapacityDefault     = "2"
    CapacityMaximum     = "10"
    CapacityMinimum     = "2"
    RecurrenceFrequency = "Week"
    ScheduleDay         = @("Monday")
    ScheduleHour        = @(0)
    ScheduleMinute      = @(0)
    ScheduleTimeZone    = "Pacific Standard Time"
    Rule                = @($scaleOutRule, $scaleInRule)
}
$defaultRecurringProfile = New-AzAutoscaleProfileObject @newAzAutoscaleProfileObjectParams

# Define parameters for Update-AzAutoscaleSetting
$updateAzAutoscaleSettingParams = @{
    Name              = $autoscaleName
    ResourceGroupName = $resourceGroupName
    Profile           = @(
        $defaultProfile
        $highDemandDay
        $defaultRecurringProfile
        $fridayProfile
    )
}

# Update the autoscale profiles
Update-AzAutoscaleSetting @updateAzAutoscaleSettingParams

Pour plus d’informations sur les profils planifiés, consultez Mise à l’échelle automatique avec plusieurs profils.

Autres commandes de mise à l’échelle automatique

Pour obtenir la liste complète des applets de commande PowerShell pour la mise à l’échelle automatique, consultez PowerShell Module Browser.

Nettoyer les ressources

Pour nettoyer les ressources que vous avez créées dans ce tutoriel, supprimez le groupe de ressources dédié que vous avez créé. La cmdlet suivante supprime le groupe de ressources et toutes ses ressources.

L’exemple de Azure PowerShell suivant utilise l’applet Remove-AzResourceGroup de commande.

# Delete the example resource group
Remove-AzResourceGroup -Name $resourceGroupName