Azure Arc-Erweiterungsverwaltung auf Azure Local

Artikel
11/23/2024

Gilt für: Azure Local, Versionen 23H2 und 22H2

In diesem Artikel wird beschrieben, wie Sie Azure Arc-Erweiterungen auf Azure Local installieren, aktualisieren und verwalten.

Vom Kunden verwaltete Azure Arc-Erweiterungen auf Azure Local

Sie können Azure Arc-Erweiterungen auf Ihrem lokalen Azure-Standort installieren, deinstallieren und aktualisieren. Mit Azure Arc können Sie Hybriddienste wie Überwachung und Windows Admin Center im Azure-Portal ausführen.

Hier sind die einzelnen Erweiterungen, die Sie installieren und verwalten können.

Azure-verwaltete Erweiterungen in Azure Local

Nachdem Sie Ihre neue Azure Local mit Azure erfolgreich registriert haben, werden von Azure verwaltete Erweiterungen automatisch auf Ihrem System installiert. Diese Erweiterungen sind für die Funktionalität und Qualität Ihres Systems unerlässlich und können nicht deinstalliert werden. Sie können das Verhalten dieser Erweiterungen im Azure-Portal verwalten, indem Sie zur Seite "Erweiterungen" navigieren und das Menü "Einstellungen" auswählen.

Wenn Sie über ein lokales Azure verfügen, das ohne diese Erweiterungen bei Azure registriert ist, wird auf der Seite "Übersicht" oder "Erweiterungen" im Azure-Portal ein Banner angezeigt. Sie können die Informationen im Banner verwenden, um Sie durch die Installation dieser Erweiterungen zu führen.

Hier sind die von Azure verwalteten Erweiterungen:

Installieren einer Erweiterung

Sie können Erweiterungen auf der Registerkarte "Funktionen " für Ihre lokalen Arc-Server installieren, wie im Screenshot gezeigt. Sie können die Registerkarte "Funktionen" verwenden, um die meisten Erweiterungen zu installieren.

Wenn Sie eine Erweiterung im Azure-Portal installieren, handelt es sich um einen clusterfähigen Vorgang. Die Erweiterung wird auf allen Knoten des Systems installiert. Wenn Sie Ihrem System weitere Knoten hinzufügen, werden alle auf Ihrem System installierten Erweiterungen automatisch den neuen Servern hinzugefügt.

Azure CLI ist für die Installation in Windows-, macOS- und Linux-Umgebungen verfügbar. Sie kann auch in Azure Cloud Shell ausgeführt werden. Weitere Informationen finden Sie in der Schnellstartanleitung für Azure Cloud Shell.

Starten Sie Azure Cloud Shell , und verwenden Sie Bash, um eine Erweiterung mit den folgenden Schritten zu installieren:

Einrichten von Parametern aus Ihrem Abonnement, Ihrer Ressourcengruppe und Clustern

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'))

Führen Sie den folgenden Befehl aus, um die Windows Admin Center-Erweiterung auf allen Systemen unter der Ressourcengruppe zu installieren:

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

Führen Sie den folgenden Befehl aus, um die Azure Monitor Agent-Erweiterung auf allen Systemen unter der Ressourcengruppe zu installieren:

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

Führen Sie den folgenden Befehl aus, um die Azure Site Recovery-Erweiterung auf allen Systemen unter der Ressourcengruppe zu installieren:

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 kann in Azure Cloud Shell ausgeführt werden. In diesem Dokument wird erläutert, wie PowerShell in Azure Cloud Shell verwendet wird. Weitere Informationen finden Sie in der Schnellstartanleitung für Azure Cloud Shell.

Starten Sie Azure Cloud Shell , und verwenden Sie PowerShell, um eine Erweiterung zu installieren, indem Sie die folgenden Schritte ausführen:

Einrichten von Parametern aus Ihrem Abonnement, Ihrer Ressourcengruppe und Clustern:

$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

Führen Sie den folgenden Befehl aus, um die Windows Admin Center-Erweiterung auf allen Systemen unter der Ressourcengruppe zu installieren:

$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
}

Führen Sie den folgenden Befehl aus, um die Azure Monitor Agent-Erweiterung auf allen Systemen unter der Ressourcengruppe zu installieren:

$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}"
}

Um die Azure Site Recovery-Erweiterung auf allen Systemen unter der Ressourcengruppe zu installieren, erstellen Sie eine JSON-Parameterdatei, und führen Sie dann den folgenden Befehl aus:

$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
}

Überprüfen des Erweiterungsstatus

Sie können den Status einer Erweiterung auf jedem Server über die Seite "Erweiterungen " überprüfen, indem Sie die Statusspalte des Rasters anzeigen.

Starten Sie Azure Cloud Shell , und verwenden Sie Bash, um den Status einer Erweiterung zu überprüfen, indem Sie die folgenden Schritte ausführen:

Einrichten von Parametern aus Ihrem Abonnement, der Ressourcengruppe, dem Clusternamen und dem Erweiterungsnamen

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}"

Führen Sie den folgenden Befehl aus, um alle Erweiterungen auf einem System auflisten zu können:

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

Um eine bestimmte Erweiterung wie AzureMonitorWindowsAgentfolgt auszufiltern, führen Sie den folgenden Befehl aus:

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

Starten Sie Azure Cloud Shell , und verwenden Sie PowerShell, um den Status einer Erweiterung zu überprüfen, indem Sie die folgenden Schritte ausführen:

Einrichten von Parametern aus Ihrem Abonnement, Ihrer Ressourcengruppe und dem Clusternamen

$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

Führen Sie den folgenden Befehl aus, um alle Erweiterungen auf einem System auflisten zu können:

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

Funktionsweise des Erweiterungsupgrades

Bei der Veröffentlichung durch das Publisher-Team der Erweiterung ersetzt der Erweiterungsupgradeprozess die vorhandene Erweiterungsversion durch eine neu unterstützte Version. Standardmäßig ist das Feature für das automatische Erweiterungsupgrade für alle Erweiterungen aktiviert, die in azure Local Arc-fähigen Clustern bereitgestellt werden, es sei denn, Sie deaktivieren explizit automatische Upgrades.

Derzeit werden automatische Erweiterungsupgrades nur in der Windows Admin Center-Erweiterung unterstützt, aber in Zukunft werden weitere Erweiterungen hinzugefügt.

Hinweis

Standardmäßig sind alle Erweiterungen so eingerichtet, dass automatische Upgrades aktiviert werden, auch wenn eine Erweiterung das automatische Erweiterungsupgrade nicht unterstützt. Diese Standardeinstellung hat jedoch keine Auswirkung, bis der Erweiterungsherausgeber die automatische Erweiterungsupgrade unterstützt.

Aktivieren des automatischen Erweiterungsupgrades

Bei einigen Erweiterungen können Sie automatische Upgrades über die Erweiterungsverwaltung aktivieren.

Um ein automatisches Upgrade zu aktivieren, navigieren Sie zur Seite "Erweiterungen ", und führen Sie die folgenden Schritte aus:

Wählen Sie die Erweiterung aus, für die Sie das automatische Upgrade aktivieren möchten.
Wählen Sie im oberen Menü die Option "Automatisches Upgrade aktivieren" aus.
Wenn Sie aufgefordert werden, Ihre Absicht zu bestätigen, wählen Sie "OK" aus.

Führen Sie den folgenden Befehl aus, um das automatische Upgrade für eine bestimmte Erweiterung AzureMonitorWindowsAgent zu installieren und zu aktivieren:

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"

Führen Sie den folgenden Befehl aus, um das automatische Upgrade für eine bestimmte Erweiterung AzureMonitorWindowsAgent zu installieren und zu aktivieren:

$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

Manuelles Erweiterungsupgrade über die Azure-Portal

Das manuelle Erweiterungsupgrade funktioniert wie das Upgrade der automatischen Erweiterung. Wenn Sie eine Erweiterung manuell aktualisieren, speichert Azure auf einem lokalen Arc-fähigen Cluster die ausgewählte Version. Azure versucht dann, die Erweiterung auf allen Knoten im Cluster auf diese Version zu aktualisieren.

Wenn das Erweiterungsupgrade auf einigen Servern fehlschlägt, versucht die Plattform, während der nächsten lokalen Azure-Cloudsynchronisierung auf die ausgewählte Version zu aktualisieren.

Verwenden Sie den manuellen Workflow in diesen Szenarien:

Eine neue Version der Erweiterung ist verfügbar, und Sie möchten sie manuell aktualisieren.
Die Option für das automatische Upgrade der Erweiterung ist deaktiviert, und es gibt einen Versionskonflikt über verschiedene Knoten von Azure Local.

Führen Sie die folgenden Schritte aus, um eine Erweiterung manuell zu aktualisieren:

Wechseln Sie zur Seite " Erweiterungen ".
Wählen Sie die Erweiterung aus, die Sie aktualisieren möchten, und wählen Sie " Einstellungen" im oberen Menü aus.
Wählen Sie die neueste Version und dann "Speichern" aus.

Deaktivieren des automatischen Erweiterungsupgrades

Sie können automatische Upgrades für bestimmte Erweiterungen im Azure-Portal deaktivieren. Um automatische Upgrades zu deaktivieren, navigieren Sie zur Seite "Erweiterungen ", und führen Sie die folgenden Schritte aus:

Wählen Sie die Erweiterung aus, für die Sie das automatische Upgrade deaktivieren möchten.
Wählen Sie im oberen Menü die Option "Automatisches Upgrade deaktivieren" aus.
Wenn Sie aufgefordert werden, Ihre Absicht zu bestätigen, wählen Sie "OK" aus.

Überprüfen des Erweiterungsupgradeverlaufs

Sie können die Registerkarte "Aktivitätsprotokoll" auf einzelnen Azure Arc-fähigen Serverressourcen, Ressourcengruppen und Abonnements anzeigen, um den Verlauf der automatischen Erweiterungsupgrades für einzelne Knoten zu überprüfen. Weitere Informationen finden Sie unter "Überprüfen des Verlaufs des automatischen Erweiterungsupgrades".

Updates nach Verfügbarkeit

Für eine Gruppe von azure Local Arc-fähigen Clustern, die ein Upgrade durchführen, verwendete die Azure-Plattform das Modell für das automatische Erweiterungsupgrade , um Upgrades zu koordinieren.

Zeitplan für automatische Erweiterungsupgrades

Wenn eine neue Version einer unterstützten Erweiterung veröffentlicht wird, steht sie für die Installation und manuelle Aktualisierung auf Azure Arc-fähigen Servern zur Verfügung. Upgrades werden in Batches in Azure-Regionen und -Abonnements ausgegeben, sodass möglicherweise ein Erweiterungsupgrade auf einigen Servern vor anderen auftritt. Weitere Informationen finden Sie unter Anzeigedauer von automatischen Erweiterungsupgrades.

Informationen zum sofortigen Upgrade einer Erweiterung finden Sie unter Manuelles Erweiterungsupgrade über die Azure-Portal.

Automatischer Rollback und automatische Wiederholungen

Wenn ein Erweiterungsupgrade fehlschlägt, führt Azure die Aktionen aus, die mit dem automatischen Rollback verknüpft sind, und versucht , die Erweiterung zu reparieren.

Wenn weiterhin Probleme mit einem Erweiterungsupgrade auftreten, können Sie das automatische Erweiterungsupgrade deaktivieren. Wenn Sie das automatische Upgrade deaktivieren, verhindert es, dass Systemneuversuche bei der Problembehandlung auftreten. Sie können das automatische Erweiterungsupgrade erneut aktivieren, wenn Sie bereit sind.

Upgrades mit mehreren Erweiterungen

Wenn mehrere Erweiterungsupgrades für einen Knoten verfügbar sind, werden sie möglicherweise zusammen gestapelt. Jedes Erweiterungsupgrade wird jedoch einzeln auf den Knoten angewendet. Weitere Informationen finden Sie unter Erweiterungsupgrades mit mehreren Erweiterungen.

Deinstallieren einer Erweiterung

Wenn gewünscht, können Sie einige Erweiterungen aus Ihrem azure Local im Azure-Portal deinstallieren. Führen Sie die folgenden Schritte aus, um eine Erweiterung zu deinstallieren:

Wechseln Sie zur Seite " Erweiterungen".
Wählen Sie die Erweiterung aus, die Sie deinstallieren möchten. Die Schaltfläche "Deinstallieren" ist für von Azure verwaltete Erweiterungen nicht verfügbar.
Wählen Sie im oberen Menü "Deinstallieren" aus.
Bestätigen Sie die Absicht, und wählen Sie "Ja" aus.

So entfernen Sie eine bestimmte Erweiterung wie AzureMonitorWindowsAgent den folgenden Befehl:

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}"

So entfernen Sie eine bestimmte Erweiterung wie AzureMonitorWindowsAgent den folgenden Befehl:

$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}"

Problembehandlung bei Erweiterungsfehlern

Erweiterungsstatus: Fehler

Empfehlung: Wählen Sie für eine Erweiterung mit einem fehlgeschlagenen Status den Link "Fehlgeschlagen" (Details anzeigen) aus. Zeigen Sie alle Informationen zum Fehler an, und wenden Sie die Tipps zur Problembehandlung an.

Nächster Schritt

Erfahren Sie mehr über die Erweiterungsverwaltung virtueller Computer mit Azure Arc-fähigen Servern.

Freigeben über