Zarządzanie rozszerzeniami usługi Azure Arc w usłudze Azure Stack HCI

Artykuł
02/07/2024

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:

Instalowanie rozszerzenia

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.

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 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:

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

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"

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

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
}

Sprawdzanie stanu rozszerzenia

Stan rozszerzenia na każdym serwerze można sprawdzić na stronie Rozszerzenia , wyświetlając kolumnę stanu siatki.

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:

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

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:

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

Jak działa uaktualnienie rozszerzenia

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łączanie automatycznego uaktualniania rozszerzenia

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.

Wyłączanie automatycznego uaktualniania rozszerzenia

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ń.

Aby natychmiast uaktualnić rozszerzenie, zobacz Ręczne uaktualnianie rozszerzenia za pośrednictwem Azure Portal.

Automatyczne wycofywanie i ponawianie prób

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 rozszerzeń. Po wyłączeniu automatycznego uaktualniania uniemożliwia ponowne próby systemowe podczas rozwiązywania problemu. Automatyczne uaktualnianie rozszerzeń można włączyć ponownie, gdy wszystko będzie gotowe.

Uaktualnienia z wieloma rozszerzeniami

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.

Odinstalowywanie rozszerzenia

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