Verwaltung von Azure Arc-Erweiterungen auf Azure Stack HCI
Artikel
Gilt für: Azure Stack HCI, Versionen 23H2 und 22H2
In diesem Artikel wird beschrieben, wie Sie Azure Arc-Erweiterungen auf Azure Stack HCI-Servercomputern installieren, aktualisieren und verwalten.
Kundenseitig verwaltete Azure Arc-Erweiterungen in Azure Stack HCI
Mit Azure Stack HCI können Sie Azure Arc-Erweiterungen auf Ihren Azure Stack HCI-Systemen 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 aufgeführt, die Sie installieren und verwalten können.
Von Azure verwaltete Erweiterungen in Azure Stack HCI
Nachdem Sie Ihren neuen Azure Stack HCI-Cluster erfolgreich bei Azure registriert haben, werden von Azure verwaltete Erweiterungen automatisch auf Ihrem Cluster 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 einen vorhandenen Azure Stack HCI-Cluster verfügen, der 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.
Dies sind die von Azure verwalteten Erweiterungen:
Sie können Erweiterungen auf der Registerkarte Funktionen für Ihre Azure Stack HCI Arc-fähigen 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 Servern des Clusters installiert. Wenn Sie Ihrem Cluster weitere Server hinzufügen, werden alle in Ihrem Cluster installierten Erweiterungen automatisch den neuen Servern hinzugefügt.
Die 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 unter Schnellstart 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 Ihren 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 erweiterung Windows Admin Center auf allen Clustern 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 Clustern 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 Clustern 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 können in Azure Cloud Shell ausgeführt werden. In diesem Dokument wird die Verwendung von PowerShell in Azure Cloud Shell beschrieben. Weitere Informationen finden Sie unter Schnellstart für Azure Cloud Shell.
Starten Sie Azure Cloud Shell, und installieren Sie mithilfe von PowerShell eine Erweiterung, indem Sie die folgenden Schritte ausführen:
Richten Sie Parameter aus Ihrem Abonnement, Ihrer Ressourcengruppe und Ihren Clustern ein:
$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 erweiterung Windows Admin Center auf allen Clustern unter der Ressourcengruppe zu installieren:
Um die Azure Site Recovery-Erweiterung auf allen Clustern 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
}
Sie können die status einer Erweiterung auf jedem Server auf der Seite Erweiterungen überprüfen, indem Sie die spalte status des Rasters anzeigen.
Die 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 unter Schnellstart für Azure Cloud Shell.
Starten Sie Azure Cloud Shell, und verwenden Sie Bash, um die status einer Erweiterung mithilfe der folgenden Schritte zu überprüfen:
Einrichten von Parametern aus Ihrem Abonnement, Ihrer Ressourcengruppe, Ihrem Clusternamen und Ihrem 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 in einem Cluster auflisten:
az stack-hci extension list \
--arc-setting-name "default" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}" \
-o table
Führen Sie den folgenden Befehl aus, um eine bestimmte Erweiterung wie herauszufiltern AzureMonitorWindowsAgent:
Azure PowerShell können in Azure Cloud Shell ausgeführt werden. In diesem Dokument wird die Verwendung von PowerShell in Azure Cloud Shell beschrieben. Weitere Informationen finden Sie unter Schnellstart für Azure Cloud Shell.
Starten Sie Azure Cloud Shell, und verwenden Sie PowerShell, um die status einer Erweiterung mithilfe der folgenden Schritte zu überprüfen:
Einrichten von Parametern aus Ihrem Abonnement, Ihrer Ressourcengruppe und ihrem 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 in einem Cluster auflisten:
Bei der Veröffentlichung durch das Erweiterungsherausgeberteam ersetzt der Erweiterungsupgradeprozess die vorhandene Erweiterungsversion durch eine neu unterstützte Version. Standardmäßig ist das Feature für automatische Erweiterungsupgrades für alle Erweiterungen aktiviert, die in Azure Stack HCI Arc-fähigen Clustern bereitgestellt werden, es sei denn, Sie deaktivieren automatische Upgrades explizit.
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 Auswirkungen, bis der Erweiterungsherausgeber das automatische Erweiterungsupgrade unterstützt.
Für einige 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 AzureMonitorWindowsAgent folgenden Befehl aus, um das automatische Upgrade für eine bestimmte Erweiterung 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 AzureMonitorWindowsAgent folgenden Befehl aus, um das automatische Upgrade für eine bestimmte Erweiterung 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 automatische Erweiterungsupgrade. Wenn Sie ein manuelles Upgrade einer Erweiterung durchführen, speichert Azure in einem Azure Stack HCI Arc-fähigen Cluster die ausgewählte Version. Azure versucht dann, die Erweiterung auf allen Servern im Cluster auf diese Version zu aktualisieren.
Wenn das Erweiterungsupgrade auf einigen Servern fehlschlägt, versucht die Plattform, während der nächsten Azure Stack HCI-Cloudsynchronisierung ein Upgrade auf die ausgewählte Version durchzuführen.
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 besteht ein Versionskonflikt zwischen verschiedenen Servern des Azure Stack HCI-Clusters.
Führen Sie die folgenden Schritte aus, um ein manuelles Upgrade einer Erweiterung durchzuführen:
Wechseln Sie zur Seite Erweiterungen .
Wählen Sie die Erweiterung aus, die Sie aktualisieren möchten, und wählen Sie im oberen Menü Einstellungen 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 für einzelne Azure Arc-fähige Serverressourcen, Ressourcengruppen und Abonnements anzeigen, um den Verlauf der automatischen Erweiterungsupgrades für einzelne Clusterserver 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 Stack HCI Arc-fähigen Clustern, die einem Upgrade unterzogen werden, verwendete die Azure-Plattform das Upgrademodell der automatischen Erweiterung , um Upgrades zu orchestrieren.
Zeitpunkt automatischer Erweiterungsupgrades
Wenn eine neue Version einer unterstützten Erweiterung veröffentlicht wird, wird sie für die Installation und das manuelle Upgrade auf Azure Arc-fähigen Servern verfügbar. Upgrades werden in Batches über Azure-Regionen und -Abonnements hinweg ausgegeben, sodass möglicherweise ein Erweiterungsupgrade auf einigen Servern vor anderen ausgeführt wird. Weitere Informationen finden Sie unter Timing von automatischen Erweiterungsupgrades.
Automatischer Rollback und automatische Wiederholungen
Wenn ein Erweiterungsupgrade fehlschlägt, führt Azure die Aktionen aus, die mit automatischem Rollback und Wiederholungen verknüpft sind, um die Erweiterung zu reparieren.
Wenn mehrere Erweiterungsupgrades für einen Computer verfügbar sind, werden diese möglicherweise im Batch zusammengefasst. Jedes Erweiterungsupgrade wird jedoch einzeln auf den Computer angewendet. Weitere Informationen finden Sie unter Erweiterungsupgrades mit mehreren Erweiterungen.
Bei Bedarf können Sie einige Erweiterungen aus Ihren Azure Stack HCI-Clustern 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.
Führen Sie den folgenden Befehl aus, um eine bestimmte Erweiterung zu AzureMonitorWindowsAgent entfernen:
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}"
Führen Sie den folgenden Befehl aus, um eine bestimmte Erweiterung zu AzureMonitorWindowsAgent entfernen:
$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 fehlerhaften status den Link Fehler (Details anzeigen) aus. Zeigen Sie alle Informationen zum Fehler an, und wenden Sie die Tipps zur Problembehandlung an.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.