Azure Arc-kompatibilis kiszolgálók frissítéseinek programozott kezelése

Ez a cikk bemutatja, hogy az Azure REST API használatával egy felmérést és frissítéstelepítést indíthat el az Azure Arc-kompatibilis kiszolgálókon az Azure Update Managerrel az Azure-ban. Ha még nem ismerkedik az Azure Update Managerrel, és szeretne többet megtudni, tekintse meg az Update Manager áttekintését. Az Azure REST API-t az Azure-beli virtuális gépek kezelésére való használathoz tekintse meg a programatikus használatot ismertető fejezetet.

Az Azure Update Managerrel programozott módon használhatja az Azure REST API-t a hozzáféréshez. Emellett az Azure PowerShell és az Azure CLI megfelelő REST-parancsait is használhatja.

Az Azure REST API támogatása az Azure Arc-kompatibilis kiszolgálók kezeléséhez az Update Manager virtuálisgép-bővítményen keresztül érhető el.

Frissítések felmérése

Ha frissítésértékelést szeretne indítani az Azure Arc-kompatibilis kiszolgálón, adja meg a következő POST-kérést:

A POST-kérés megadásához használhatja az Azure CLI az rest parancsot.

az rest --method post --url https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.HybridCompute/machines/machineName/assessPatches?api-version=2020-08-15-preview --body @body.json

Központi telepítés frissítése

Ha frissítéstelepítést szeretne indítani az Azure Arc-kompatibilis kiszolgálón, adja meg a következő POST-kérést:

POST on `subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.HybridCompute/machines/machineName/installPatches?api-version=2020-08-15-preview`

Kérelem törzse

Az alábbi táblázat a kérelem törzsének elemeit ismerteti:

Tulajdonság Leírás
maximumDuration Az operációs rendszer frissítési műveletének maximális időtartama percekben. Iso 8601 szabványnak megfelelő időtartam-sztringnek kell lennie, például PT100M.
rebootSetting A jelölő jelzi, hogy újra kell-e indítania a gépet, és jelzi, hogy az Azure Update Manager (AUM) a frissítési feladat részeként újraindítja-e a gépet. Elfogadható értékek: IfRequired, NeverReboot, AlwaysReboot.
windowsParameters A vendég operációs rendszer frissítésének paraméterbeállításai támogatott Microsoft Windows Server operációs rendszert futtató gépen.
windowsParameters - classificationsToInclude A Windows Server operációs rendszer által támogatott és biztosított operációsrendszer-frissítések kategóriáinak vagy besorolásainak listája. Az elfogadható értékek a következők: Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Update
windowsParameters - kbNumbersToInclude A számítógépen elérhető és telepíteni kívánt Windows Update KB-azonosítók listája. Ha megadott bármilyen „classificationsToInclude” értéket, a kategóriában elérhető KB-k lesznek telepítve. Az 'kbNumbersToInclude' lehetőséggel megadható azon konkrét KB-azonosítók listája, amelyeket a már korábban kiválasztottak mellett szintén telepíteni szeretne. Például: 1234
windowsParameters - kbNumbersToExclude Azon Windows Update KB-azonosítók listája, amelyek elérhetők a gép számára, és amelyeket nem szabad telepíteni. Ha tartalmaz bármilyen 'classificationsToInclude' értéket, a kategóriában elérhető KB-k telepítésre kerülnek. A kbNumbersToExclude" lehetőség azoknak a kb-azonosítóknak a listáját adja meg, amelyekről gondoskodni szeretne, hogy ne legyen telepítve. Például: 5678
maxPatchPublishDate Ez a megadott maximális közzétételi dátumon vagy azt megelőzően közzétett javítások telepítéséhez használható.
linuxParameters A vendég operációs rendszer frissítésének paraméterbeállításai támogatott Linux-disztribúció futtatásakor
linuxParameters - classificationsToInclude Az alkalmazható operációsrendszer-frissítések kategóriáinak vagy besorolásainak listája, ahogyan azt a Linux operációs rendszer csomagkezelője támogatja és biztosítja. Elfogadható értékek: Critical, Security, Others. További információ: Linux-csomagkezelő és operációsrendszer-támogatás.
linuxParameters - packageNameMasksToInclude A gép számára elérhető és telepíteni kívánt Linux-csomagok listája. Amennyiben bármilyen "classificationsToInclude"-t megadott, a kategóriában elérhető csomagok telepítve lesznek. A "packageNameMasksToInclude" egy lehetőség arra, hogy a már kijelölt telepítendő csomagokon felül további csomagokat is megadjon a telepítéshez. Például: mysql, libc=1.0.1.1, kernel*
linuxParameters - packageNameMasksToExclude A gép számára elérhető és nem telepíthető Linux-csomagok listája. Amennyiben bármilyen "classificationsToInclude"-t megadott, a kategóriában elérhető csomagok telepítve lesznek. A "packageNameMasksToExclude" lehetőség azoknak a csomagoknak a listáját adja meg, amelyekről gondoskodni szeretne, hogy ne legyen telepítve. Például: mysql, libc=1.0.1.1, kernel*

A POST-kérés megadásához használhatja az Azure CLI az rest parancsot.

az rest --method post --url https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/Test/providers/Microsoft.HybridCompute/machines/WIN-8/installPatches?api-version=2020-08-15-preview @body.json

A 2020-08-15-ös verzió kérelemtörzsének formátuma a következő:

{
        "maximumDuration": "PT120M",
        "rebootSetting": "IfRequired",
        "windowsParameters": {
          "classificationsToInclude": [
            "Security",
            "UpdateRollup",
            "FeaturePack",
            "ServicePack"
          ],
          "kbNumbersToInclude": [
            "11111111111",
            "22222222222222"
          ],
          "kbNumbersToExclude": [
            "333333333333",
            "55555555555"
          ]
        }
  }

Karbantartási konfiguráció ütemezésének létrehozása

Karbantartási konfigurációs ütemezés létrehozásához adja meg a következő PUT-kérést:

PUT on `/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Maintenance/maintenanceConfigurations/<maintenanceConfigurationsName>?api-version=2021-09-01-preview`

Kérelem törzse

Az alábbi táblázat a kérelem törzsének elemeit ismerteti:

Tulajdonság Leírás
id Az erőforrás teljes azonosítója
location Az erőforrás helyének lekérdezése vagy beállítása
name Az erőforrás neve
properties.extensionProperties A karbantartásikonfiguráció kiterjesztett tulajdonságainak lekérdezése vagy beállítása
properties.maintenanceScope Lekéri vagy beállítja a konfiguráció karbantartási hatókörét
properties.maintenanceWindow.duration A karbantartási időszak időtartama HH:mm formátumban. Ha nincs megadva, az alapértelmezett érték a megadott karbantartási hatókör alapján lesz használva. Példa: 05:00.
properties.maintenanceWindow.expirationDateTime A karbantartási időszak érvényes lejárati dátuma YYYY-MM-DD hh:MM formátumban. Az ablak abban az időzónában jön létre, amelyet a nyári időszámítás az adott időzónának megfelelően biztosít. A lejárati dátumot egy későbbi dátumra kell beállítania. Ha nincs megadva, akkor a maximális dátumidő 9999-12-31 23:59:59 lesz.
properties.maintenanceWindow.recurEvery A karbantartási időszak várható ismétlődési gyakorisága. A ráta kifejezhető napi, heti vagy havi ütemezésként. A napi ütemezéseket recurEvery formátumban is formázhatja: [Gyakoriság egész számként][Nap(ok)"). Ha nincs megadva gyakoriság, az alapértelmezett gyakoriság 1. A napi ütemezési példák a recurEvery: Day, recurEvery: 3Days. A heti ütemezések recurEvery formátumban vannak formázva: [Gyakoriság egész számként][Hét(ek)] [Nem kötelező vesszővel tagolt lista a hétköznapok hétfőtől vasárnapig]. A heti ütemezési példák a recurEvery: 3Weeks, recurEvery: Week Saturday, Sunday. A havi ütemezéseket [Gyakoriság egész számként][Hónap(ok)] [Havi napok vesszővel tagolt listája] vagy [Gyakoriság egész számként][Hónap(ok)] [Hónap hete (Első, Második, Harmadik, Negyedik, Utolsó)] [Hétköznap hétfőtől vasárnapig] formázhatja. A havi ütemezési példák ezek: Ismétlődik minden hónapban, Ismétlődik két havonta, Ismétlődik minden hónap 23. vagy 24. napján, Ismétlődik minden hónap utolsó vasárnapján, Ismétlődik minden hónap negyedik hétfőjén.
properties.maintenanceWindow.startDateTime A karbantartási időszak érvényes kezdő dátuma YYYY-MM-DD hh:mm formátumban. Beállíthatja a kezdő dátumot az aktuális vagy a jövőbeli dátumra. Az ablak a megadott időzónában lesz létrehozva, és az adott időzóna szerint a nyári időszámításhoz lesz igazítva.
properties.maintenanceWindow.timeZone Az időzónap neve. Az időzónák listáját a [System.TimeZoneInfo]:GetSystemTimeZones() powershell-parancs futtatásával szerezheti be. Példa: Csendes-óceáni téli idő, UTC, Nyugat-európai téli idő, Koreai standard idő, Közép-európai idő. Ausztráliai normál idő.
properties.namespace Lekéri vagy beállítja az erőforrás névterét
properties.visibility Megadja vagy beállítja a konfiguráció láthatóságát. Az alapértelmezett érték az "Egyéni"
systemData A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
tags Az erőforrás címkéinek lekérdezése vagy beállítása
type Az erőforrás típusa 
az maintenance configuration create \
   --resource-group myMaintenanceRG \
   --resource-name myConfig \
   --maintenance-scope InGuestPatch \
   --location eastus \
   --maintenance-window-duration "02:00" \
   --maintenance-window-recur-every "20days" \
   --maintenance-window-start-date-time "2022-12-30 07:00" \
   --maintenance-window-time-zone "Pacific Standard Time" \
   --install-patches-linux-parameters package-name-masks-to-exclude="ppt" package-name-masks-to-include="apt" classifications-to-include="Other" \
   --install-patches-windows-parameters kb-numbers-to-exclude="KB123456" kb-numbers-to-include="KB123456" classifications-to-include="FeaturePack" \
   --reboot-setting "IfRequired" \
   --extension-properties InGuestPatchMode="User"

Virtuális gép társítása egy ütemezéssel

Ha egy virtuális gépet karbantartási konfigurációs ütemezéshez szeretne társítani, adja meg a következő PUT-kérést:

PUT on `<ARC or Azure VM resourceId>/providers/Microsoft.Maintenance/configurationAssignments/<configurationAssignment name>?api-version=2021-09-01-preview`

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/{subscription ID}/resourcegroups/myMaintenanceRG/providers/Microsoft.Maintenance/maintenanceConfigurations/myConfig"

Gép eltávolítása az ütemezésből

Ha el szeretne távolítani egy gépet az ütemezésből, kérje le annak a gépnek az összes konfiguráció-hozzárendelési nevét, amelyet azért hozott létre, hogy a gépet az Azure Resource Graph aktuális ütemezéséhez társítsa az alábbiak szerint:

az maintenance configuration delete \
   --resource-group myMaintenanceRG \
   --location eastus \
   --resource-name myVM \
   --resource-type virtualMachines \
   --provider-name Microsoft.Compute \
   --configuration-assignment-name myConfig \
   --maintenance-configuration-id "/subscriptions/{subscription ID}/resourcegroups/myMaintenanceRG/providers/Microsoft.Maintenance/maintenanceConfigurations/myConfig"

Következő lépések

  • Last updated on