Implementieren der Skalierung pro App für Hosting mit hoher Dichte

Wählen Sie entweder den Erstellungsschritt oder den Update-Schritt für den Plan. Im Aktualisierungsschritt wird nur perSiteScaling geändert; die vorhandene Plankapazität wird nicht geändert.

resourceGroup='<resource-group-name>'
planName='<app-service-plan-name>'
appName='<app-name>'
slotName='staging'
location='westus3'

# Create a plan with capacity 10 and per-app scaling.
az appservice plan create \
    --resource-group $resourceGroup \
    --name $planName \
    --location $location \
    --sku P1V3 \
    --number-of-workers 10 \
    --per-site-scaling

# Or enable per-app scaling on an existing plan without changing its capacity.
az appservice plan update \
    --resource-group $resourceGroup \
    --name $planName \
    --set properties.perSiteScaling=true

# Configure the production app and its staging slot independently.
az webapp config set \
    --resource-group $resourceGroup \
    --name $appName \
    --number-of-workers 5

az webapp config set \
    --resource-group $resourceGroup \
    --name $appName \
    --slot $slotName \
    --number-of-workers 2

Hier ist der Plan --number-of-workers 10 die Kapazität. Die Web-App-Konfigurationsoption mit demselben Namen ist das gewünschte App- oder Slot-Limit. Inspizieren Sie die konfigurierten Werte:

az appservice plan show \
    --resource-group $resourceGroup \
    --name $planName \
    --query "{planCapacity:sku.capacity, perSiteScaling:perSiteScaling}"

az webapp config show \
    --resource-group $resourceGroup \
    --name $appName \
    --query "{appWorkerLimit:numberOfWorkers}"

az webapp config show \
    --resource-group $resourceGroup \
    --name $appName \
    --slot $slotName \
    --query "{slotWorkerLimit:numberOfWorkers}"

Für Befehlsdetails siehe az appservice plan und az webapp config.

Wähle entweder New-AzAppServicePlan oder Set-AzAppServicePlan. Wenn Set-AzAppServicePlan die Planeinstellungen ändert, wiederholen Sie -PerSiteScaling $true ausdrücklich, damit der beabsichtigte Funktionszustand klar bleibt.

$ResourceGroup = '<resource-group-name>'
$AppServicePlan = '<app-service-plan-name>'
$WebApp = '<app-name>'
$Slot = 'staging'
$Location = 'westus3'

# Create a plan with capacity 10 and per-app scaling.
New-AzAppServicePlan -ResourceGroupName $ResourceGroup `
    -Name $AppServicePlan `
    -Location $Location `
    -Tier PremiumV3 `
    -WorkerSize Small `
    -NumberofWorkers 10 `
    -PerSiteScaling $true

# Or set the intended capacity and feature state on an existing plan.
Set-AzAppServicePlan -ResourceGroupName $ResourceGroup `
    -Name $AppServicePlan `
    -NumberofWorkers 10 `
    -PerSiteScaling $true

Set-AzWebApp -ResourceGroupName $ResourceGroup `
    -Name $WebApp `
    -NumberOfWorkers 5

Set-AzWebAppSlot -ResourceGroupName $ResourceGroup `
    -Name $WebApp `
    -Slot $Slot `
    -NumberOfWorkers 2

Verwenden Sie die entsprechenden Get cmdlets, um die Plan-, App- und Slot-Werte zu überprüfen:

$Plan = Get-AzAppServicePlan -ResourceGroupName $ResourceGroup -Name $AppServicePlan
[pscustomobject]@{
    PlanCapacity = $Plan.Sku.Capacity
    PerSiteScaling = $Plan.PerSiteScaling
}

(Get-AzWebApp -ResourceGroupName $ResourceGroup -Name $WebApp).SiteConfig.NumberOfWorkers
(Get-AzWebAppSlot -ResourceGroupName $ResourceGroup -Name $WebApp -Slot $Slot).SiteConfig.NumberOfWorkers

Für cmdlet-Details siehe New-AzAppServicePlan, Set-AzAppServicePlan und Set-AzWebApp.

Diese Bicep-Datei erstellt einen Plan, eine App und einen Staging Slot mit den Beispielwerten.

param location string = resourceGroup().location
param appServicePlanName string
param appName string

resource appServicePlan 'Microsoft.Web/serverfarms@2024-11-01' = {
  name: appServicePlanName
  location: location
  sku: {
    name: 'P1v3'
    tier: 'PremiumV3'
    capacity: 10
  }
  properties: {
    perSiteScaling: true
  }
}

resource app 'Microsoft.Web/sites@2024-11-01' = {
  name: appName
  location: location
  properties: {
    serverFarmId: appServicePlan.id
    siteConfig: {
      numberOfWorkers: 5
    }
  }
}

resource stagingSlot 'Microsoft.Web/sites/slots@2024-11-01' = {
  parent: app
  name: 'staging'
  location: location
  properties: {
    serverFarmId: appServicePlan.id
    siteConfig: {
      numberOfWorkers: 2
    }
  }
}

Speichere die Datei als main.bicep, kompiliere sie mit az bicep build --file main.bicepund deploye sie mit az deployment group create --resource-group <resource-group-name> --template-file main.bicep. Eine erfolgreiche Kompilierung validiert Syntax und Ressourcentypen; inspiziert die konfigurierten Werte nach der Bereitstellung. Für Ressourcendefinitionen siehe App Service Plans, Apps und Deployment Slots.

Diese ARM-Vorlage definiert denselben Plan, dieselbe App und denselben Staging Slot. Die App hängt vom Plan ab, und der Slot hängt von der übergeordneten App ab.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "appServicePlanName": {
      "type": "string"
    },
    "appName": {
      "type": "string"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2024-11-01",
      "name": "[parameters('appServicePlanName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "P1v3",
        "tier": "PremiumV3",
        "capacity": 10
      },
      "properties": {
        "perSiteScaling": true
      }
    },
    {
      "type": "Microsoft.Web/sites",
      "apiVersion": "2024-11-01",
      "name": "[parameters('appName')]",
      "location": "[parameters('location')]",
      "dependsOn": [
        "[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]"
      ],
      "properties": {
        "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]",
        "siteConfig": {
          "numberOfWorkers": 5
        }
      }
    },
    {
      "type": "Microsoft.Web/sites/slots",
      "apiVersion": "2024-11-01",
      "name": "[format('{0}/{1}', parameters('appName'), 'staging')]",
      "location": "[parameters('location')]",
      "dependsOn": [
        "[resourceId('Microsoft.Web/sites', parameters('appName'))]"
      ],
      "properties": {
        "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]",
        "siteConfig": {
          "numberOfWorkers": 2
        }
      }
    }
  ]
}

Speichere die Vorlage als azuredeploy.json, validiere sie mit az deployment group validate --resource-group <resource-group-name> --template-file azuredeploy.json, und deploye sie dann mit az deployment group create --resource-group <resource-group-name> --template-file azuredeploy.json. Validierung und Bereitstellung erfordern einen Azure-Kontext; JSON-Parsing allein validiert die Ressourcen nicht gegen dein Abonnement. Für Schemadetails siehe App Service Plans, Apps und Deployment Slots.

Verwenden Sie den Azure Resource Manager-Endpunkt für Ihre Cloud als {managementEndpoint}. Für das öffentliche Azure lautet dieser Wert https://management.azure.com; andere Clouds verwenden ihren eigenen Endpunkt.

Ein Plan PUT ist eine vollständige Erstellungs- oder Aktualisierungsanfrage. Geben Sie den Standort des Plans, die SKU, die Kapazität und die Eigenschaften an; senden Sie die folgende Anfrage nicht als Aktualisierung nur der Eigenschaften.

PUT {managementEndpoint}/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/serverfarms/{planName}?api-version=2024-11-01
Content-Type: application/json

{
  "location": "westus3",
  "sku": {
    "name": "P1v3",
    "tier": "PremiumV3",
    "capacity": 10
  },
  "properties": {
    "perSiteScaling": true
  }
}

Verwenden Sie für einen bestehenden Plan ein partielles PATCH, um nur die angezeigte Skalareigenschaft zu ändern:

PATCH {managementEndpoint}/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/serverfarms/{planName}?api-version=2024-11-01
Content-Type: application/json

{
  "properties": {
    "perSiteScaling": true
  }
}

Für die Produktions-App aktualisieren Sie die config/web Ressource und lesen Sie sie:

PATCH {managementEndpoint}/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/sites/{appName}/config/web?api-version=2024-11-01
Content-Type: application/json

{
  "properties": {
    "numberOfWorkers": 5
  }
}

GET {managementEndpoint}/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/sites/{appName}/config/web?api-version=2024-11-01

Für den Staging-Slot fügen Sie /slots/{slotName} in den Ressourcenpfad ein:

PATCH {managementEndpoint}/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/sites/{appName}/slots/{slotName}/config/web?api-version=2024-11-01
Content-Type: application/json

{
  "properties": {
    "numberOfWorkers": 2
  }
}

GET {managementEndpoint}/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/sites/{appName}/slots/{slotName}/config/web?api-version=2024-11-01

Lies den Plan mit GET {managementEndpoint}/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/serverfarms/{planName}?api-version=2024-11-01. Partielle skalare PATCH Anfragen sind für die angezeigten Felder sicher, da ausgelassene Einstellungen erhalten bleiben. Für Betriebsdetails siehe die App Service REST API-Referenz.