Zarządzanie rozszerzeniami usługi Azure Arc w usłudze Azure Stack HCI
Artykuł
Dotyczy: Azure Stack HCI, wersje 23H2 i 22H2
W tym artykule opisano sposób instalowania i uaktualniania rozszerzeń usługi Azure Arc oraz zarządzania nimi na maszynach serwera azure Stack HCI.
Rozszerzenia usługi Azure Arc zarządzane przez klienta w usłudze Azure Stack HCI
Za pomocą rozwiązania Azure Stack HCI można instalować, odinstalować i aktualizować rozszerzenia usługi Azure Arc w systemach rozwiązania Azure Stack HCI. Usługa Azure Arc umożliwia uruchamianie usług hybrydowych, takich jak monitorowanie i Windows Admin Center w Azure Portal.
Oto poszczególne rozszerzenia, którymi można instalować i zarządzać.
Rozszerzenia zarządzane przez platformę Azure w usłudze Azure Stack HCI
Po pomyślnym zarejestrowaniu nowego klastra usługi Azure Stack HCI na platformie Azure rozszerzenia zarządzane przez platformę Azure są automatycznie instalowane w klastrze. Te rozszerzenia są niezbędne dla funkcjonalności i jakości systemu i nie można ich odinstalować. Zachowanie tych rozszerzeń można zarządzać w Azure Portal, przechodząc do strony Rozszerzenia i wybierając menu Ustawienia.
Jeśli masz istniejący klaster rozwiązania Azure Stack HCI zarejestrowany na platformie Azure bez tych rozszerzeń, na stronie Przegląd lub Rozszerzenia w Azure Portal zostanie wyświetlony baner. Możesz użyć informacji na banerze, aby przeprowadzić instalację tych rozszerzeń.
Oto rozszerzenia zarządzane przez platformę Azure:
Rozszerzenia można zainstalować na karcie Możliwości dla serwerów z obsługą usługi Azure Stack HCI Arc, jak pokazano na zrzucie ekranu. Możesz użyć karty możliwości, aby zainstalować większość rozszerzeń.
Po zainstalowaniu rozszerzenia w Azure Portal jest to operacja z obsługą klastra. Rozszerzenie jest instalowane na wszystkich serwerach klastra. Jeśli dodasz więcej serwerów do klastra, wszystkie rozszerzenia zainstalowane w klastrze zostaną automatycznie dodane do nowych serwerów.
Interfejs wiersza polecenia platformy Azure jest dostępny do zainstalowania w środowiskach systemów Windows, macOS i Linux. Można ją również uruchomić w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący usługi Azure Cloud Shell.
Konfigurowanie parametrów z subskrypcji, grupy zasobów i klastrów
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'))
Aby zainstalować rozszerzenie Windows Admin Center we wszystkich klastrach w grupie zasobów, uruchom następujące polecenie:
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
Aby zainstalować rozszerzenie agenta usługi Azure Monitor we wszystkich klastrach w grupie zasobów, uruchom następujące polecenie:
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
Aby zainstalować rozszerzenie usługi Azure Site Recovery we wszystkich klastrach w grupie zasobów, uruchom następujące polecenie:
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 można uruchomić w usłudze Azure Cloud Shell. W tym dokumencie szczegółowo opisano sposób używania programu PowerShell w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący usługi Azure Cloud Shell.
Uruchom usługę Azure Cloud Shell i użyj programu PowerShell, aby zainstalować rozszerzenie, wykonując następujące kroki:
Skonfiguruj parametry z subskrypcji, grupy zasobów i klastrów:
$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
Aby zainstalować rozszerzenie Windows Admin Center we wszystkich klastrach w grupie zasobów, uruchom następujące polecenie:
Aby zainstalować rozszerzenie usługi Azure Site Recovery we wszystkich klastrach w grupie zasobów, utwórz plik parametrów JSON, a następnie uruchom następujące polecenie:
$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
}
Stan rozszerzenia na każdym serwerze można sprawdzić na stronie Rozszerzenia , wyświetlając kolumnę stanu siatki.
Interfejs wiersza polecenia platformy Azure jest dostępny do zainstalowania w środowiskach systemów Windows, macOS i Linux. Można ją również uruchomić w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący usługi Azure Cloud Shell.
Uruchom usługę Azure Cloud Shell i użyj powłoki Bash, aby sprawdzić stan rozszerzenia, wykonując następujące kroki:
Konfigurowanie parametrów z subskrypcji, grupy zasobów, nazwy klastra i nazwy rozszerzenia
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}"
Aby wyświetlić listę wszystkich rozszerzeń w klastrze, uruchom następujące polecenie:
az stack-hci extension list \
--arc-setting-name "default" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}" \
-o table
Aby odfiltrować określone rozszerzenie, takie jak AzureMonitorWindowsAgent, uruchom następujące polecenie:
Azure PowerShell można uruchomić w usłudze Azure Cloud Shell. W tym dokumencie szczegółowo opisano sposób używania programu PowerShell w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący usługi Azure Cloud Shell.
Uruchom usługę Azure Cloud Shell i użyj programu PowerShell, aby sprawdzić stan rozszerzenia, wykonując następujące kroki:
Konfigurowanie parametrów z subskrypcji, grupy zasobów i nazwy klastra
$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
Aby wyświetlić listę wszystkich rozszerzeń w klastrze, uruchom następujące polecenie:
Po opublikowaniu przez zespół wydawcy rozszerzeń proces uaktualniania rozszerzenia zastępuje istniejącą wersję rozszerzenia nowo obsługiwaną wersją. Domyślnie funkcja automatycznego uaktualniania rozszerzenia jest włączona dla wszystkich rozszerzeń wdrożonych w klastrach z obsługą usługi Azure Stack HCI Arc, chyba że jawnie zrezygnujesz z automatycznych uaktualnień.
Obecnie automatyczne uaktualnienia rozszerzeń są obsługiwane tylko w rozszerzeniu Windows Admin Center, ale w przyszłości zostanie dodanych więcej rozszerzeń.
Uwaga
Domyślnie wszystkie rozszerzenia są skonfigurowane w celu włączenia automatycznych uaktualnień, nawet jeśli rozszerzenie nie obsługuje automatycznego uaktualniania rozszerzenia. Jednak to ustawienie domyślne nie ma wpływu, dopóki wydawca rozszerzenia nie zdecyduje się na obsługę automatycznego uaktualniania rozszerzeń.
W przypadku niektórych rozszerzeń można włączyć automatyczne uaktualnienia za pomocą zarządzania rozszerzeniami.
Aby włączyć automatyczne uaktualnianie, przejdź do strony Rozszerzenia i wykonaj następujące kroki:
Wybierz rozszerzenie, na którym chcesz włączyć automatyczne uaktualnianie.
Wybierz pozycję Włącz automatyczne uaktualnianie z górnego menu
Po wyświetleniu monitu o potwierdzenie intencji wybierz przycisk OK.
Aby zainstalować i włączyć automatyczne uaktualnianie dla określonego rozszerzenia, na AzureMonitorWindowsAgent przykład uruchom następujące polecenie:
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"
Aby zainstalować i włączyć automatyczne uaktualnianie dla określonego rozszerzenia, na AzureMonitorWindowsAgent przykład uruchom następujące polecenie:
$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
Ręczne uaktualnianie rozszerzenia za pośrednictwem Azure Portal
Uaktualnienie rozszerzenia ręcznego działa jak automatyczne uaktualnianie rozszerzenia. W klastrze z obsługą usługi Azure Stack HCI Arc po ręcznym uaktualnieniu rozszerzenia platforma Azure zapisuje wybraną wersję. Następnie platforma Azure próbuje uaktualnić rozszerzenie na wszystkich serwerach w klastrze do tej wersji.
Na niektórych serwerach, jeśli uaktualnienie rozszerzenia zakończy się niepowodzeniem, platforma podejmie próbę uaktualnienia do wybranej wersji podczas następnej synchronizacji z chmurą rozwiązania Azure Stack HCI.
Użyj ręcznego przepływu pracy w następujących scenariuszach:
Dostępna jest nowa wersja rozszerzenia i chcesz ją uaktualnić ręcznie.
Opcja automatycznego uaktualniania rozszerzenia jest wyłączona i występuje niezgodność wersji na różnych serwerach klastra Azure Stack HCI.
Aby ręcznie uaktualnić rozszerzenie, wykonaj następujące kroki:
Przejdź do strony Rozszerzenia .
Wybierz rozszerzenie, które chcesz uaktualnić, a następnie wybierz pozycję Ustawienia z górnego menu.
Wybierz najnowszą wersję i wybierz pozycję Zapisz.
W Azure Portal można wyłączyć automatyczne uaktualnienia dla niektórych rozszerzeń. Aby wyłączyć automatyczne uaktualnienia, przejdź do strony Rozszerzenia i wykonaj następujące kroki:
Wybierz rozszerzenie, na którym chcesz wyłączyć automatyczne uaktualnianie.
Wybierz pozycję Wyłącz automatyczne uaktualnianie z górnego menu.
Po wyświetleniu monitu o potwierdzenie intencji wybierz przycisk OK.
Sprawdzanie historii uaktualniania rozszerzenia
Kartę Dziennik aktywności można wyświetlić na poszczególnych zasobach serwera z obsługą usługi Azure Arc, grupach zasobów i subskrypcjach, aby sprawdzić historię automatycznych uaktualnień rozszerzeń dla poszczególnych serwerów klastra. Aby uzyskać więcej informacji, zobacz Sprawdzanie historii uaktualniania automatycznego rozszerzenia.
Aktualizacje dotyczące dostępności
W przypadku grupy klastrów z obsługą usługi Azure Stack HCI Arc przechodzących uaktualnienie platforma Azure użyła modelu automatycznego uaktualniania rozszerzeń do organizowania uaktualnień.
Czas automatycznych uaktualnień rozszerzeń
Po opublikowaniu nowej wersji obsługiwanego rozszerzenia staje się ona dostępna do instalacji i ręcznego uaktualniania na serwerach z obsługą usługi Azure Arc. Uaktualnienia są wydawane w partiach w różnych regionach i subskrypcjach platformy Azure, więc może wystąpić uaktualnienie rozszerzenia na niektórych serwerach przed innymi. Aby uzyskać więcej informacji, zobacz Chronometraż automatycznych uaktualnień rozszerzeń.
Jeśli uaktualnienie rozszerzenia zakończy się niepowodzeniem, platforma Azure wykonuje akcje skojarzone z automatycznym wycofywaniem i ponawia próbę naprawy rozszerzenia.
Jeśli dla maszyny jest dostępnych wiele uaktualnień rozszerzeń, mogą one być wsadowe razem. Jednak każde uaktualnienie rozszerzenia jest stosowane indywidualnie na maszynie. Aby uzyskać więcej informacji, zobacz Uaktualnienia rozszerzeń z wieloma rozszerzeniami.
W razie potrzeby możesz odinstalować niektóre rozszerzenia z klastrów usługi Azure Stack HCI w Azure Portal. Aby odinstalować rozszerzenie, wykonaj następujące kroki:
Przejdź do strony Rozszerzenia.
Wybierz rozszerzenie, które chcesz odinstalować. Przycisk odinstaluj nie jest dostępny dla rozszerzeń zarządzanych przez platformę Azure.
Wybierz pozycję Odinstaluj z górnego menu.
Potwierdź intencję i wybierz pozycję Tak.
Aby usunąć określone rozszerzenie, takie jak AzureMonitorWindowsAgent uruchom następujące polecenie:
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}"
Aby usunąć określone rozszerzenie, takie jak AzureMonitorWindowsAgent uruchom następujące polecenie:
$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}"
Rozwiązywanie problemów z błędami rozszerzenia
Stan rozszerzenia: Niepowodzenie
Zalecenie: W przypadku rozszerzenia ze stanem niepowodzenia wybierz link Niepowodzenie (wyświetl szczegóły). Wyświetl wszystkie informacje o niepowodzeniu i zastosuj porady dotyczące rozwiązywania problemów.
