Verwenden von API-Versionsprofilen mit Node.js Software Development Kit (SDK) im Azure Stack Hub

Node.js- und API-Versionsprofile

Sie können Node.js SDK verwenden, um die Infrastruktur für Ihre Apps zu erstellen und zu verwalten. API-Profile im Node.js SDK helfen Bei Ihren Hybrid-Cloudlösungen, indem Sie zwischen globalen Azure-Ressourcen und Azure Stack Hub-Ressourcen wechseln können. Sie können einmal codieren und dann sowohl auf den globalen Azure- als auch auf den Azure Stack Hub abzielen.

In diesem Artikel können Sie Visual Studio Code als Entwicklungstool verwenden. Visual Studio Code kann das Node.js SDK debuggen und ermöglicht es Ihnen, die App auszuführen und die App an Ihre Azure Stack Hub-Instanz zu übertragen. Sie können aus Visual Studio Code oder über ein Terminalfenster debuggen, in dem der Befehl node <nodefile.js>ausgeführt wird.

Das Node.js SDK

Das Node.js SDK stellt Azure Stack Hub Resource Manager-Tools bereit. Ressourcenanbieter im SDK umfassen Compute, Netzwerk, Speicher, App-Dienste und KeyVault. Es gibt 10 Clientbibliotheken des Ressourcenanbieters, die Sie in Ihrer node.js Anwendung installieren können. Sie können auch den Ressourcenanbieter herunterladen, den Sie für das 2020-09-01-Profil verwenden werden, um den Speicher für Ihre Anwendung zu optimieren. Jedes Modul besteht aus einem Ressourcenanbieter, der jeweiligen API-Version und dem API-Profil.

Ein API-Profil ist eine Kombination aus Ressourcenanbietern und API-Versionen. Sie können ein API-Profil verwenden, um die neueste, stabilste Version jedes Ressourcentyps in einem Ressourcenanbieterpaket abzurufen.

• Um die neuesten Versionen aller Dienste nutzen zu können, verwenden Sie das neueste Profil der Pakete.

• Um die mit Azure Stack Hub kompatiblen Dienste zu verwenden, verwenden Sie das @azure/arm-resources-profile-profile-hybrid-2020-09-01 oder @azure/arm-storage-profile-2020-09-01-hybrid

NPM-Pakete

Jeder Ressourcenanbieter verfügt über ein eigenes Paket. Sie können das Paket aus der npm-Registrierung abrufen.

Sie finden die folgenden Pakete:

Um die neueste API-Version eines Diensts zu verwenden, verwenden Sie das neueste Profil der spezifischen Clientbibliothek. Wenn Sie beispielsweise die neueste API-Version des Ressourcendiensts allein verwenden möchten, verwenden Sie das azure-arm-resource Profil der Ressourcenverwaltungs-Clientbibliothek.

Verwenden Sie die spezifischen API-Versionen, die innerhalb des Pakets für die spezifischen API-Versionen eines Ressourcenanbieters definiert sind.

• @azure/arm-resourceprovider-profile-2020-09-01-hybrid

  Neuestes Profil, das für Azure Stack Hub erstellt wurde. Verwenden Sie dieses Profil, damit Dienste mit Azure Stack Hub am besten kompatibel sind, solange Sie 1808 stempeln oder weiter verwenden.

• @azure-Arm-Ressource

  Profil besteht aus den neuesten Versionen aller Dienste. Verwenden Sie die neuesten Versionen aller Dienste in Azure.

Profile

Für Profile, die Datumsangaben enthalten, können Sie ein anderes SDK-Profil oder eine andere Version verwenden, um das Datum in @azure/arm-keyvault-profile-<date>-hybrid. For example, for the 2008 version, the profile is 2019-03-01, and the string is @azure/arm-keyvault-profile-2019-03-01-hybrid. Beachten Sie, dass das SDK-Team manchmal den Namen der Pakete ändert, sodass das Ersetzen des Datums einer Zeichenfolge durch ein anderes Datum möglicherweise nicht funktioniert. In der folgenden Tabelle finden Sie die Zuordnung von Profilen und Azure Stack-Versionen.

Weitere Informationen zu Azure Stack Hub- und API-Profilen finden Sie in der Zusammenfassung der API-Profile.

Installieren des Node.js SDK

1. Installieren Sie Git. Anweisungen finden Sie unter "Erste Schritte – Installieren von Git".

2. Installieren oder aktualisieren Sie auf die aktuelle Version von Node.js. Node.js enthält auch den npm JavaScript-Paket-Manager.

3. Installieren oder aktualisieren Sie Visual Studio Code , und installieren Sie die Node.js Erweiterung für Visual Studio Code.

4. Installieren Sie die Clientpakete für den Azure Stack Hub Resource Manger. Weitere Informationen finden Sie unter Installieren von Clientbibliotheken.

5. Die Pakete, die installiert werden müssen, hängen von der Profilversion ab, die Sie verwenden möchten. Eine Liste der Ressourcenanbieter finden Sie im Abschnitt "Pakete" im npm-Abschnitt .

Abonnement

Wenn Sie noch nicht über ein Abonnement verfügen, erstellen Sie ein Abonnement, und speichern Sie die Abonnement-ID, die später verwendet werden soll. Informationen zum Erstellen eines Abonnements finden Sie in diesem Dokument.

Service Principal

Ein Dienstprinzipal und die zugehörigen Umgebungsinformationen sollten an einer beliebigen Stelle erstellt und gespeichert werden. Dienstprinzipal mit owner Rolle wird empfohlen, aber je nach Beispiel kann eine contributor Rolle ausreichen. Weitere Informationen finden Sie in der INFODATEI im Beispiel-Repository für die erforderlichen Werte. Sie können diese Werte in jedem Format lesen, das von der SDK-Sprache unterstützt wird, z. B. aus einer JSON-Datei (die unsere Beispiele verwenden). Je nachdem, wie das Beispiel ausgeführt wird, können nicht alle diese Werte verwendet werden. Weitere Informationen finden Sie im Beispiel-Repository für aktualisierte Beispielcode oder weitere Informationen.

Mieter-ID

Um das Verzeichnis oder die Mandanten-ID für Ihren Azure Stack Hub zu finden, befolgen Sie die Anweisungen in diesem Artikel.

Registrieren von Ressourcenanbietern

Registrieren Sie die erforderlichen Ressourcenanbieter, indem Sie diesem Dokument folgen. Diese Ressourcenanbieter sind abhängig von den Beispielen erforderlich, die Sie ausführen möchten. Wenn Sie beispielsweise ein VM-Beispiel ausführen möchten, ist die Registrierung des Microsoft.Compute Ressourcenanbieters erforderlich.

Azure Stack-Ressourcen-Manager-Endpunkt

Azure Resource Manager (ARM) ist ein Verwaltungsframework, mit dem Administratoren Azure-Ressourcen bereitstellen, verwalten und überwachen können. Azure Resource Manager kann diese Aufgaben als Gruppe und nicht einzeln in einem einzigen Vorgang verarbeiten. Sie können die Metadateninformationen vom Ressourcen-Manager-Endpunkt abrufen. Der Endpunkt gibt eine JSON-Datei mit den zum Ausführen des Codes erforderlichen Informationen zurück.

Beachte Folgendes:

• Der ResourceManagerEndpointUrl im Azure Stack Development Kit (ASDK) lautet: https://management.local.azurestack.external/.

• Der ResourceManagerEndpointUrl in integrierten Systemen lautet: https://management.region.<fqdn>/, wo <fqdn> befindet sich Ihr vollqualifizierter Domänenname.

• So rufen Sie die erforderlichen Metadaten ab: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

JSON-Beispiel:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

Beispiele

Sehen Sie sich das Beispiel-Repository für den aktuellen Beispielcode an. Der Stamm README.md beschreibt allgemeine Anforderungen, und jedes Unterverzeichnis enthält ein bestimmtes Beispiel mit eigenen README.md Informationen zum Ausführen dieses Beispiels.

Nächste Schritte

Weitere Informationen zu API-Profilen:

• Verwalten von API-Versionsprofilen in Azure Stack Hub
• Ressourcenanbieter-API-Versionen, die von Profilen unterstützt werden