Zarządzanie rozszerzeniami usługi Azure Arc w środowisku lokalnym platformy Azure
Artykuł
Dotyczy: Azure Local, wersje 23H2 i 22H2
W tym artykule opisano sposób instalowania, uaktualniania i zarządzania rozszerzeniami usługi Azure Arc w środowisku lokalnym platformy Azure.
Rozszerzenia usługi Azure Arc zarządzane przez klienta w środowisku lokalnym platformy Azure
Rozszerzenia usługi Azure Arc można instalować, odinstalować i aktualizować w środowisku lokalnym platformy Azure. Usługa Azure Arc umożliwia uruchamianie usług hybrydowych, takich jak monitorowanie i Centrum administracyjne systemu Windows w witrynie Azure Portal.
Poniżej przedstawiono poszczególne rozszerzenia, którymi można zainstalować i zarządzać nimi.
Rozszerzenia zarządzane przez platformę Azure w środowisku lokalnym platformy Azure
Po pomyślnym zarejestrowaniu nowej lokalizacji lokalnej platformy Azure na platformie Azure rozszerzenia zarządzane przez platformę Azure są automatycznie instalowane w systemie. 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 witrynie Azure Portal, przechodząc do strony Rozszerzenia i wybierając menu Ustawienia .
Jeśli masz istniejącą lokalną platformę Azure zarejestrowaną na platformie Azure bez tych rozszerzeń, na stronie Przegląd lub Rozszerzenia w witrynie Azure Portal zostanie wyświetlony baner. Możesz użyć informacji na banerze, aby zapoznać się z instrukcjami dotyczącymi instalowania 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 Local Arc, jak pokazano na zrzucie ekranu. Możesz użyć karty możliwości, aby zainstalować większość rozszerzeń.
Podczas instalowania rozszerzenia w witrynie Azure Portal jest to operacja z obsługą klastra. Rozszerzenie jest instalowane we wszystkich węzłach systemu. Jeśli do systemu zostanie dodanych więcej węzłów, wszystkie rozszerzenia zainstalowane w systemie 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 go 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 zainstalować rozszerzenie, wykonując następujące kroki:
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 na wszystkich systemach 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 systemach 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 systemach 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
Program Azure PowerShell można uruchomić w usłudze Azure Cloud Shell. W tym dokumencie 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 zainstaluj rozszerzenie przy użyciu programu PowerShell, 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 na wszystkich systemach w grupie zasobów, uruchom następujące polecenie:
Aby zainstalować rozszerzenie usługi Azure Site Recovery we wszystkich systemach 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 go 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 systemie, 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:
Program Azure PowerShell można uruchomić w usłudze Azure Cloud Shell. W tym dokumencie 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 systemie, 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 Local Arc, chyba że jawnie zrezygnowano 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 rozszerzeń. 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 przykład AzureMonitorWindowsAgent 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 przykład AzureMonitorWindowsAgent 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 witryny Azure Portal
Uaktualnienie rozszerzenia ręcznego działa jak automatyczne uaktualnianie rozszerzenia. W klastrze z obsługą usługi Azure Local Arc po ręcznym uaktualnieniu rozszerzenia platforma Azure zapisuje wybraną wersję. Następnie platforma Azure próbuje uaktualnić rozszerzenie we wszystkich węzłach 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ą lokalną platformy Azure.
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 istnieje niezgodność wersji w różnych węzłach usługi Azure Local.
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.
Możesz wyłączyć automatyczne uaktualnienia dla niektórych rozszerzeń w witrynie Azure Portal. 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 węzłów. Aby uzyskać więcej informacji, zobacz Sprawdzanie historii automatycznego uaktualniania rozszerzeń.
Aktualizacje pierwszej dostępności
W przypadku grupy klastrów z obsługą usługi Azure Local Arc poddawanych uaktualnieniu platforma Azure użyła modelu automatycznego uaktualniania rozszerzeń do organizowania uaktualnień.
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ą wystawiane w partiach w różnych regionach i subskrypcjach platformy Azure, więc uaktualnienie rozszerzenia może wystąpić 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 nadal masz problemy z uaktualnieniem rozszerzenia, możesz wyłączyć automatyczne uaktualnianie rozszerzenia. Wyłączenie automatycznego uaktualniania uniemożliwia ponowne próby systemu podczas rozwiązywania problemu. Możesz ponownie włączyć automatyczne uaktualnianie rozszerzenia, gdy wszystko będzie gotowe.
Uaktualnienia z wieloma rozszerzeniami
Jeśli dla węzła jest dostępnych wiele uaktualnień rozszerzeń, mogą być one wsadowe razem. Jednak każde uaktualnienie rozszerzenia jest stosowane indywidualnie w węźle. Aby uzyskać więcej informacji, zobacz Uaktualnienia rozszerzeń z wieloma rozszerzeniami.
W razie potrzeby możesz odinstalować niektóre rozszerzenia z witryny Azure Local w witrynie 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.
