Azure Arc-bővítmények kezelése az Azure Stack HCI-n

A következőkre vonatkozik: Azure Stack HCI, 23H2 és 22H2 verzió

Ez a cikk bemutatja, hogyan telepíthetők, frissíthetők és kezelhetők az Azure Arc-bővítmények az Azure Stack HCI-kiszolgálógépeken.

Ügyfél által felügyelt Azure Arc-bővítmények az Azure Stack HCI-ben

Az Azure Stack HCI-vel Azure Arc-bővítményeket telepíthet, távolíthat el és frissíthet az Azure Stack HCI-rendszereken. Az Azure Arc lehetővé teszi olyan hibrid szolgáltatások futtatását, mint a monitorozás és a Windows Admin Center a Azure Portal.

Íme az egyes bővítmények, amelyeket telepíthet és kezelhet.

• Azure Monitoring Agent
• Azure Site Recovery
• Windows Admin Center

Azure-beli felügyelt bővítmények az Azure Stack HCI-ben

Miután sikeresen regisztrálta az új Azure Stack HCI-fürtöt az Azure-ban, az Azure által felügyelt bővítmények automatikusan települnek a fürtre. Ezek a bővítmények elengedhetetlenek a rendszer működéséhez és minőségéhez, és nem távolíthatók el. A bővítmények viselkedését a Azure Portal a Bővítmények lapra lépve és a Beállítások menüben kezelheti.

Ha rendelkezik egy meglévő Azure Stack HCI-fürttel, amely ezen bővítmények nélkül van regisztrálva az Azure-ban, egy szalagcím jelenik meg a Azure Portal Áttekintés vagy Bővítmények lapján. A szalagcímben található információk segítségével végigvezetheti a bővítmények telepítésén.

Íme az Azure által felügyelt bővítmények:

• Telemetria és diagnosztika
• Távoli támogatási Arc-bővítmény

Bővítmény telepítése

Azure Portal

Bővítményeket az Azure Stack HCI Arc-kompatibilis kiszolgálók Képességek lapján telepíthet a képernyőképen látható módon. A képességek lapon telepítheti a legtöbb bővítményt.

Amikor bővítményt telepít a Azure Portal, az egy fürtbarát művelet. A bővítmény a fürt összes kiszolgálójára telepítve van. Ha több kiszolgálót ad hozzá a fürthöz, a fürtre telepített összes bővítmény automatikusan hozzá lesz adva az új kiszolgálókhoz.

Azure CLI

Az Azure CLI telepíthető Windows, macOS és Linux rendszerű környezetekben. Az Azure Cloud Shell is futtatható. További információért tekintse meg az Azure Cloud Shell rövid útmutatóját.

Indítsa el az Azure Cloud Shell, és a Bash használatával telepítsen egy bővítményt az alábbi lépések végrehajtásával:

1. Paraméterek beállítása az előfizetésből, az erőforráscsoportból és a fürtökből

   subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   resourceGroup="hcicluster-rg" # Replace with your resource group name
   
   az account set --subscription "${subscription}"
   
   clusters=($(az graph query -q "resources | where type == 'microsoft.azurestackhci/clusters'| where resourceGroup =~ '${resourceGroup}' | project name" | jq -r '.data[].name'))
   

2. Ha telepíteni szeretné a Windows Admin Center bővítményt az erőforráscsoport összes fürtjén, futtassa a következő parancsot:

   extensionName="AdminCenter"
   extensionType="AdminCenter"
   extensionPublisher="Microsoft.AdminCenter"
   settingsConfig="{'port':'6516'}"
   connectivityProps="{enabled:true}"
   
   for cluster in ${clusters}; do
       echo "Enabling Connectivity for cluster $currentCluster"
       az stack-hci arc-setting update \
           --resource-group ${resourceGroup} \
           --cluster-name ${cluster} \
           --name "default" \
           --connectivity-properties ${connectivityProps}
   
       echo "Installing extension: ${extensionName} on cluster: ${cluster}"
       az stack-hci extension create \
           --arc-setting-name "default" \
           --cluster-name "${cluster}" \
           --resource-group "${resourceGroup}" \
           --name "${extensionName}" \
           --auto-upgrade "true" \
           --publisher "${extensionPublisher}" \
           --type "${extensionType}" \
           --settings "${settingsConfig}"
   done
   

3. Ha telepíteni szeretné az Azure Monitor Agent bővítményt az erőforráscsoport összes fürtjén, futtassa a következő parancsot:

   extensionName="AzureMonitorWindowsAgent"
   extensionType="AzureMonitorWindowsAgent"
   extensionPublisher="Microsoft.Azure.Monitor"
   
   for cluster in ${clusters}; do
       echo "Installing extension: ${extensionName} on cluster: ${cluster}"
   
       az stack-hci extension create \
           --arc-setting-name "default" \
           --cluster-name "${cluster}" \
           --resource-group "${resourceGroup}" \
           --name "${extensionName}" \
           --auto-upgrade "true" \
           --publisher "${extensionPublisher}" \
           --type "${extensionType}"
   done
   

4. Ha az Azure Site Recovery bővítményt az erőforráscsoport összes fürtjén telepíteni szeretné, futtassa a következő parancsot:

   asrSubscription="00000000-0000-0000-0000-000000000000" # Replace with your ASR subscription ID
   asrResourceGroup="asr-rg" # Replace with your ASR resource group
   asrVaultName="asr-vault" # Replace with your ASR vault name
   asrLocation="East US" # Replace with your ASR Location
   asrSiteId="00000000-0000-0000-0000-000000000000" # Replace with your ASR Site ID
   asrSiteName="asr-site" # Replace with your Site Name
   asrSitePolicyId="/subscriptions/${asrSubscription}/resourceGroups/${asrResourceGroup}/providers/Microsoft.RecoveryServices/vaults/${asrVaultName}/replicationPolicies/s-cluster-policy" # Replace with your Site Policy name
   
   extensionName="ASRExtension"
   extensionType="Windows"
   extensionPublisher="Microsoft.SiteRecovery.Dra"
   jsonFile="./tmp-asr.json" #Temp JSON file
   
   echo "{\"SubscriptionId\": \"${asrSubscription}\", \"Environment\": \"AzureCloud\",\"ResourceGroup\": \"${asrResourceGroup}\",\"Location\": \"${asrLocation}\",\"SiteId\": \"${asrSiteId}\", \"SiteName\": \"${asrSiteName}\", \"PolicyId\": \"${asrSitePolicyId}\", \"PrivateEndpointStateForSiteRecovery\": \"None\" }" > ${jsonFile}
   
   for cluster in ${clusters}; do
       echo "Installing extension: ${extensionName} on cluster: ${cluster}"
   
       az stack-hci extension create \
           --arc-setting-name "default" \
           --cluster-name "${cluster}" \
           --resource-group "${resourceGroup}" \
           --name "${extensionName}" \
           --auto-upgrade "true" \
           --publisher "${extensionPublisher}" \
           --type "${extensionType}" \
           --settings "${jsonFile}"
   done
   

Azure PowerShell

Azure PowerShell az Azure Cloud Shell-ban futtathatók. Ez a dokumentum részletesen ismerteti, hogyan használható a PowerShell az Azure Cloud Shell-ben. További információért tekintse meg az Azure Cloud Shell rövid útmutatóját.

Indítsa el az Azure Cloud Shell, és a PowerShell használatával telepítsen egy bővítményt az alábbi lépések végrehajtásával:

1. Paraméterek beállítása az előfizetésből, az erőforráscsoportból és a fürtökből:

   $subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   $resourceGroup = "hcicluster-rg" # Replace with your resource group name
   
   Set-AzContext -Subscription "${subscription}"
   $clusters = Get-AzResource -ResourceType "Microsoft.AzureStackHCI/clusters" -ResourceGroupName ${resourceGroup} | Select-Object -Property Name
   

2. Ha telepíteni szeretné a Windows Admin Center bővítményt az erőforráscsoport összes fürtjén, futtassa a következő parancsot:

   $extensionName = "AdminCenter"
   $extensionType = "AdminCenter"
   $extensionPublisher = "Microsoft.AdminCenter"
   $settingsConfig = @{"port" = 6516 }
   
   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
   
       Write-Output ("Enable connectivity for cluster ${clusterName}")
       Invoke-AzRestMethod `
           -Method PATCH `
           -SubscriptionId ${subscription} `
           -ResourceGroupName ${resourceGroup} `
           -ResourceProviderName "Microsoft.AzureStackHCI" `
           -ResourceType ("clusters/" + ${clusterName} + "/arcSettings") `
           -Name "default" `
           -ApiVersion "2023-02-01" `
           -Payload (@{"properties" = @{ "connectivityProperties" = @{ "enabled" = $true } } } | ConvertTo-Json -Depth 5)
   
   
       Write-Output ("Installing Extension '${extensionName}' on cluster ${clusterName}")
   
       New-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default" `
           -Name "${extensionName}" `
           -ExtensionParameterPublisher "${extensionPublisher}" `
           -ExtensionParameterType "${extensionType}" `
           -ExtensionParameterSetting ${settingsConfig} `
           -NoWait
   }
   

3. Ha telepíteni szeretné az Azure Monitor Agent bővítményt az erőforráscsoport összes fürtjén, futtassa a következő parancsot:

   $extensionName = "AzureMonitorWindowsAgent"
   $extensionType = "AzureMonitorWindowsAgent"
   $extensionPublisher = "Microsoft.Azure.Monitor"
   
   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
   
       Write-Output ("Installing Extension '${extensionType}/${extensionPublisher}' on cluster ${clusterName}")
   
       New-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default" `
           -Name "${extensionName}" `
           -ExtensionParameterPublisher "${extensionPublisher}" `
           -ExtensionParameterType "${extensionType}"
   }
   

4. Ha telepíteni szeretné az Azure Site Recovery bővítményt az erőforráscsoport összes fürtjére, hozzon létre egy JSON-paraméterfájlt, majd futtassa a következő parancsot:

   $settings = @{
       SubscriptionId = "<Replace with your Subscription Id>"
       Environment = "<Replace with the cloud environment type. For example: AzureCloud>"
       ResourceGroup = "<Replace with your Site Recovery Vault resource group>"
       ResourceName = "<Replace with your Site Recovery Vault Name>"
       Location = "<Replace with your Site Recovery Azure Region>"
       SiteId = "<Replace with the ID of your recovery site>"
       SiteName = "<Replace with your recovery site name>"
       PolicyId = "<Replace with resource ID of your recovery site policy>"
       PrivateEndpointStateForSiteRecovery = "None"
   }
   
   $extensionName = "ASRExtension"
   $extensionType = "Windows"
   $extensionPublisher = "Microsoft.SiteRecovery.Dra"
   
   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
   
       Write-Output ("Installing Extension '${extensionType}/${extensionPublisher}' on cluster ${clusterName}")
   
       New-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default" `
           -Name "${extensionName}" `
           -ExtensionParameterPublisher "${extensionPublisher}" `
           -ExtensionParameterType "${extensionType}" `
           -ExtensionParameterSetting ${settings} `
           -NoWait
   }
   

A bővítmény állapotának ellenőrzése

Azure Portal

A bővítmények állapotát az egyes kiszolgálókon a Bővítmények lapon ellenőrizheti a rács állapotoszlopának megtekintésével.

Azure CLI

Az Azure CLI telepíthető Windows, macOS és Linux rendszerű környezetekben. Az Azure Cloud Shell is futtatható. További információért tekintse meg az Azure Cloud Shell rövid útmutatóját.

Indítsa el az Azure Cloud Shell, és a Bash használatával ellenőrizze egy bővítmény állapotát az alábbi lépések végrehajtásával:

1. Paraméterek beállítása az előfizetésből, az erőforráscsoportból, a fürt nevéből és a bővítmény nevéből

   subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   resourceGroup="hcicluster-rg" # Replace with your resource group name
   clusterName="HCICluster" # Replace with your cluster name
   extensionName="AzureMonitorWindowsAgent" # Replace with the extension name
   
   az account set --subscription "${subscription}"
   

2. A fürt összes bővítményének listázásához futtassa a következő parancsot:

   az stack-hci extension list \
   --arc-setting-name "default" \
   --cluster-name "${clusterName}" \
   --resource-group "${resourceGroup}" \
   -o table
   

3. Egy adott bővítmény (például AzureMonitorWindowsAgent) szűréséhez futtassa a következő parancsot:

   az stack-hci extension list \
   --arc-setting-name "default" \
   --cluster-name "${clusterName}" \
   --resource-group "${resourceGroup}" \
   --query "[?name=='${extensionName}'].{Name:name, ManagedBy:managedBy, ProvisionStatus:provisioningState, State:aggregateState, Type:extensionParameters.type}" \
   -o table
   

Azure PowerShell

Azure PowerShell az Azure Cloud Shell-ban futtathatók. Ez a dokumentum részletesen ismerteti, hogyan használható a PowerShell az Azure Cloud Shell-ben. További információért tekintse meg az Azure Cloud Shell rövid útmutatóját.

Indítsa el az Azure Cloud Shell, és használja a PowerShellt a bővítmény állapotának ellenőrzéséhez az alábbi lépések végrehajtásával:

1. Paraméterek beállítása az előfizetésből, az erőforráscsoportból és a fürt nevéből

   $subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   $resourceGroup = "hcicluster-rg" # Replace with your resource group name
   
   Set-AzContext -Subscription "${subscription}"
   $clusters = Get-AzResource -ResourceType "Microsoft.AzureStackHCI/clusters" -ResourceGroupName ${resourceGroup} | Select-Object -Property Name
   

2. A fürt összes bővítményének listázásához futtassa a következő parancsot:

   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
       Get-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default"|Format-Table -Property Name, ParameterType, ParameterPublisher, ParameterEnableAutomaticUpgrade, ProvisioningState
   }
   

A bővítményfrissítés működése

Amikor a bővítmény közzétevő csapata közzéteszi, a bővítményfrissítési folyamat lecseréli a meglévő bővítményverziót egy újonnan támogatott verzióra. Alapértelmezés szerint az automatikus bővítményfrissítési funkció engedélyezve van az Azure Stack HCI Arc-kompatibilis fürtökön üzembe helyezett összes bővítményhez, kivéve, ha kifejezetten lemondja az automatikus frissítéseket.

Jelenleg az automatikus bővítményfrissítések csak a Windows Admin Center bővítményben támogatottak, de a jövőben további bővítmények lesznek hozzáadva.

Megjegyzés

Alapértelmezés szerint minden bővítmény úgy van beállítva, hogy engedélyezze az automatikus frissítéseket, még akkor is, ha egy bővítmény nem támogatja az automatikus bővítményfrissítést. Ennek az alapértelmezett beállításnak azonban nincs hatása, amíg a bővítmény közzétevője nem támogatja az automatikus bővítményfrissítést.

Automatikus bővítményfrissítés engedélyezése

Azure Portal

Egyes bővítmények esetében engedélyezheti az automatikus frissítéseket a bővítménykezeléssel.

Az automatikus frissítés engedélyezéséhez lépjen a Bővítmények lapra, és hajtsa végre az alábbi lépéseket:

1. Válassza ki azt a bővítményt, amelyen engedélyezni szeretné az automatikus frissítést.

2. Válassza az Automatikus frissítés engedélyezése lehetőséget a felső menüből

   

3. Amikor a rendszer kéri a szándék megerősítését, válassza az OK gombot.

   

Azure CLI

Ha egy adott bővítményhez szeretné telepíteni és engedélyezni az automatikus frissítést, például AzureMonitorWindowsAgent futtassa a következő parancsot:

clusterName="HCICluster" # Replace with your cluster name
resourceGroup="hcicluster-rg" # Replace with your resource group name

extensionName="AzureMonitorWindowsAgent"
extensionPublisher="Microsoft.Azure.Monitor"
extensionType="AzureMonitorWindowsAgent"

az stack-hci extension create \
    --name "${extensionName}" \
    --arc-setting-name "default" \
    --cluster-name "${clusterName}" \
    --resource-group "${resourceGroup}" \
    --publisher ${extensionPublisher} \
    --type ${extensionType} \
    --auto-upgrade "true"

Azure PowerShell

Ha egy adott bővítményhez szeretné telepíteni és engedélyezni az automatikus frissítést, például AzureMonitorWindowsAgent futtassa a következő parancsot:

$clusterName = "HCICluster" # Replace with your cluster name
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

$extensionName = "AzureMonitorWindowsAgent"
$extensionType = "AzureMonitorWindowsAgent"
$extensionPublisher = "Microsoft.Azure.Monitor"

New-AzStackHciExtension `
    -ClusterName "${clusterName}" `
    -ResourceGroupName "${resourceGroup}" `
    -ArcSettingName "default" `
    -Name "${extensionName}" `
    -ExtensionParameterPublisher "${extensionPublisher}" `
    -ExtensionParameterType "${extensionType}" `
    -ExtensionParameterEnableAutomaticUpgrade

Manuális bővítményfrissítés a Azure Portal

A manuális bővítményfrissítés az Automatikus bővítményfrissítéshez hasonlóan működik. Egy Azure Stack HCI Arc-kompatibilis fürtön, amikor manuálisan frissít egy bővítményt, az Azure menti a kiválasztott verziót. Az Azure ezután megpróbálja frissíteni a bővítményt a fürt összes kiszolgálóján erre a verzióra.

Egyes kiszolgálókon, ha a bővítmény frissítése meghiúsul, a platform megpróbál frissíteni a kiválasztott verzióra a következő Azure Stack HCI-felhőszinkronizálás során.

Használja a manuális munkafolyamatot az alábbi esetekben:

• Elérhető a bővítmény új verziója, amelyet manuálisan szeretne frissíteni.

• A bővítmény automatikus frissítési lehetősége le van tiltva, és az Azure Stack HCI-fürt különböző kiszolgálói eltérő verziójúak.

A bővítmény manuális frissítéséhez kövesse az alábbi lépéseket:

1. Nyissa meg a Bővítmények lapot.

2. Válassza ki a frissíteni kívánt bővítményt, majd a felső menüben válassza a Beállítások lehetőséget.

   

3. Válassza ki a legújabb verziót, és válassza a Mentés lehetőséget.

Automatikus bővítményfrissítés letiltása

Az Azure Portal bizonyos bővítményeinél letilthatja az automatikus frissítéseket. Az automatikus frissítések letiltásához lépjen a Bővítmények lapra, és hajtsa végre az alábbi lépéseket:

1. Válassza ki azt a bővítményt, amelyen le szeretné tiltani az automatikus frissítést.

2. Válassza az Automatikus frissítés letiltása lehetőséget a felső menüben.

   

3. Amikor a rendszer kéri a szándék megerősítését, válassza az OK gombot.

   

A bővítmény frissítési előzményeinek ellenőrzése

Az Egyes Azure Arc-kompatibilis kiszolgálói erőforrások, erőforráscsoportok és előfizetések Tevékenységnapló lapján megtekintheti az egyes fürtkiszolgálók automatikus bővítményfrissítéseinek előzményeit. További információ: A bővítmények automatikus frissítési előzményeinek ellenőrzése.

Első rendelkezésre állási frissítések

A frissítés alatt álló Azure Stack HCI Arc-kompatibilis fürtök egy csoportjához az Azure platform az Automatikus bővítményfrissítési modellt használta a frissítések vezényléséhez.

Az automatikus bővítményfrissítések időzítése

A támogatott bővítmények új verziójának közzétételekor elérhetővé válik a telepítéshez és a manuális frissítéshez az Azure Arc-kompatibilis kiszolgálókon. A frissítéseket kötegekben bocsátják ki az Azure-régiókban és az előfizetésekben, így előfordulhat, hogy egyes kiszolgálókon a bővítményfrissítések mások előtt történnek. További információ: Az automatikus bővítményfrissítések időzítése.

Ha azonnal frissíteni szeretne egy bővítményt, olvassa el a Manuális bővítményfrissítés a Azure Portal keresztül című témakört.

Automatikus visszaállítás és újrapróbálkozások

Ha egy bővítmény frissítése sikertelen, az Azure végrehajtja az automatikus visszaállításhoz és újrapróbálkozásokhoz társított műveleteket a bővítmény javításának megkísérlése során.

Ha továbbra is problémákat tapasztal a bővítményfrissítéssel kapcsolatban, letilthatja az automatikus bővítményfrissítést. Ha letiltja az automatikus frissítést, az megakadályozza a rendszer újrapróbálkozását a probléma elhárítása során. Ha készen áll, ismét engedélyezheti az automatikus bővítményfrissítést .

Frissítések több bővítménnyel

Ha egy géphez több bővítményfrissítés is elérhető, előfordulhat, hogy a bővítmények kötegelve vannak. Az egyes bővítményfrissítések azonban egyenként lesznek alkalmazva a gépen. További információ: Bővítményfrissítések több bővítménnyel.

Bővítmény eltávolítása

Azure Portal

Igény szerint eltávolíthat néhány bővítményt az Azure Stack HCI-fürtökről a Azure Portal. Bővítmény eltávolításához kövesse az alábbi lépéseket:

1. Nyissa meg a Bővítmények lapot.

2. Válassza ki az eltávolítani kívánt bővítményt. Az eltávolítás gomb nem érhető el az Azure által felügyelt bővítményekhez.

   

3. Válassza az Eltávolítás lehetőséget a felső menüben.

4. Erősítse meg a szándékot, és válassza az Igen lehetőséget.

   

Azure CLI

Ha el szeretne távolítani egy adott bővítményt, például AzureMonitorWindowsAgent futtassa a következő parancsot:

extensionName="AzureMonitorWindowsAgent" # Replace with the extension name
resourceGroup="hcicluster-rg" # Replace with your resource group name
clusterName="HCICluster" # Replace with your cluster name

az stack-hci extension delete \
--arc-setting-name "default" \
--name "${extensionName}" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}"

Azure PowerShell

Ha el szeretne távolítani egy adott bővítményt, például AzureMonitorWindowsAgent futtassa a következő parancsot:

$clusterName = "HCICluster" # Replace with your cluster name
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

$extensionName = "AzureMonitorWindowsAgent"

Remove-AzStackHciExtension `
    -ClusterName "${clusterName}" `
    -ResourceGroupName "${resourceGroup}" `
    -ArcSettingName "default" `
    -Name "${extensionName}"

Bővítményhibák elhárítása

Bővítmény állapota: Nem sikerült

Javaslat: Sikertelen állapotú bővítmény esetén válassza a Sikertelen (Részletek megtekintése) hivatkozást. Tekintse meg a hibával kapcsolatos összes információt, és alkalmazza a hibaelhárítási tippeket.

Következő lépés

Tudnivalók a virtuálisgép-bővítmények Azure Arc-kompatibilis kiszolgálókkal történő kezeléséről.