Udostępnij za pośrednictwem

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

  • Artykuł

Dotyczy: Azure Stack HCI, wersja 22H2

Ważne

Usługa Azure Stack HCI jest teraz częścią usługi Azure Local. Jednak starsze wersje rozwiązania Azure Stack HCI, na przykład 22H2 będą nadal odwoływać się do rozwiązania Azure Stack HCI i nie będą odzwierciedlać zmiany nazwy. Dowiedz się więcej.

W zależności od konfiguracji klastra i wymagań może być konieczne wykonanie większej liczby kroków po zarejestrowaniu klastra na platformie Azure. W tym artykule opisano sposób zarządzania rejestracją klastra przy użyciu centrum administracyjnego systemu Windows, programu PowerShell lub witryny 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 Azure Stack HCI. Począwszy od Azure Stack HCI w wersji 21H2, zarejestrowanie klastra automatycznie tworzy Azure Arc dla zasobu serwera dla każdego serwera w klastrze 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 centrum administracyjnego systemu Windows zostanie wyświetlony 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 rozwiązania Azure Stack HCI Connected oznacza, że klaster jest już zarejestrowany na platformie Azure i pomyślnie zsynchronizowany z chmurą w ciągu ostatniego dnia.

  • Dla serwerów z obsługą usługi Arc, połączono oznacza, że wszystkie serwery fizyczne mają włączoną obsługę Arc i mogą być zarządzane z poziomu portalu Azure.

    Zrzut ekranu przedstawiający stan połączenia klastra na pulpicie nawigacyjnym Centrum administracyjnego systemu Windows.

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 rozwiązania Azure Stack HCI.

Na stronie Przegląd są wyświetlane ogólne informacje o stanie rejestracji Azure Stack HCI i serwerów obsługiwanych przez 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. Te informacje zawierają stan połączenia z Azure i ostatnią synchronizację z Azure. Przydatne linki do dokumentacji rozwiązywania problemów oraz do rozszerzeń klastra. W razie potrzeby możesz się 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 usługi Azure Arc i identyfikator wersji 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 wersji 21H2 usługi Azure Stack HCI, klastry są automatycznie włączane do Azure 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:

  • Zaktualizowałeś serwery klastra z Azure Stack HCI w wersji 20H2 (które wcześniej nie były ręcznie włączone do obsługi 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 dla klastra 21H2 lub nowszego rozwiązania 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 ma to wpływu 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 -Region, -ResourceName lub -ResourceGroupName, które różnią się od ustawień domyślnych, należy tutaj określić te same parametry i wartości. Uruchomienie Get-AzureStackHCI wyświetla te wartości.

Aby uzyskać informacje o błędach podczas włączania usługi Arc, zapoznaj się ze 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 aktualizować agenta usługi Arc po udostępnieniu nowej wersji, upewnij się, że serwery klastra są skonfigurowane z usługą 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 do konfiguracji serwera (SConfig) wybierz opcję Zainstaluj aktualizacje (opcja 6):

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

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

  3. Możesz zdecydować się na aktualizację agenta usługi Arc lub zainstalować wszystkie dostępne aktualizacje:

    Opcje konfiguracji.

  4. Aby sprawdzić wersję agenta usługi Arc, uruchom azcmagent version z poziomu programu PowerShell w każdym węźle.

Wyrejestrowywanie rozwiązania Azure Stack HCI

Możesz wyrejestrować rozwiązanie Azure Stack HCI przy użyciu centrum administracyjnego systemu Windows 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 oczyszczanie 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 centrum administracyjnego systemu Windows:

  1. Nawiąż połączenie z klastrem przy użyciu centrum administracyjnego systemu Windows.

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

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

Uwaga

Jeśli brama centrum administracyjnego systemu Windows jest zarejestrowana w innym identyfikatorze dzierżawy firmy Microsoft Entra, który został użyty do początkowego zarejestrowania klastra, mogą wystąpić problemy podczas próby wyrejestrowania klastra przy użyciu centrum administracyjnego systemu Windows. W takim przypadku możesz użyć instrukcji programu PowerShell w następnej sekcji.

Czyszczenie po tym, jak klaster nie został prawidłowo wyrejestrowany

Jeśli użytkownik zniszczy klaster rozwiązania Azure Stack HCI bez jego wyrejestrowania, na przykład przez ponowne tworzenie obrazu serwerów hosta lub usunięcie węzłów klastra wirtualnego, to artefakty pozostaną na platformie Azure. Te artefakty są nieszkodliwe i nie będą powodować naliczania opłat ani używania zasobów, ale mogą one zaśmiecać witrynę Azure Portal. Aby je wyczyścić, możesz je usunąć ręcznie.

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

Usługa Azure Stack HCI tworzy dwie aplikacje firmy Microsoft Entra w ramach rejestracji: resourceName i resourceName.arc. Aby usunąć te aplikacje, przejdź do Microsoft Entra ID>Rejestracje aplikacji>Wszystkie aplikacje. Wybierz pozycję Usuń i potwierdź.

Zasób rozwiązania Azure Stack HCI można również usunąć przy użyciu 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żyć bardziej ograniczonej roli uprawnień niestandardowych?

Jeśli niektóre operacje opisane w następujący sposób są już wykonywane poza pasmem przez użytkownika mającego role współautora i administratora dostępu użytkowników, możesz jeszcze bardziej zmniejszyć uprawnienia wymagane do przeprowadzenia rejestracji usługi Azure Stack HCI zgodnie z opisem w Przypisywanie uprawnień platformy Azure przy użyciu programu PowerShell.

  1. Zarejestruj wymaganych dostawców zasobów. Zaloguj się do subskrypcji używanej 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 są przewidywane zasoby rozwiązania 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, jak pokazano poniżej. Najpierw utwórz plik JSON o nazwie customHCIRole.json z następującą zawartością. Pamiętaj, aby zmienić <subscriptionID> na identyfikator subskrypcji platformy Azure. Aby uzyskać identyfikator subskrypcji, odwiedź witrynę 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>

    Teraz możesz zarejestrować klaster przy użyciu polecenia Register-AzStackHCI.

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

Jak mogę zarejestrować klaster przy użyciu usługi ArmAccessToken/SPN?

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

Uwaga

Te poświadczenia SPN są używane do początkowego dołączania do Azure Stack HCI. Usługa Azure Stack HCI nadal tworzy oddzielne poświadczenia SPN dla dołączania do usługi Arc. Aby użyć niestandardowej nazwy SPN for Arc onboarding, 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 przy użyciu nazwy SPN, możesz użyć:

    • Uwierzytelnianie oparte na kodzie urządzenia. Użyj -DeviceCode w poleceniu 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 poleceniu Connect-AzAccount cmdlet, które akceptują informacje o certyfikacie. SPN, którego używasz, powinien mieć wszystkie wymagane uprawnienia do subskrypcji zgodnie z opisem w tym miejscu.

  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 Azure 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 utworzonego SPN z przypisanymi rolami onboardowania Arc (Azure Connected Machine Onboarding i Azure Connected Machine Resource Administrator) i określić poświadczenia do polecenia cmdlet rejestracji, używając opcji -ArcSpnCredential.

Uwaga

Azure Stack HCI nie aktualizuje poświadczeń dla SPN (Nazwa Główna Usługi) utworzonego w ten sposób. Gdy poświadczenia SPN są bliskie wygaśnięcia, należy ponownie wygenerować te poświadczenia i uruchomić proces "naprawa rejestracji", aby zaktualizować poświadczenia SPN w klastrze.

Uwaga

Użyj modułu PowerShell w wersji 1.4.1 lub starszej, aby korzystać z poświadczeń SPN do dodawania do 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 wstępne testy. 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/zapisać
  • "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 również masz uprawnienie Microsoft.Resources/subscriptions/resourceGroups/delete.

Aby zarejestrować klaster i włączyć obsługę Arc na serwerach, uruchom następujące polecenia PowerShell po zaktualizowaniu ich informacjami 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ć get-installedModule <module name> polecenia cmdlet , 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 rozwiązania 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 cmdlecie Register-AzStackHCI.

Jakie są najczęściej używane polecenia cmdlet rejestracji i usługi Arc?

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

Następne kroki