Udostępnij za pośrednictwem

Zarządzanie rejestracją klastra usługi Azure Stack HCI

  • Artykuł

Dotyczy: Azure Stack HCI, wersje 22H2 i 21H2

W zależności od konfiguracji i wymagań klastra może być konieczne wykonanie dodatkowych kroków po zarejestrowaniu klastra na platformie Azure. W tym artykule opisano sposób zarządzania rejestracją klastra przy użyciu Windows Admin Center, programu PowerShell lub Azure Portal. Zawiera również odpowiedzi na często zadawane pytania dotyczące rejestracji klastra.

Podczas rejestrowania klastra na platformie Azure tworzony jest zasób usługi Azure Resource Manager reprezentujący lokalny klaster usługi Azure Stack HCI. Począwszy od usługi Azure Stack HCI w wersji 21H2, zarejestrowanie klastra automatycznie tworzy zasób serwera usługi Azure Arc dla każdego serwera w klastrze usługi Azure Stack HCI. Ta integracja usługi Azure Arc rozszerza płaszczyznę zarządzania platformy Azure na usługę Azure Stack HCI. Integracja usługi Azure Arc umożliwia okresową synchronizację informacji między zasobem platformy Azure a klastrami lokalnymi.

Wyświetlanie stanu rejestracji i serwerów z obsługą usługi Arc

Po nawiązaniu połączenia z klastrem przy użyciu Windows Admin Center zobaczysz pulpit nawigacyjny, który wyświetla stan rejestracji usługi Azure Stack HCI i serwerów z obsługą usługi Arc.

  • W przypadku rejestracji usługi Azure Stack HCI połączono oznacza, że klaster jest już zarejestrowany na platformie Azure i pomyślnie zsynchronizowany z chmurą w ciągu ostatniego dnia.

  • W przypadku serwerów z obsługą usługi Arc połączono oznacza, że wszystkie serwery fizyczne są włączone w usłudze Arc i mogą być zarządzane z poziomu Azure Portal.

    Zrzut ekranu przedstawiający stan połączenia klastra na pulpicie nawigacyjnym Windows Admin Center.

Aby uzyskać więcej informacji, wybierz pozycję Azure Arc z menu Narzędzia po lewej stronie.

Uwaga

Pulpit nawigacyjny usługi Azure Arc jest obecnie w publicznej wersji zapoznawczej.

Zrzut ekranu przedstawiający opcje pobierania informacji o rejestracji usługi Azure Stack HCI.

Na stronie Przegląd znajdziesz informacje o stanie wysokiego poziomu dotyczące rejestracji usługi Azure Stack HCI i serwerów z obsługą usługi Arc. Możesz kliknąć dowolny kafelek, aby przejść do poszczególnych stron.

Zrzut ekranu przedstawiający informacje o stanie rejestracji.

Na stronie rejestracji rozwiązania Azure Stack HCI można wyświetlić zarówno system Azure Stack HCI, jak i stan serwera. Obejmuje to stan połączenia platformy Azure i ostatnią synchronizację platformy Azure. Przydatne linki do dokumentacji rozwiązywania problemów i rozszerzeń klastra. W razie potrzeby możesz wyrejestrować .

Zrzut ekranu przedstawiający stan serwerów.

Jeśli klaster jest zarejestrowany na platformie Azure, ale serwery fizyczne nie są jeszcze włączone w usłudze Arc, możesz to zrobić na stronie serwerów z obsługą usługi Arc . Jeśli serwery fizyczne są włączone w usłudze Arc, możesz wyświetlić stan i identyfikator wersji usługi Azure Arc dla każdego serwera. Przydatne linki do informacji dotyczących rozwiązywania problemów można również znaleźć.

Włączanie integracji z usługą Azure Arc

Począwszy od usługi Azure Stack HCI w wersji 21H2, klastry są automatycznie włączone w usłudze Arc podczas rejestracji. Integracja usługi Azure Arc nie jest dostępna w usłudze Azure Stack HCI w wersji 20H2.

Należy ręcznie włączyć integrację usługi Azure Arc w następujących scenariuszach:

  • Serwery klastra zostały zaktualizowane z usługi Azure Stack HCI w wersji 20H2 (które wcześniej nie były ręcznie włączone przez usługę Arc) do wersji 21H2.
  • Jeśli wcześniej włączono usługę Arc dla klastrów 20H2, a po uaktualnieniu do wersji 21H2 włączanie usługi Arc nadal kończy się niepowodzeniem, zapoznaj się ze wskazówkami tutaj, aby rozwiązać problemy.
  • Wcześniej wyłączono włączanie usługi Arc, a teraz zamierzasz włączyć usługę Arc w klastrze 21H2 lub nowszym usłudze Azure Stack HCI.

Wykonaj następujące kroki, aby włączyć integrację usługi Azure Arc:

  1. Zainstaluj najnowszą wersję modułu Az.Resources na komputerze zarządzania:

    Install-Module -Name Az.Resources

  2. Zainstaluj najnowszą wersję modułu Az.StackHCI na komputerze zarządzania:

    Install-Module -Name Az.StackHCI

  3. Register-AzStackHCI Uruchom ponownie polecenie cmdlet i określ identyfikator subskrypcji platformy Azure, który musi być tym samym identyfikatorem, z którym klaster został pierwotnie zarejestrowany. Parametr -ComputerName może być nazwą dowolnego serwera w klastrze. Ten krok umożliwia integrację usługi Azure Arc na każdym serwerze w klastrze. Nie wpłynie to na bieżącą rejestrację klastra na platformie Azure i nie musisz najpierw wyrejestrować klastra:

    Register-AzStackHCI  -SubscriptionId "<subscription_ID>" -ComputerName Server1 -Region <region> -TenantId "<tenant_id>"

    Ważne

    Jeśli klaster został pierwotnie zarejestrowany przy użyciu elementu -Region, -ResourceNamelub -ResourceGroupName różni się od ustawień domyślnych, musisz określić te same parametry i wartości w tym miejscu. Uruchomienie Get-AzureStackHCI spowoduje wyświetlenie tych wartości.

Aby uzyskać informacje o błędach podczas włączania usługi Arc, zapoznaj się z wskazówkami dotyczącymi rozwiązywania problemów.

Uaktualnianie agenta usługi Arc na serwerach klastra

Począwszy od usługi Azure Stack HCI w wersji 21H2, aby automatycznie zaktualizować agenta usługi Arc po udostępnieniu nowej wersji, upewnij się, że serwery klastra są skonfigurowane w usłudze Microsoft Update. Aby uzyskać więcej informacji, zobacz Konfiguracja usługi Microsoft Update.

Wykonaj następujące kroki, aby uaktualnić agenta usługi Arc na serwerach klastra:

  1. W narzędziu konfiguracji serwera (SConfig) wybierz opcję Zainstaluj Aktualizacje (opcja 6):

    Zrzut ekranu przedstawiający konfigurację SConfig z opcją instalowania aktualizacji.

  2. Wybierz opcję Wszystkie aktualizacje jakości (opcja 1).

  3. Możesz wybrać opcję zaktualizowania agenta usługi Arc lub zainstalowania wszystkich dostępnych aktualizacji:

    Opcje konfiguracji Sconfig.

  4. Uruchom azcmagent version polecenie z poziomu programu PowerShell w każdym węźle, aby zweryfikować wersję agenta usługi Arc.

Wyrejestrowywanie rozwiązania Azure Stack HCI

Rozwiązanie Azure Stack HCI można wyrejestrować przy użyciu Windows Admin Center lub programu PowerShell.

Proces wyrejestrowania automatycznie czyści zasób platformy Azure reprezentujący klaster, grupę zasobów platformy Azure (jeśli grupa została utworzona podczas rejestracji i nie zawiera żadnych innych zasobów) oraz tożsamość aplikacji Microsoft Entra. To czyszczenie zatrzymuje wszystkie funkcje monitorowania, obsługi i rozliczeń za pośrednictwem usługi Azure Arc.

Wykonaj następujące kroki, aby wyrejestrować klaster usługi Azure Stack HCI za pośrednictwem Windows Admin Center:

  1. Połącz się z klastrem przy użyciu Windows Admin Center.

  2. Wybierz pozycję Azure Arc z menu po lewej stronie.

  3. Wybierz pozycję Rejestracja rozwiązania Azure Stack HCI, wybierz przycisk Wyrejestrowywanie , a następnie ponownie wybierz pozycję Wyrejestruj .

Uwaga

Jeśli brama Windows Admin Center jest zarejestrowana w innym identyfikatorze dzierżawy Microsoft Entra użytym do początkowego zarejestrowania klastra, mogą wystąpić problemy podczas próby wyrejestrowania klastra przy użyciu Windows Admin Center. Jeśli tak się stanie, możesz użyć instrukcji programu PowerShell w następnej sekcji.

Czyszczenie po wyrejestrowanym klastrze, który nie został prawidłowo wyrejestrowany

Jeśli użytkownik zniszczy klaster usługi Azure Stack HCI bez jego zarejestrowania, na przykład przez ponowne utworzenie obrazu serwerów hosta lub usunięcie węzłów klastra wirtualnego, artefakty zostaną pozostawione na platformie Azure. Te artefakty są nieszkodliwe i nie będą naliczać rozliczeń ani zasobów, ale mogą one zaśmiecać Azure Portal. Aby je wyczyścić, można je usunąć ręcznie.

Aby usunąć zasób usługi Azure Stack HCI, przejdź do zasobu w Azure Portal i wybierz pozycję Usuń na pasku akcji. Szczegóły zasobu można uzyskać, uruchamiając Get-AzureStackHCI polecenie cmdlet.

Usługa Azure Stack HCI tworzy dwie aplikacje Microsoft Entra w ramach rejestracji: resourceName i resourceName.arc. Aby je usunąć, przejdź do pozycji Tożsamość Microsoft EntraRejestracje>>aplikacji wszystkie aplikacje. Wybierz pozycję Usuń i potwierdź.

Zasób usługi Azure Stack HCI można również usunąć za pomocą programu PowerShell:

Remove-AzResource -ResourceId "<resource_name>"

Może być konieczne zainstalowanie modułu Az.Resources :

Install-Module -Name Az.Resources

Jeśli grupa zasobów została utworzona podczas rejestracji i nie zawiera żadnych innych zasobów, możesz ją również usunąć:

Remove-AzResourceGroup -Name "<resourceGroupName>"

Rozwiązywanie problemów

Aby uzyskać informacje o typowych błędach i krokach ograniczania ryzyka w celu ich rozwiązania, zobacz Rozwiązywanie problemów z rejestracją rozwiązania Azure Stack HCI.

Często zadawane pytania

Znajdź odpowiedzi na niektóre często zadawane pytania:

Jak mogę używać bardziej ograniczonej roli uprawnień niestandardowych?

Możesz dodatkowo zmniejszyć uprawnienia wymagane do przeprowadzenia rejestracji usługi Azure Stack HCI zgodnie z opisem w temacie Przypisywanie uprawnień platformy Azure przy użyciu programu PowerShell, pod warunkiem że niektóre operacje opisane poniżej są już wykonywane poza pasmem przez użytkownika mającego rolę współautora i administratora dostępu użytkowników.

  1. Zarejestruj wymaganych dostawców zasobów. Zaloguj się do subskrypcji, której użyjesz do zarejestrowania klastra. W obszarze Ustawienia > Dostawcy zasobów wybierz następujących dostawców zasobów, a następnie wybierz pozycję Zarejestruj:

    • Microsoft.AzureStackHCI
    • Microsoft.HybridCompute
    • Microsoft.GuestConfiguration
    • Microsoft.HybridConnectivity

  2. Utwórz grupy zasobów. Upewnij się, że grupy zasobów, w których będą projektowane zasoby usługi Azure Stack HCI, są wstępnie tworzone przez uprzywilejowanego użytkownika. Aby uzyskać więcej informacji, zobacz sekcję wymagań wstępnych .

    Po skonfigurowaniu tych dwóch wymagań wstępnych utwórz rolę niestandardową i użyj jej do rejestracji zgodnie z poniższym opisem. Najpierw utwórz plik JSON o nazwie customHCIRole.json z następującą zawartością. Pamiętaj, aby zmienić <subscriptionID> identyfikator subskrypcji platformy Azure. Aby uzyskać identyfikator subskrypcji, odwiedź Azure Portal, przejdź do pozycji Subskrypcje, a następnie skopiuj/wklej swój identyfikator z listy:

    {
  "Name": "Azure Stack HCI registration role",
  "Id": null,
  "IsCustom": true,
  "Description": "Custom Azure role to allow subscription-level access to register Azure Stack HCI",
  "Actions": [
    "Microsoft.Resources/subscriptions/resourceGroups/read",
    "Microsoft.AzureStackHCI/clusters/*",
    "Microsoft.Authorization/roleAssignments/write",
    "Microsoft.Authorization/roleAssignments/read"
   ],
   "NotActions": [
   ],
   "AssignableScopes": [
      "/subscriptions/<subscriptionId>"
   ]
}

  3. Utwórz rolę niestandardową:

    New-AzRoleDefinition -InputFile <path to customHCIRole.json>

  4. Przypisz rolę niestandardową do użytkownika:

    $user = get-AzAdUser -DisplayName <userdisplayname>
$role = Get-AzRoleDefinition -Name "Azure Stack HCI registration role"
New-AzRoleAssignment -ObjectId $user.Id -RoleDefinitionId $role.Id -Scope /subscriptions/<subscriptionid>

    Klaster można teraz zarejestrować przy użyciu polecenia Register-AzStackHCI.

    Jeśli chcesz wyrejestrować ten klaster, dodaj uprawnienie Microsoft.Resources/subscriptions/resourceGroups/delete do pliku JSON podczas tworzenia roli niestandardowej.

Jak mogę zarejestrować klaster przy użyciu funkcji ArmAccessToken/SPN?

Przed rejestracją upewnij się, że zostały spełnione wymagania wstępne .

Uwaga

Te poświadczenia nazwy SPN są używane do początkowego dołączania do usługi Azure Stack HCI. Usługa Azure Stack HCI nadal tworzy oddzielne poświadczenia nazwy SPN na potrzeby dołączania do usługi Arc. Aby użyć niestandardowej nazwy SPN dla dołączania do usługi Arc, zobacz Jak mogę zarejestrować klaster przy użyciu nazwy SPN for Arc onboarding?.

  1. Uruchom polecenie "Connect-AzAccount" , aby nawiązać połączenie z platformą Azure. Aby nawiązać połączenie za pomocą nazwy SPN, możesz użyć:

    • Uwierzytelnianie oparte na kodzie urządzenia. Użyj -DeviceCode polecenia cmdlet .
    • Uwierzytelnianie oparte na certyfikatach. Zobacz ten artykuł , aby skonfigurować nazwę SPN na potrzeby uwierzytelniania opartego na certyfikatach. Następnie użyj odpowiednich parametrów w Connect-AzAccount poleceniu cmdlet, które akceptują informacje o certyfikacie. Używana nazwa SPN powinna mieć wszystkie wymagane uprawnienia do subskrypcji , jak pokazano tutaj.

  2. Przypisz $token = Get-AzAccessToken.

  3. Użyj identyfikatora Register-AzStackHCI z parametrami TenantId, SubscriptionId, ArmAccessTokeni AccountId w następujący sposób:

    Register-AzStackHCI -TenantId "<tenant_ID>" -SubscriptionId "<subscription_ID>" -ComputerName Server1 -Region <region> -ArmAccessToken $token.Token -AccountId $token.UserId

Jak mogę zarejestrować klaster przy użyciu nazwy SPN na potrzeby dołączania do usługi Arc?

Poniższe wskazówki dotyczą użytkownika z uruchomionym poleceniem cmdlet rejestracji, który nie może uzyskać przypisanego uprawnienia Microsoft.Authorization/roleAssignments/write . W takich przypadkach mogą używać wstępnie utworzonej nazwy SPN z rolami dołączania do usługi Arc (dołączanie maszyny połączonej platformy Azure i administratorem zasobów połączonej maszyny platformy Azure) przypisaną do nazwy SPN i określić poświadczenia do polecenia cmdlet rejestracji przy użyciu -ArcSpnCredential opcji .

Uwaga

Usługa Azure Stack HCI nie aktualizuje poświadczeń nazwy SPN utworzonej w ten sposób. Gdy poświadczenia nazwy SPN zbliżają się do wygaśnięcia, należy ponownie wygenerować poświadczenia i uruchomić przepływ "napraw rejestrację", aby zaktualizować poświadczenia nazwy SPN w klastrze.

Uwaga

Użyj modułu programu PowerShell w wersji 1.4.1 lub starszej, aby użyć poświadczeń nazwy SPN do dołączania usługi Arc, jeśli nie możesz przypisać uprawnień Microsoft.Authorization/roleAssignments/write do roli rejestracji.

Przed rejestracją upewnij się, że zostały spełnione wymagania wstępne i testy wstępne. Użytkownik rejestrujący klaster ma przypisaną rolę "współautor" dla subskrypcji używanej do rejestracji klastra lub ma następującą listę uprawnień, jeśli przypisano rolę niestandardową:

  • "Microsoft.Resources/subscriptions/resourceGroups/read",
  • "Microsoft.Resources/subscriptions/resourceGroups/write",
  • "Microsoft.AzureStackHCI/register/action",
  • "Microsoft.AzureStackHCI/Unregister/Action",
  • "Microsoft.AzureStackHCI/clusters/*",
  • "Microsoft.Authorization/roleAssignments/read",
  • "Microsoft.HybridCompute/register/action",
  • "Microsoft.GuestConfiguration/register/action",
  • "Microsoft.HybridConnectivity/register/action"

W przypadku wyrejestrowania upewnij się, że masz również uprawnienie Microsoft.Resources/subscriptions/resourceGroups/delete .

Aby zarejestrować klaster i włączyć usługę Arc na serwerach, uruchom następujące polecenia programu PowerShell po zaktualizowaniu ich przy użyciu informacji o środowisku. Następujące polecenia wymagają polecenia Az.Resources (minimalna wersja 5.6.0) i Az.Accounts (minimalna wersja 2.7.6). Możesz użyć polecenia cmdlet , get-installedModule <module name> aby sprawdzić zainstalowaną wersję modułu programu PowerShell.

#Connect to subscription
Connect-AzAccount -TenantId <tenant_id> -SubscriptionId <Subscription_ID> -Scope Process

#Create a new application registration
$app = New-AzADApplication -DisplayName "<unique_name>"

#Create a new SPN corresponding to the application registration
$sp = New-AzADServicePrincipal -ApplicationId  $app.AppId -Role "Reader" 

#Roles required on SPN for Arc onboarding
$AzureConnectedMachineOnboardingRole = "Azure Connected Machine Onboarding"
$AzureConnectedMachineResourceAdministratorRole = "Azure Connected Machine Resource Administrator"

#Assign roles to the created SPN
New-AzRoleAssignment -ObjectId $sp.Id -RoleDefinitionName $AzureConnectedMachineOnboardingRole | Out-Null
New-AzRoleAssignment -ObjectId $sp.Id -RoleDefinitionName $AzureConnectedMachineResourceAdministratorRole | Out-Null

# Set password validity time. SPN must be updated on the HCI cluster after this timeframe.
$pwdExpiryInYears = 300
$start = Get-Date
$end = $start.AddYears($pwdExpiryInYears)
$pw = New-AzADSpCredential -ObjectId $sp.Id -StartDate $start -EndDate $end
$password = ConvertTo-SecureString $pw.SecretText -AsPlainText -Force  

# Create SPN credentials object to be used in the register-azstackhci cmdlet
$spnCred = New-Object System.Management.Automation.PSCredential ($app.AppId, $password)
Disconnect-AzAccount -ErrorAction Ignore | Out-Null

# Use the SPN credentials created previously in the register-azstackhci cmdlet
Register-AzStackHCI -SubscriptionId < Subscription_ID> -Region <region> -ArcSpnCredential:$spnCred

Czy przenoszenie zasobów jest obsługiwane dla zasobów usługi Azure Stack HCI?

Nie obsługujemy przenoszenia zasobów dla żadnych zasobów rozwiązania Azure Stack HCI. Aby zmienić lokalizację zasobów, należy najpierw wyrejestrować klaster, a następnie ponownie zarejestrować go w nowej lokalizacji, przekazując odpowiednie parametry w poleceniu cmdlet Register-AzStackHCI .

Jakie są niektóre z najczęściej używanych poleceń cmdlet rejestracji i usługi Arc?

  • W przypadku poleceń cmdlet modułu Az.StackHCI programu PowerShell zobacz dokumentację programu PowerShell hcI.
  • Get-AzureStackHCI: zwraca bieżące połączenie węzła i informacje o zasadach dla usługi Azure Stack HCI.
  • Get-AzureStackHCIArcIntegration: zwraca stan integracji węzła Arc.
  • Sync-AzureStackHCI:
    • Wykonuje synchronizację rozliczeń, licencjonowania i spisu z platformą Azure.
    • System uruchamia to polecenie cmdlet automatycznie co 12 godzin.
    • To polecenie cmdlet należy używać tylko wtedy, gdy połączenie internetowe klastra było niedostępne przez dłuższy okres.
    • Nie uruchamiaj tego polecenia cmdlet natychmiast po ponownym uruchomieniu serwera; niech nastąpi automatyczna synchronizacja. W przeciwnym razie może to spowodować nieprawidłowy stan.

Następne kroki

Aby uzyskać bardziej szczegółowe informacje, zobacz również: