Updates beheren met onderhoudsconfiguraties en de Azure CLI

Van toepassing op: ✔️ Linux-VM's ✔️ Windows ✔️ Flexibele schaalsets Uniform schaalsets ✔️

Met onderhoudsconfiguraties kunt u bepalen wanneer u platformupdates wilt toepassen op verschillende Azure-resources. In dit onderwerp worden de Azure CLI-opties voor toegewezen hosts en geïsoleerde VM's behandeld. Zie Platformupdates beheren met onderhoudsconfiguraties voor meer informatie over de voordelen van het gebruik van onderhoudsconfiguraties, de beperkingen en andere beheeropties.

Belangrijk

Er zijn verschillende bereiken die bepaalde machinetypen en - planningen ondersteunen, dus zorg ervoor dat u het juiste bereik voor uw virtuele machine selecteert.

Een onderhoudsconfiguratie maken

Hiermee az maintenance configuration create maakt u een onderhoudsconfiguratie. In dit voorbeeld wordt een onderhoudsconfiguratie gemaakt met de naam myConfig die is gericht op de host.

az group create \
   --location eastus \
   --name myMaintenanceRG
az maintenance configuration create \
   -g myMaintenanceRG \
   --resource-name myConfig \
   --maintenance-scope host\
   --location eastus

Kopieer de configuratie-id uit de uitvoer om later te gebruiken.

Het gebruik --maintenance-scope host zorgt ervoor dat de onderhoudsconfiguratie wordt gebruikt voor het beheren van updates voor de hostinfrastructuur.

Als u probeert een configuratie met dezelfde naam te maken, maar op een andere locatie, krijgt u een foutmelding. Configuratienamen moeten uniek zijn voor uw resourcegroep.

U kunt query's uitvoeren op beschikbare onderhoudsconfiguraties met behulp van az maintenance configuration list.

az maintenance configuration list --query "[].{Name:name, ID:id}" -o table 

Een onderhoudsconfiguratie maken met gepland venster

U kunt ook een gepland venster declareren wanneer Azure de updates op uw resources toepast. In dit voorbeeld wordt een onderhoudsconfiguratie met de naam myConfig gemaakt met een gepland venster van 5 uur op de vierde maandag van elke maand. Zodra u een gepland venster hebt gemaakt, hoeft u de updates niet meer handmatig toe te passen.

az maintenance configuration create \
   -g myMaintenanceRG \
   --resource-name myConfig \
   --maintenance-scope host \
   --location eastus \
   --maintenance-window-duration "05:00" \
   --maintenance-window-recur-every "Month Fourth Monday" \
   --maintenance-window-start-date-time "2020-12-30 08:00" \
   --maintenance-window-time-zone "Pacific Standard Time"

Belangrijk

Onderhoudsduur moet 2 uur of langer zijn.

Onderhoudspatroon kan worden uitgedrukt als dagelijks, wekelijks of maandelijks. Een aantal voorbeelden:

  • dagelijks-maintenance-window-recur-every: "Day" of "3Days"
  • wekelijks- maintenance-window-recur-every: "3Weeks" of "Week zaterdag,zondag"
  • monthly- maintenance-window-recur-every: "Month day23,day24" of "Month Last Sunday" of "Month Fourth Monday"

De configuratie toewijzen

Gebruik az maintenance assignment create dit om de configuratie toe te wijzen aan uw computer.

Geïsoleerde VM

Pas de configuratie toe op een VIRTUELE machine met behulp van de id van de configuratie. Geef --resource-type virtualMachines de naam van de VIRTUELE machine op voor --resource-nameen geef de resourcegroep op voor de VIRTUELE machine in --resource-groupen de locatie van de VM voor --location.

az maintenance assignment create \
   --resource-group myMaintenanceRG \
   --location eastus \
   --resource-name myVM \
   --resource-type virtualMachines \
   --provider-name Microsoft.Compute \
   --configuration-assignment-name myConfig \
   --maintenance-configuration-id "/subscriptions/1111abcd-1a11-1a2b-1a12-123456789abc/resourcegroups/myMaintenanceRG/providers/Microsoft.Maintenance/maintenanceConfigurations/myConfig"

Toegewezen host

Als u een configuratie wilt toepassen op een toegewezen host, moet --resource-type hostsu , --resource-parent-name met de naam van de hostgroep en --resource-parent-type hostGroups.

De parameter --resource-id is de id van de host. U kunt az-vm-host-get-instance-view gebruiken om de id van uw toegewezen host op te halen.

az maintenance assignment create \
   -g myDHResourceGroup \
   --resource-name myHost \
   --resource-type hosts \
   --provider-name Microsoft.Compute \
   --configuration-assignment-name myConfig \
   --maintenance-configuration-id "/subscriptions/1111abcd-1a11-1a2b-1a12-123456789abc/resourcegroups/myDhResourceGroup/providers/Microsoft.Maintenance/maintenanceConfigurations/myConfig" \
   -l eastus \
   --resource-parent-name myHostGroup \
   --resource-parent-type hostGroups 

Configuratie controleren

U kunt controleren of de configuratie correct is toegepast of controleren of de configuratie momenteel wordt toegepast met behulp van az maintenance assignment list.

Geïsoleerde VM

az maintenance assignment list \
   --provider-name Microsoft.Compute \
   --resource-group myMaintenanceRG \
   --resource-name myVM \
   --resource-type virtualMachines \
   --query "[].{resource:resourceGroup, configName:name}" \
   --output table

Toegewezen host

az maintenance assignment list \
   --resource-group myDHResourceGroup \
   --resource-name myHost \
   --resource-type hosts \
   --provider-name Microsoft.Compute \
   --resource-parent-name myHostGroup \
   --resource-parent-type hostGroups 
   --query "[].{ResourceGroup:resourceGroup,configName:name}" \
   -o table

Controleren op updates in behandeling

Gebruik az maintenance update list deze optie om te zien of er updates in behandeling zijn. Update --subscription to be the ID for the subscription that contains the VM.

Als er geen updates zijn, retourneert de opdracht een foutbericht, dat de tekst bevat: Resource not found...StatusCode: 404

Als er updates zijn, wordt er slechts één geretourneerd, zelfs als er meerdere updates in behandeling zijn. De gegevens voor deze update worden geretourneerd in een object:

[
  {
    "impactDurationInSec": 9,
    "impactType": "Freeze",
    "maintenanceScope": "Host",
    "notBefore": "2020-03-03T07:23:04.905538+00:00",
    "resourceId": "/subscriptions/9120c5ff-e78e-4bd0-b29f-75c19cadd078/resourcegroups/DemoRG/providers/Microsoft.Compute/hostGroups/demoHostGroup/hosts/myHost",
    "status": "Pending"
  }
]

Geïsoleerde VM

Controleer op updates die in behandeling zijn voor een geïsoleerde VM. In dit voorbeeld wordt de uitvoer opgemaakt als een tabel voor leesbaarheid.

az maintenance update list \
   -g myMaintenanceRg \
   --resource-name myVM \
   --resource-type virtualMachines \
   --provider-name Microsoft.Compute \
   -o table

Toegewezen host

Controleren op updates in behandeling voor een toegewezen host. In dit voorbeeld wordt de uitvoer opgemaakt als een tabel voor leesbaarheid. Vervang de waarden voor de resources door uw eigen waarden.

az maintenance update list \
   --subscription 1111abcd-1a11-1a2b-1a12-123456789abc \
   -g myHostResourceGroup \
   --resource-name myHost \
   --resource-type hosts \
   --provider-name Microsoft.Compute \
   --resource-parentname myHostGroup \
   --resource-parent-type hostGroups \
   -o table

Updates toepassen

Gebruik az maintenance apply update dit om updates in behandeling toe te passen. Bij succes retourneert deze opdracht JSON met de details van de update. Het kan maximaal 2 uur duren voordat updateaanroepen zijn voltooid.

Geïsoleerde VM

Maak een aanvraag om updates toe te passen op een geïsoleerde VM.

az maintenance applyupdate create \
   --subscription 1111abcd-1a11-1a2b-1a12-123456789abc \
   --resource-group myMaintenanceRG \
   --resource-name myVM \
   --resource-type virtualMachines \
   --provider-name Microsoft.Compute

Toegewezen host

Updates toepassen op een toegewezen host.

az maintenance applyupdate create \
   --subscription 1111abcd-1a11-1a2b-1a12-123456789abc \
   --resource-group myHostResourceGroup \
   --resource-name myHost \
   --resource-type hosts \
   --provider-name Microsoft.Compute \
   --resource-parent-name myHostGroup \
   --resource-parent-type hostGroups

Controleer de status van het toepassen van updates

U kunt de voortgang van de updates controleren met behulp van az maintenance applyupdate get.

U kunt de naam van de update gebruiken default om resultaten voor de laatste update te bekijken of vervangen myUpdateName door de naam van de update die is geretourneerd toen u de update hebt uitgevoerd az maintenance applyupdate create.

Status         : Completed
ResourceId     : /subscriptions/12ae7457-4a34-465c-94c1-17c058c2bd25/resourcegroups/TestShantS/providers/Microsoft.Comp
ute/virtualMachines/DXT-test-04-iso
LastUpdateTime : 1/1/2020 12:00:00 AM
Id             : /subscriptions/12ae7457-4a34-465c-94c1-17c058c2bd25/resourcegroups/TestShantS/providers/Microsoft.Comp
ute/virtualMachines/DXT-test-04-iso/providers/Microsoft.Maintenance/applyUpdates/default
Name           : default
Type           : Microsoft.Maintenance/applyUpdates

LastUpdateTime is het tijdstip waarop de update is voltooid, geïnitieerd door u of door het platform als het zelfonderhoudsvenster niet is gebruikt. Als er nog nooit een update is toegepast via onderhoudsbeheer, wordt de standaardwaarde weergegeven.

Geïsoleerde VM

az maintenance applyupdate get \
   --resource-group myMaintenanceRG \
   --resource-name myVM \
   --resource-type virtualMachines \
   --provider-name Microsoft.Compute \
   --apply-update-name default 

Toegewezen host

az maintenance applyupdate get \
   --subscription 1111abcd-1a11-1a2b-1a12-123456789abc \ 
   --resource-group myMaintenanceRG \
   --resource-name myHost \
   --resource-type hosts \
   --provider-name Microsoft.Compute \
   --resource-parent-name myHostGroup \ 
   --resource-parent-type hostGroups \
   --apply-update-name myUpdateName \
   --query "{LastUpdate:lastUpdateTime, Name:name, ResourceGroup:resourceGroup, Status:status}" \
   --output table

Een onderhoudsconfiguratie verwijderen

Gebruik az maintenance configuration delete dit om een onderhoudsconfiguratie te verwijderen. Als u de configuratie verwijdert, wordt het onderhoudsbeheer uit de bijbehorende resources verwijderd.

az maintenance configuration delete \
   --subscription 1111abcd-1a11-1a2b-1a12-123456789abc \
   -g myResourceGroup \
   --resource-name myConfig

Volgende stappen

Zie Onderhoud en updates voor meer informatie.