Konfigurace vlastních metrik pro postupné upgrady ve škálovacích sadách virtuálních počítačů (Preview)

Poznámka:

Vlastní metriky pro postupné upgrady ve škálovacích sadách virtuálních počítačů jsou aktuálně ve verzi Preview. Verze Preview vám zpřístupňujeme pod podmínkou, že budete souhlasit s dodatečnými podmínkami použití. Některé aspekty těchto funkcí se můžou před obecnou dostupností (GA) změnit.

Vlastní metriky pro postupné upgrady umožňují využít rozšíření stavu aplikace k generování vlastních metrik do škálovací sady virtuálních počítačů. Pomocí těchto vlastních metrik můžete škálovací sadě sdělit pořadí, ve kterém se mají virtuální počítače aktualizovat při aktivaci postupného upgradu. Vlastní metriky můžou také informovat vaši škálovací sadu, když by se měl upgrade přeskočit na konkrétní instanci. To vám umožní mít větší kontrolu nad řazením a samotným procesem aktualizace.

Vlastní metriky je možné použít v kombinaci s dalšími funkcemi postupného upgradu, jako jsou automatické upgrady operačního systému, automatické upgrady rozšíření a upgrady maxSurge.

Požadavky

• Pokud pro škálovací sady virtuálních počítačů používáte vlastní metriky pro postupné upgrady, musí škálovací sada také použít rozšíření stavu aplikace s bohatými stavy k hlášení pořadí fází nebo přeskočení informací o upgradu. Při použití rozšíření stavu aplikace s binárními stavy se nepodporují upgrady vlastních metrik.
• Aby bylo možné přijímat informace o vlastních metrikách, musí být rozšíření stavu aplikace nastavené tak, aby používalo protokol HTTP nebo HTTPS. Protokol TCP není podporován pro integraci s vlastními metrikami pro postupné upgrady.

Koncepty

Řazení fází

Fáze je seskupovací konstrukce pro virtuální počítače. Každá fáze je určena nastavením metadat vygenerovaných z rozšíření stavu aplikace prostřednictvím customMetrics vlastnosti. Škálovací sada virtuálních počítačů přebírá informace získané z vlastních metrik a používá je k umístění virtuálních počítačů do jejich přiřazených fází. V každé fázi přiřadí škálovací sada virtuálních počítačů také dávky upgradu. Každá dávka se konfiguruje pomocí zásad postupného upgradu, které berou v úvahu aktualizační domény (UD), domény selhání (FD) a informace o zónách jednotlivých virtuálních počítačů.

Při zahájení postupného upgradu se virtuální počítače umístí do určených fází. Postupné upgrady se provádějí v pořadí číselných sekvencí. Virtuální počítače ve všech dávkách v rámci fáze se dokončí před přechodem na další fázi. Pokud pro virtuální počítač není přijato žádné řazení fází, škálovací sada ji umístí do poslední fáze.

Místní škálovací sada

Zónová škálovací sada

Pokud chcete zadat číslo fáze, ke které by měl být virtuální počítač přidružený, použijte phaseOrderingNumber parametr.

{
     “applicationHealthState”: “Healthy”,
      “customMetrics”: "{ \"rollingUpgrade\": { \"PhaseOrderingNumber\": 0 } }"
}

Přeskočit upgrade

Funkce přeskočit upgrade umožňuje vynechat jednotlivé instance z upgradu během postupného upgradu. Podobá se využití ochrany instancí, ale může se bezproblémově integrovat do pracovního postupu postupného upgradu a do aplikací na úrovni instancí. Podobně jako u řazení fází se informace o upgradu přeskočení předávají do škálovací sady virtuálních počítačů prostřednictvím rozšíření stavu aplikace a vlastního nastavení metrik. Při aktivaci postupného upgradu zkontroluje škálovací sada virtuálních počítačů odpověď vlastních metrik rozšíření stavu aplikace a pokud je upgrade přeskočení nastaven na hodnotu true, instance se do postupného upgradu nezahrne.

Pokud chcete přeskočit upgrade na virtuálním počítači, použijte SkipUpgrade parametr. To říká postupnému upgradu, aby při provádění upgradů přeskočí tento virtuální počítač.

{
     “applicationHealthState”: “Healthy”,
      “customMetrics”: "{ \"rollingUpgrade\": { \"SkipUpgrade\": true} }"
}

Přeskočit upgrade a pořadí fází je možné použít také společně:

{
     “applicationHealthState”: “Healthy”,
      “customMetrics”: "{ \"rollingUpgrade\": { \"SkipUpgrade\": false, \"PhaseOrderingNumber\": 0 } }"
}

Konfigurace rozšíření stavu aplikace

Rozšíření stavu aplikace vyžaduje požadavek HTTP nebo HTTPS s přidruženým portem nebo cestou požadavku. Testy PROTOKOLU TCP se podporují při použití rozšíření stavu aplikace, ale nemůžou nastavit ApplicationHealthState tělo odpovědi sondy a nejde je použít se kumulativními upgrady s vlastními metrikami.

{
  "extensionProfile" : {
     "extensions" : [
      {
        "name": "HealthExtension",
        "properties": {
          "publisher": "Microsoft.ManagedServices",
          "type": "<ApplicationHealthLinux or ApplicationHealthWindows>",
          "autoUpgradeMinorVersion": true,
          "typeHandlerVersion": "1.0",
          "settings": {
            "protocol": "<protocol>",
            "port": <port>,
            "requestPath": "</requestPath>",
            "intervalInSeconds": 5,
            "numberOfProbes": 1
          }
        }
      }
    ]
  }
}

Název	Hodnota / příklad	Datový typ
protokol	http nebo https	string
port	Volitelné, pokud je http protokol nebo https	int
requestPath	Povinné při použití http nebo https	string
intervalInSeconds	Volitelné, výchozí hodnota je 5 sekund. Toto nastavení je interval mezi jednotlivými sondou stavu. Pokud například intervalInSeconds == 5, odešle se sonda do místního koncového bodu aplikace jednou za 5 sekund.	int
numberOfProbes	Volitelné, výchozí hodnota je 1. Toto nastavení je počet po sobě jdoucích testů potřebných ke změně stavu. Pokud například numberOfProbles == 3, potřebujete 3 po sobě jdoucí signály "V pořádku", abyste změnili stav z "Není v pořádku"/"Neznámý" do stavu V pořádku. Stejný požadavek platí pro změnu stavu na Stav není v pořádku nebo Neznámý stav.	int
gracePeriod	Volitelné, výchozí = intervalInSeconds * numberOfProbes; maximální období odkladu je 7200 sekund	int

Instalace rozšíření stavu aplikace

Rozhraní příkazového řádku

Pomocí příkazu az vmss extension set přidejte rozšíření stavu aplikace do definice modelu škálovací sady.

Vytvořte soubor JSON s požadovaným extensions.json nastavením.

{
  "protocol": "<protocol>",
  "port": <port>,
  "requestPath": "</requestPath>",
  "gracePeriod": <healthExtensionGracePeriod>
}

Použijte rozšíření stavu aplikace.

az vmss extension set \
  --name ApplicationHealthLinux \
  --publisher Microsoft.ManagedServices \
  --version 2.0 \
  --resource-group myResourceGroup \
  --vmss-name myScaleSet \
  --settings ./extension.json

Upgradujte virtuální počítače ve škálovací sadě. Tento krok se vyžaduje jenom v případě, že vaše škálovací sada používá zásady ručního upgradu. Další informace o zásadách upgradu najdete v tématu Zásady upgradu pro škálovací sady virtuálních počítačů.

az vmss update-instances \
  --resource-group myResourceGroup \
  --name myScaleSet \
  --instance-ids "*"

PowerShell

Pomocí rutiny Add-AzVmssExtension přidejte rozšíření stavu aplikace do definice modelu škálovací sady.

# Define the scale set variables
$vmScaleSetName = "myScaleSet"
$vmScaleSetResourceGroup = "myResourceGroup"

# Define the application health extension properties
$publicConfig = @{"protocol" = "http"; "port" = 80; "requestPath" = "/healthEndpoint"; "gracePeriod" = 600};
$extensionName = "myHealthExtension"
$extensionType = "ApplicationHealthWindows"
$publisher = "Microsoft.ManagedServices"

# Get the scale set object
$vmScaleSet = Get-AzVmss `
  -ResourceGroupName $vmScaleSetResourceGroup `
  -VMScaleSetName $vmScaleSetName

# Add the application health extension to the scale set model
Add-AzVmssExtension -VirtualMachineScaleSet $vmScaleSet `
  -Name $extensionName `
  -Publisher $publisher `
  -Setting $publicConfig `
  -Type $extensionType `
  -TypeHandlerVersion "2.0" `
  -AutoUpgradeMinorVersion $True

# Update the scale set
Update-AzVmss -ResourceGroupName $vmScaleSetResourceGroup `
  -Name $vmScaleSetName `
  -VirtualMachineScaleSet $vmScaleSet
  
# Upgrade instances to install the extension.
Update-AzVmssInstance -ResourceGroupName $vmScaleSetResourceGroup `
  -VMScaleSetName $vmScaleSetName `
  -InstanceId '*'

REST

Použijte rozšíření stavu aplikace pomocí vytvoření nebo aktualizace.

PUT `/subscriptions/subscription_id/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet/extensions/myHealthExtension?api-version=2018-10-01`

Request body
{
  "name": "myHealthExtension",
  "location": "<location>",
  "properties": {
    "publisher": "Microsoft.ManagedServices",
    "type": "ApplicationHealthWindows",
    "autoUpgradeMinorVersion": true,
    "typeHandlerVersion": "2.0",
    "settings": {
      "protocol": "<protocol>",
      "port": <port>,
      "requestPath": "</requestPath>",
      "intervalInSeconds": <intervalInSeconds>,
      "numberOfProbes": <numberOfProbes>,
      "gracePeriod": <gracePeriod>
    }
  }
}

Upgradujte virtuální počítače ve škálovací sadě. Tento krok se vyžaduje jenom v případě, že vaše škálovací sada používá zásady ručního upgradu. Další informace o zásadách upgradu najdete v tématu Zásady upgradu pro škálovací sady virtuálních počítačů.

POST `/subscriptions/<subscriptionId>/resourceGroups/<myResourceGroup>/providers/Microsoft.Compute/virtualMachineScaleSets/< myScaleSet >/manualupgrade?api-version=2022-08-01`

Request body
{
  "instanceIds": ["*"]
}

Konfigurace odpovědi rozšíření stavu aplikace

Konfiguraci vlastní odpovědi na metriky je možné provést mnoha různými způsoby. Lze ho integrovat do stávajících aplikací, dynamicky aktualizovat a používat společně s různými funkcemi k poskytování výstupu na základě konkrétní situace.

Mezi tyto ukázkové aplikace patří pořadí fází a přeskočení parametrů upgradu do odpovědi na vlastní metriky.

Udeřit

#!/bin/bash

# Open firewall port (replace with your firewall rules as needed)
sudo iptables -A INPUT -p tcp --dport 8000 -j ACCEPT

# Create Python HTTP server for responding with JSON
cat <<EOF > server.py
import json
from http.server import BaseHTTPRequestHandler, HTTPServer

# Function to generate the JSON response
def generate_response_json():
    return json.dumps({
        "ApplicationHealthState": "Healthy",
        "CustomMetrics": json.dumps({
            "RollingUpgrade": {
                "PhaseOrderingNumber": 1,
                "SkipUpgrade": "false"
            }
        })
    })

class RequestHandler(BaseHTTPRequestHandler):
    def do_GET(self):
        # Respond with HTTP 200 and JSON content
        self.send_response(200)
        self.send_header('Content-type', 'application/json')
        self.end_headers()
        response = generate_response_json()
        self.wfile.write(response.encode('utf-8'))

# Set up the HTTP server
def run(server_class=HTTPServer, handler_class=RequestHandler):
    server_address = ('localhost', 8000)
    httpd = server_class(server_address, handler_class)
    print('Starting server on port 8000...')
    httpd.serve_forever()

if __name__ == "__main__":
    run()
EOF

# Run the server in the background
python3 server.py &

# Store the process ID of the server
SERVER_PID=$!

# Wait a few seconds to ensure the server starts
sleep 2

# Confirm execution
echo "Server has been started on port 8000 with PID $SERVER_PID"

PowerShell

# Define the script path
$scriptPath = "$env:TEMP\server.ps1"

# Create the PowerShell HTTP Server Script
$serverScript = @"
`$Hso = New-Object Net.HttpListener
`$Hso.Prefixes.Add('http://localhost:8000/')
`$Hso.Start()

Write-Host 'Starting server on port 8000...'

# Function to Generate JSON Response (Matching Python Format)
function GenerateResponseJson {
    # Create JSON string for CustomMetrics
    `$customMetricsJson = (@{
        'RollingUpgrade' = @{
            'PhaseOrderingNumber' = 1
            'SkipUpgrade' = 'false'
        }
    } | ConvertTo-Json -Depth 10) -replace "`n", "" -replace "\s{2,}", ""  # Ensuring a single-line JSON string

    # Create main JSON response
    `$response = @{
        'ApplicationHealthState' = 'Healthy'
        'CustomMetrics' = `$customMetricsJson  # Embed JSON string inside JSON
    }

    return (`$response | ConvertTo-Json -Depth 10)
}

# Keep the server running
while (`$Hso.IsListening) {
    try {
        `$context = `$Hso.GetContext()
        `$response = `$context.Response
        `$response.StatusCode = 200
        `$response.ContentType = 'application/json'
        `$responseJson = GenerateResponseJson
        `$responseBytes = [System.Text.Encoding]::UTF8.GetBytes(`$responseJson)
        `$response.OutputStream.Write(`$responseBytes, 0, `$responseBytes.Length)
        `$response.Close()
        Write-Host "Responded to request at $(Get-Date)"
    }
    catch {
        Write-Host "Error occurred: $_"
    }
}
"@

# Write the script to a file
$serverScript | Out-File -FilePath $scriptPath -Encoding UTF8

# Verify if the file exists before starting the process
if (Test-Path $scriptPath) {
    Write-Host "Server script successfully created at $scriptPath"
    Start-Process -NoNewWindow -FilePath "powershell.exe" -ArgumentList "-ExecutionPolicy Bypass -File `"$scriptPath`"" -PassThru | ForEach-Object {
        # Store Process ID
        $SERVER_PID = $_.Id
        Write-Host "Server has been started on port 8000 with PID $SERVER_PID"
    }
} else {
    Write-Host "Error: Server script not found at $scriptPath"
}

Další příklady konfigurace odpovědí najdete v ukázkách stavu aplikací.

Další kroky

Naučte se provádět ruční upgrady ve škálovacích sadách virtuálních počítačů.