Configuración del escalado automático con Azure PowerShell

El escalado automático ayuda a garantizar que tiene la cantidad adecuada de recursos en ejecución para administrar las fluctuaciones de carga de la aplicación. Puede configurar el escalado automático mediante el portal de Azure, CLI de Azure, Azure PowerShell o plantillas de ARM o Bicep.

En este artículo, se muestra cómo configurar el escalado automático para un conjunto de escalado de máquinas virtuales con PowerShell. Las configuraciones usan los pasos siguientes:

• Cree un conjunto de escalado de máquinas virtuales que pueda escalar automáticamente.
• Cree reglas para reducir y ampliar la escala.
• Cree un perfil que use sus reglas.
• Aplique la configuración de escalado automático.
• Actualice la configuración de autoescalado con notificaciones.

Prerrequisitos

Para configurar el escalado automático mediante PowerShell, necesita una cuenta de Azure con una suscripción activa. También puede crear una cuenta de forma gratuita.

Configurar el entorno

# 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"

Creación de un conjunto de escalado de máquinas virtuales

En el ejemplo siguiente de Azure PowerShell se usan los cmdlets New-AzResourceGroup y New-AzVmss.

# 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

Crear configuración de escalabilidad automática

Para crear una configuración de escalado automático mediante PowerShell, siga la secuencia siguiente:

1. Cree reglas mediante New-AzAutoscaleScaleRuleObject.
2. Cree un perfil mediante New-AzAutoscaleProfileObject.
3. Cree la configuración de escalado automático mediante New-AzAutoscaleSetting.
4. Actualice la configuración mediante Update-AzAutoscaleSetting.

Creación de reglas

Crea reglas de reducción y ampliación de escala y, a continuación, asígnalas a un perfil.

En el ejemplo de Azure PowerShell siguiente se usa el New-AzAutoscaleScaleRuleObject cmdlet .

# 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

En la tabla siguiente, se describen los parámetros usados en el cmdlet New-AzAutoscaleScaleRuleObject.

Creación de un perfil de escalado automático predeterminado y asociación de las reglas

Después de definir las reglas de escalado, cree un perfil. El perfil especificará los límites predeterminados, superiores e inferiores de recuento de instancias, y las horas en que se podrán aplicar las reglas asociadas.

En el ejemplo de Azure PowerShell siguiente se usa el New-AzAutoscaleProfileObject cmdlet .

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

En la tabla siguiente, se describen los parámetros usados en el cmdlet New-AzAutoscaleProfileObject.

Aplicación de la configuración de escalado automático

Después de definir las reglas y el perfil, aplique la configuración de escalado automático. Para actualizar una configuración de escalado automático existente, use Update-AzAutoscaleSetting.

En el ejemplo de Azure PowerShell siguiente se usa el New-AzAutoscaleSetting cmdlet .

# 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

Adición de notificaciones a la configuración de escalado automático

Agregue notificaciones a la configuración de escalado automático para desencadenar un webhook o enviar notificaciones por correo electrónico cuando se produce un evento de escalado.

En el ejemplo de Azure PowerShell siguiente se usa el New-AzAutoscaleWebhookNotificationObject cmdlet .

# Set variables
$webhookUri = "<WebhookUri>"

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

En el ejemplo siguiente Azure PowerShell se usa el New-AzAutoscaleNotificationObject cmdlet para configurar el webhook y las notificaciones por correo electrónico.

# Set variables
$notificationEmail = "<NotificationEmail>"

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

En el ejemplo de Azure PowerShell siguiente se usa el Update-AzAutoscaleSetting cmdlet para aplicar la notificación.

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

# Update the autoscale notification
Update-AzAutoscaleSetting @updateAzAutoscaleSettingParams

Revise la configuración de la escalabilidad automática

En el siguiente Azure PowerShell ejemplo se usa el Get-AzAutoscaleSetting cmdlet para recuperar la configuración de escalado automático.

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

En el ejemplo de Azure PowerShell siguiente se usa el Get-AzAutoscaleHistory cmdlet .

# 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

Perfiles programados y recurrentes

Agregar un perfil programado para un evento especial

Configure perfiles de escalado automático para escalar de forma diferente para eventos específicos. Por ejemplo, durante un día, cuando la demanda sea mayor de lo habitual, cree un perfil con un aumento máximo y mínimo de los límites de instancia.

En el ejemplo siguiente de Azure PowerShell se usan los cmdlets New-AzAutoscaleProfileObject y Update-AzAutoscaleSetting.

# 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

Agregar un perfil programado recurrente

Los perfiles periódicos permiten programar perfiles de escalado que se repetirán cada semana.

Mientras que los perfiles programados tienen fecha de inicio y de finalización, los perfiles periódicos no tienen hora de finalización. Un perfil permanecerá activo hasta la hora de inicio del perfil siguiente. Por lo tanto, al crear perfiles periódicos, deberá crear un perfil predeterminado periódico que se inicie cuando desee que finalice el perfil periódico anterior.

En el ejemplo siguiente de Azure PowerShell se usan los cmdlets New-AzAutoscaleProfileObject y Update-AzAutoscaleSetting.

# 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

Para obtener más información sobre los perfiles programados, consulte Escalabilidad automática con varios perfiles.

Otros comandos de escalabilidad automática

Para obtener una lista completa de los cmdlets de PowerShell para el escalado automático, consulte el Explorador de módulos de PowerShell.

Limpieza de recursos

Para limpiar los recursos que creó en este tutorial, elimine el grupo de recursos dedicado que creó. El siguiente cmdlet elimina el grupo de recursos y todos sus recursos.

En el ejemplo de Azure PowerShell siguiente se usa el Remove-AzResourceGroup cmdlet .

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