Bereitstellen einer Azure Stack HCI-Version 23H2 über eine Azure Resource Manager-Bereitstellungsvorlage

Artikel
05/10/2024

Gilt für: Azure Stack HCI, Version 23H2

In diesem Artikel wird beschrieben, wie Sie eine Azure Resource Manager-Vorlage in der Azure-Portal verwenden, um eine Azure Stack HCI in Ihrer Umgebung bereitzustellen. Der Artikel enthält auch die Voraussetzungen und die Vorbereitungsschritte, die zum Starten der Bereitstellung erforderlich sind.

Wichtig

Azure Resource Manager Vorlagenbereitstellung von Azure Stack HCI-Systemen der Version 23H2 ist für bereitstellungen im großen Stil vorgesehen. Die zielgruppe für diese Bereitstellung sind IT-Administratoren, die Erfahrung mit der Bereitstellung von Azure Stack HCI-Clustern haben. Es wird empfohlen, zuerst ein System der Version 23H2 über die Azure-Portal bereitzustellen und anschließend nachfolgende Bereitstellungen über die Resource Manager-Vorlage durchzuführen.

Voraussetzungen

Abschluss des Registrierens Ihrer Server bei Azure Arc und Zuweisen von Bereitstellungsberechtigungen. Stellen Sie Folgendes sicher:
- Alle obligatorischen Erweiterungen wurden erfolgreich installiert. Zu den obligatorischen Erweiterungen gehören Azure Edge Lifecycle Manager, Azure Edge Geräteverwaltung, Telemetrie und Diagnose sowie Azure Edge-Remotesupport.
- Auf allen Servern wird dieselbe Version des Betriebssystems ausgeführt.
- Alle Server verfügen über die gleiche Netzwerkadapterkonfiguration.

Schritt 1: Vorbereiten der Azure-Ressourcen

Führen Sie die folgenden Schritte aus, um die Azure-Ressourcen vorzubereiten, die Sie für die Bereitstellung benötigen:

Create eines Dienstprinzipals und eines geheimen Clientschlüssels

Zum Authentifizieren Ihres Clusters müssen Sie einen Dienstprinzipal und einen entsprechenden geheimen Clientschlüssel für Arc Resource Bridge (ARB) erstellen.

Create eines Dienstprinzipals für ARB

Führen Sie die Schritte unter Create einer Microsoft Entra Anwendung und eines Dienstprinzipals aus, die über Azure-Portal auf Ressourcen zugreifen können, um den Dienstprinzipal zu erstellen und die Rollen zuzuweisen. Alternativ können Sie die PowerShell-Prozedur verwenden, um einen Azure-Dienstprinzipal mit Azure PowerShell zu Create.

Die Schritte sind auch hier zusammengefasst:

Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an. Navigieren Sie zu Identitätsanwendungen >> App-Registrierungen wählen Sie dann Neue Registrierung aus.
Geben Sie einen Namen für die Anwendung an, wählen Sie einen Unterstützten Kontotyp aus, und wählen Sie dann Registrieren aus.
Nachdem der Dienstprinzipal erstellt wurde, wechseln Sie zur Seite Unternehmensanwendungen . Search für den SPN, den Sie erstellt haben, und wählen Sie den SPN aus.
Kopieren Sie unter Eigenschaften die Anwendungs-ID (Client-ID) und die Objekt-ID für diesen Dienstprinzipal.

Sie verwenden die Anwendungs-ID (Client) für den arbDeploymentAppID Parameter und die Objekt-ID für den arbDeploymentSPNObjectID Parameter in der Resource Manager-Vorlage.

Create eines geheimen Clientschlüssels für den ARB-Dienstprinzipal

Wechseln Sie zu der Anwendungsregistrierung, die Sie erstellt haben, und navigieren Sie zu Zertifikate & Geheimnisse > von Clientgeheimnissen.
Wählen Sie + Neuer Geheimer Clientschlüssel aus.
Fügen Sie eine Beschreibung für den geheimen Clientschlüssel hinzu, und geben Sie einen Zeitrahmen an, wenn er abläuft. Wählen Sie Hinzufügen.
Kopieren Sie den geheimen Clientwert , wie Sie ihn später verwenden.

Hinweis

Für die Anwendungsclient-ID benötigen Sie den Geheimwert. Geheime Clientschlüsselwerte können außer unmittelbar nach der Erstellung nicht angezeigt werden. Achten Sie darauf, dass Sie diesen Wert beim Erstellen speichern, bevor Sie die Seite verlassen.

Sie verwenden den geheimen Clientwert für den arbDeploymentAppSecret Parameter in der Resource Manager-Vorlage.

Abrufen der Objekt-ID für den Azure Stack HCI-Ressourcenanbieter

Diese Objekt-ID für die Azure Stack HCI-RP ist pro Azure-Mandant eindeutig.

Suchen Sie im Azure-Portal nach Microsoft Entra ID, und navigieren Sie zu .
Wechseln Sie zur Registerkarte Übersicht , und suchen Sie nach Microsoft.AzureStackHCI-Ressourcenanbieter.

Wählen Sie den aufgeführten SPN aus, und kopieren Sie die Objekt-ID.

Alternativ können Sie PowerShell verwenden, um die Objekt-ID des Azure Stack HCI RP-Dienstprinzipals abzurufen. Führen Sie in PowerShell den folgenden Befehl aus:

Get-AzADServicePrincipal -DisplayName "Microsoft.AzureStackHCI Resource Provider"

Sie verwenden die Objekt-ID für den hciResourceProviderObjectID Parameter in der Resource Manager-Vorlage.

Schritt 2: Bereitstellen mithilfe der Azure Resource Manager-Vorlage

Eine Resource Manager-Vorlage erstellt und weist alle Ressourcenberechtigungen zu, die für die Bereitstellung erforderlich sind.

Nachdem alle Erforderlichen und Vorbereitungsschritte abgeschlossen sind, können Sie die Bereitstellung mithilfe einer bekannten guten und getesteten Resource Manager Bereitstellungsvorlage und der entsprechenden JSON-Parameterdatei durchführen. Verwenden Sie die in der JSON-Datei enthaltenen Parameter, um alle Werte auszufüllen, einschließlich der zuvor generierten Werte.

Wichtig

Stellen Sie in dieser Version sicher, dass alle parameter im JSON-Wert ausgefüllt sind, einschließlich der Parameter, die einen NULL-Wert aufweisen. Wenn NULL-Werte vorhanden sind, müssen diese aufgefüllt werden, oder die Überprüfung schlägt fehl.

Wechseln Sie im Azure-Portal zu Start, und wählen Sie + Create Ressource aus.
Wählen Sie unter Vorlagenbereitstellung (bereitstellen mithilfe benutzerdefinierter Vorlagen)Create aus.
Navigieren Sie unten auf der Seite zu Start with a quickstart template or template template section . Wählen Sie die Option Schnellstartvorlage aus.
Verwenden Sie das Feld Schnellstartvorlage (Disclaimer), um nach der entsprechenden Vorlage zu filtern. Geben Sie azurestackhci/create-cluster als Filter ein.
Wenn Sie fertig sind, wählen Sie Vorlage aus.
Auf der Registerkarte Grundlagen wird die Seite Benutzerdefinierte Bereitstellung angezeigt. Sie können die verschiedenen Parameter über die Dropdownliste auswählen oder Parameter bearbeiten auswählen.
Bearbeiten Sie Parameter wie Netzwerkabsicht oder Speichernetzwerkabsicht. Nachdem alle Parameter ausgefüllt sind, speichern Sie die Parameterdatei.

Tipp

Laden Sie eine Beispielparameterdatei herunter, um das Format zu verstehen, in dem Sie die Eingaben bereitstellen müssen.
Wählen Sie die entsprechende Ressourcengruppe für Ihre Umgebung aus.
Scrollen Sie nach unten, und vergewissern Sie sich, dass Bereitstellungsmodus = Überprüfen ist.
Klicken Sie auf Überprüfen + erstellen.
Wählen Sie auf der Registerkarte Überprüfen + erstellen die Option Erstellen aus. Dadurch werden die verbleibenden erforderlichen Ressourcen erstellt und die Bereitstellung überprüft. Die Überprüfung dauert etwa 10 Minuten.
Wenn die Überprüfung abgeschlossen ist, wählen Sie Erneut bereitstellen aus.
Wählen Sie auf dem Bildschirm Benutzerdefinierte Bereitstellungdie Option Parameter bearbeiten aus. Laden Sie die zuvor gespeicherten Parameter, und wählen Sie Speichern aus.
Ändern Sie unten im Arbeitsbereich den endgültigen Wert im JSON-Code von Überprüfen in Bereitstellen, wobei Bereitstellungsmodus = Bereitstellen ist.
Stellen Sie sicher, dass alle Felder für die Resource Manager Bereitstellungsvorlage mit dem JSON-Parameter ausgefüllt sind.
Wählen Sie die entsprechende Ressourcengruppe für Ihre Umgebung aus.
Scrollen Sie nach unten, und vergewissern Sie sich, dass Bereitstellungsmodus = Bereitstellen ist.
Klicken Sie auf Überprüfen + erstellen.
Klicken Sie auf Erstellen. Dies beginnt mit der Bereitstellung unter Verwendung der vorhandenen erforderlichen Ressourcen, die während des Validierungsschritts erstellt wurden.

Der Bildschirm "Bereitstellung" für die Clusterressource während der Bereitstellung.

Sobald die Bereitstellung initiiert wurde, wird eine eingeschränkte Umgebungsprüfung ausgeführt, eine vollständige Umgebungsprüfung ausgeführt, und die Cloudbereitstellung wird gestartet. Nach einigen Minuten können Sie die Bereitstellung im Portal überwachen.
Navigieren Sie in einem neuen Browserfenster zur Ressourcengruppe für Ihre Umgebung. Wählen Sie die Clusterressource aus.
Wählen Sie Bereitstellungen aus.
Aktualisieren und watch des Bereitstellungsfortschritts vom ersten Server (auch als Seedserver bezeichnet und ist der erste Server, auf dem Sie den Cluster bereitgestellt haben). Die Bereitstellung dauert zwischen 2,5 und 3 Stunden. Mehrere Schritte dauern 40-50 Minuten oder mehr.
Der Schritt in der Bereitstellung, der am längsten dauert, ist Bereitstellen von Moc und ARB Stack. Dieser Schritt dauert 40 bis 45 Minuten.

Nach Abschluss wird die Aufgabe an der Obersten Stelle mit status und Endzeit aktualisiert.

Sie können sich auch diese Communityvorlage ansehen, um einen Azure Stack HCI-Cluster der Version 23H2 mithilfe von Bicep bereitzustellen.

Problembehandlung bei Bereitstellungsproblemen

Wenn die Bereitstellung fehlschlägt, sollte auf der Seite Bereitstellungen eine Fehlermeldung angezeigt werden.

Wählen Sie unter Bereitstellungsdetails die Fehlerdetails aus.
Kopieren Sie die Fehlermeldung vom Blatt Fehler . Sie können diese Fehlermeldung für weitere Unterstützung an den Microsoft-Support senden.

Bekannte Probleme bei der Bereitstellung von ARM-Vorlagen

Dieser Abschnitt enthält bekannte Probleme und Problemumgehungen für die Bereitstellung von ARM-Vorlagen.

Problem	Problemumgehung/Kommentare
In dieser Version wird möglicherweise der Fehler "Rollenzuweisung bereits vorhanden" angezeigt. Dieser Fehler tritt auf, wenn die Azure Stack HCI-Clusterbereitstellung zuerst über das Portal versucht wurde und dieselbe Ressourcengruppe für die Bereitstellung von ARM-Vorlagen verwendet wurde.	Obwohl diese Fehler ignoriert werden können und die Bereitstellung über die ARM-Vorlage fortgesetzt werden kann, wird dringend empfohlen, die Bereitstellungsmodi nicht zwischen dem Portal und der ARM-Vorlage zu wechseln.
In diesem Release tritt möglicherweise ein Lizenzsynchronisierungsproblem auf, wenn Sie die ARM-Vorlagenbereitstellung verwenden.	Nachdem der Cluster die Validierungsphase abgeschlossen hat, wird empfohlen, keine weitere ARM-Vorlagenbereitstellung im Modus "Überprüfen" zu initiieren, wenn sich ihr Cluster im Status "Bereitstellungsfehler " befindet. Beim Starten einer anderen Bereitstellung werden die Clustereigenschaften zurückgesetzt, was zu Lizenzsynchronisierungsproblemen führen kann.

Share via