Bereitstellen von Azure Local über die Azure Resource Manager-Bereitstellungsvorlage

Artikel
2025-04-22

Gilt für: Azure Local 2311.2 und höher

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

Wichtig

Die Azure Resource Manager-Vorlagenbereitstellung von lokalen Azure-Systemen richtet sich an Bereitstellungen im großen Maßstab. Die zielgruppe für diese Bereitstellung ist IT-Administratoren, die Erfahrung beim Bereitstellen von lokalen Azure-Instanzen haben. Es wird empfohlen, zuerst ein System über das Azure-Portal bereitzustellen und anschließend nachfolgende Bereitstellungen über die Resource Manager-Vorlage auszuführen.

Voraussetzungen

Abschluss der Registrierung Ihrer Computer mit Azure Arc und Zuweisen von Bereitstellungsberechtigungen. Stellen Sie sicher, dass:
- Alle obligatorischen Erweiterungen werden erfolgreich installiert. Zu den obligatorischen Erweiterungen gehören: Azure Edge Lifecycle Manager, Azure Edge Geräteverwaltung, Telemetrie und Diagnose sowie Azure Edge Remote Support.
- Alle Computer führen dieselbe Version des Betriebssystems aus.
- Alle Computer verfügen über dieselbe Netzwerkadapterkonfiguration.

Schritt 1: Vorbereiten von Azure-Ressourcen

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

Abrufen der Objekt-ID für Azure Local Resource Provider

Diese Objekt-ID für das lokale Azure RP ist pro Azure-Mandant eindeutig.

Suchen Sie im Azure-Portal nach Microsoft Entra ID, und gehen Sie dahin.
Wechseln Sie zur Registerkarte "Übersicht ", und suchen Sie nach Dem Microsoft.AzureStackHCI-Ressourcenanbieter.
Wählen Sie den SPN aus, der aufgelistet ist, und kopieren Sie die Objekt-ID.

Alternativ können Sie PowerShell verwenden, um die Objekt-ID des Azure Local RP-Dienstprinzipals abzurufen. Führen Sie in PowerShell den folgenden Befehl aus:
```
Get-AzADServicePrincipal -DisplayName "Microsoft.AzureStackHCI Resource Provider"
```
Sie verwenden die -Objekt ID gegen den hciResourceProviderObjectID-Parameter in der Resource Manager-Vorlage.

Schritt 2: Bereitstellen mithilfe der Azure Resource Manager-Vorlage

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

Nachdem alle erforderlichen und vorbereitenden Schritte abgeschlossen sind, können Sie die Bereitstellung mithilfe einer bewährten und getesteten Ressourcen-Manager-Bereitstellungsvorlage und der entsprechenden JSON-Parameterdatei durchführen. Verwenden Sie die parameter, die in der JSON-Datei enthalten sind, um alle Werte auszufüllen, einschließlich der zuvor generierten Werte.

Wichtig

Stellen Sie in dieser Version sicher, dass alle parameter, die im JSON-Wert enthalten sind, ausgefüllt sind, einschließlich der Parameter mit einem Nullwert. Wenn Nullwerte vorhanden sind, müssen diese ausgefüllt werden, oder die Überprüfung schlägt fehl.

Wechseln Sie im Azure-Portal zu "Start", und wählen Sie "+Ressource erstellen" aus.
Wählen Sie "Erstellen " unter "Vorlagenbereitstellung" (Bereitstellen mit benutzerdefinierten Vorlagen) aus.
Suchen Sie nahe dem unteren Ende der Seite nach dem Abschnitt "Starten Sie mit einer Schnellstartvorlage oder Vorlagenspezifikation". Wählen Sie die Option "Schnellstartvorlage" aus .
Verwenden Sie das Schnellstartvorlagenfeld (Haftungsausschluss), um nach der entsprechenden Vorlage zu filtern. Geben Sie azurestackhci/create-cluster für den Filter ein.
Wenn Sie fertig sind, wählen Sie die 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. Sobald die Parameter ausgefüllt sind, speichern Sie die Parameterdatei.
Wählen Sie die entsprechende Ressourcengruppe für Ihre Umgebung aus.
Scrollen Sie nach unten und bestätigen Sie, dass Deployment Mode = Validate 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.
Nachdem die Überprüfung abgeschlossen ist, wählen Sie "Erneut bereitstellen" aus.
Wählen Sie auf dem Bildschirm "Benutzerdefinierte Bereitstellung" die Option "Parameter bearbeiten" aus. Laden Sie die zuvor gespeicherten Parameter, und wählen Sie "Speichern" aus.
Ändern Sie unten im Arbeitsbereich den letzten Wert im JSON von Validate in Deploy, wobei Deployment Mode = Deploy.
Vergewissern Sie sich, dass alle Felder für die Ressourcen-Manager-Bereitstellungsvorlage durch den PARAMETER-JSON-Code ausgefüllt werden.
Wählen Sie die entsprechende Ressourcengruppe für Ihre Umgebung aus.
Scrollen Sie nach unten und bestätigen Sie, dass Deployment Mode = Deploy ist.
Klicken Sie auf Überprüfen + erstellen.
Klicken Sie auf Erstellen. Die Bereitstellung beginnt mit der Verwendung der vorhandenen erforderlichen Ressourcen, die während des Überprüfungsschritts erstellt wurden.

Die Seite Bereitstellen wechselt während der Bereitstellung auf die Cluster-Ressource.

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 ein paar 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 beobachten Sie den Bereitstellungsfortschritt von der ersten Maschine (auch bekannt als Seed-Maschine und ist die erste Maschine, auf der 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 Moc und ARB-Stack bereitstellen. Dieser Schritt dauert 40-45 Minuten.

Sobald der Vorgang abgeschlossen ist, wird die Aufgabe am oberen Rand mit Status und Endzeit aktualisiert.

Sie können diese Community-Quellvorlage auch auschecken, um eine lokale Azure-Instanz mithilfe von Bicep bereitzustellen.

Problembehandlung bei Bereitstellungsproblemen

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

Wählen Sie in den Bereitstellungsdetails die Fehlerdetails aus.
Kopieren Sie die Fehlermeldung vom Blatt "Fehler" . Sie können diese Fehlermeldung an den Microsoft-Support senden, um weitere Unterstützung zu erhalten.

Bekannte Probleme beim Bereitstellen von ARM-Vorlagen

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

Rollenzuweisung existiert bereits

Problem: In dieser Version kann der Fehler Rollenzuweisung existiert bereits auftreten. Dieser Fehler tritt auf, wenn die Bereitstellung der lokalen Azure-Instanz zuerst über das Portal versucht wurde und die gleiche Ressourcengruppe für die BEREITSTELLUNG von ARM-Vorlagen verwendet wurde. Sie sehen diesen Fehler auf der Seite Übersicht > Einsatzdetails für die entsprechende Ressource. Dieser Fehler weist darauf hin, dass eine entsprechende Rollenzuweisung bereits von einer anderen Identität für denselben Ressourcengruppenbereich vorgenommen wurde und die Bereitstellung der ARM-Template keine Rollenzuweisung ausführen kann.

Workaround: Die fehlgeschlagene Ressource auf der Seite Bereitstellungsdetails gibt den Namen der Rollenzuweisung an. Wenn der Ressourcenname AzureStackHCIDeviceManagementRole-RoleAssignment ist, ist die Rollenzuweisung für die Azure Stack HCI-Geräteverwaltungsrolle fehlgeschlagen. Notieren Sie sich diesen Rollennamen und gehen Sie zu Ressourcengruppe > Zugriffssteuerung (IAM) > Rollenzuweisungen. Suchen Sie nach dem entsprechenden Namen, und löschen Sie dort die vorhandenen Rollenzuweisungen. Stellen Sie Ihre Vorlage erneut zur Anwendung.

Mandant-ID, Anwendungs-ID, Prinzipal-ID und Bereich dürfen nicht aktualisiert werden

Problem: Die Rollenzuweisung schlägt fehl mit dem Fehler Mandanten-ID, Anwendungs-ID, Principal-ID und Scope dürfen nicht aktualisiert werden. Sie sehen diesen Fehler auf der Seite Übersicht > Einsatzdetails für die entsprechende Ressource. Dieser Fehler kann angezeigt werden, wenn in derselben Ressourcengruppe Zombie-Rollenzuweisungen vorhanden sind. Wenn beispielsweise eine vorherige Bereitstellung ausgeführt wurde und die Ressourcen, die dieser Bereitstellung entsprechen, gelöscht wurden, aber die Rollenzuweisungsressourcen verbleiben.

Problemumgehung: Um die Zombie-Rollenzuweisungen zu identifizieren, wechseln Sie zur Registerkarte Access control (IAM) > Rollenzuweisungen > Typ: Unbekannt. Diese Rollenzuweisungen werden als *Identität nicht gefunden. Identität kann nicht gefunden werden. angezeigt. Löschen Sie diese Rollenzuweisungen, und wiederholen Sie dann die ARM-Vorlagenbereitstellung.

Problem mit der Lizenzsynchronisierung

Problem: In dieser Version können bei der Verwendung von ARM-Vorlagen Probleme mit der Lizenzsynchronisierung auftreten.

Problemumgehung: Nachdem das System die Überprüfungsphase abgeschlossen hat, empfiehlt es sich, keine weitere ARM-Vorlagenbereitstellung im Überprüfungsmodus zu initiieren, wenn sich ihr System im Zustand "Bereitstellungsfehler " befindet. Wenn Sie eine andere Bereitstellung starten, werden die Systemeigenschaften zurückgesetzt, was zu Lizenzsynchronisierungsproblemen führen kann.

Freigeben über