Konfigurieren Ihrer JavaScript-Entwicklungsumgebung für Azure

Beim Erstellen von Cloudanwendungen ziehen es Entwickler in der Regel vor, Code auf Ihren lokalen Arbeitsstationen zu testen, bevor sie diesen Code in einer Cloudumgebung wie Azure bereitstellen. Die lokale Entwicklung bietet Ihnen den Vorteil einer größeren Vielfalt an Tools und einer vertrauten Umgebung.

Dieser Artikel enthält die Einrichtungsanweisungen zum Erstellen und Überprüfen einer lokalen Entwicklungsumgebung, die für JavaScript mit Azure geeignet ist.

Einmalige Abonnementerstellung

Azure-Ressourcen werden innerhalb eines Abonnements und einer Ressourcengruppe erstellt.

Einmalige Softwareinstallation

Für die Azure-Entwicklung mit JavaScript auf Ihrer lokalen Arbeitsstation wird die Installation der folgenden Komponenten empfohlen:

Azure-Hostingruntime

Wenn Sie eine Azure-Ressource als Hostingumgebung für Ihre Anwendung verwenden möchten, z. B. eine Azure-Web-App oder Azure Functions, sollten Sie überprüfen, ob die Node.js-Runtimeversion Ihrer lokalen Node.js-Entwicklungsumgebung der Runtime der Azure-Ressource entspricht, die Sie verwenden möchten.

Empfohlene lokale Installationen

Die folgenden allgemeinen Installationen lokaler Arbeitsstationen werden empfohlen, um Sie bei den lokalen Entwicklungsaufgaben zu unterstützen.

Installieren von Node.js

Das Azure SDK unterstützt die LTS-Version (Long-Term Support, langfristiger Support) von Node.js. Ausführlichere Informationen finden Sie in der Azure SDK-Supportrichtlinie.

Azure-Dienste: Mindestversion von Node.js

Stellen Sie zum Hosten Ihrer JavaScript-Apps in einer Azure-Hostingumgebung sicher, dass die Node.js-Runtime Ihrer lokalen Entwicklungsumgebung die Azure-Hostingruntime imitiert, die Sie verwenden möchten.

• Azure App Service nutzt die Node.js-Runtime-Engine. Führen Sie in Cloud Shell den folgenden Befehl aus, um alle unterstützten Node.js-Versionen anzuzeigen:

  az webapp list-runtimes | grep node
  

• Azure Static Web Apps-Runtimes sind nur für die Funktions-APIs relevant.

• Von Azure Functions unterstütze Node.js-Versionen basieren auf der von Ihnen verwendeten Version von Azure Functions.

• Benutzerdefinierte Runtimes: Eine benutzerdefinierte Runtime wird auf folgende Weise unterstützt:

  • Virtuelle Computer
  • Container: Einzelinstanzen, Web-App und Kubernetes
  • (Serverlose) Funktionen verwenden benutzerdefinierte Handler

Verwalten mehrerer Node.js-Versionen

Wenn Sie mehrere Node.js-Versionen in Ihren lokalen Umgebungen und Remoteumgebungen verwalten müssen, wird Folgendes empfohlen:

• Development Containers: Verwenden Sie einen Container mit einer bestimmten Mindestversion von Node.js. Sie können die Node.js-Version umgebungsübergreifend mithilfe von Containern verwalten. Die Visual Studio Code-Erweiterung Remote – Container vereinfacht die Verwendung von Containern.
• NVM (Node Version Manager): Eine Befehlszeilenschnittstelle zur Einrichtung oder zum Wechseln Ihrer lokalen Version von Node.js.

Herunterladen und Installieren von Node.js basierend auf dem Verwendungszweck

Sie können Node.js Ihren Anforderungen entsprechend herunterladen und installieren.

• Node.js-Downloadseite
• Offizielles Docker-Image

Einmalkonfiguration für die Authentifizierung

Wenn Sie den gleichen Authentifizierungscode in der lokalen Entwicklung und in der Azure-Remotehostingumgebung nutzen möchten, verwenden Sie DefaultAzureCredential. Erfahren Sie mehr über diese verwaltete Identität.

Erstellen einer Ressourcengruppe für Ihr Projekt

Arbeiten mit Azure und den Azure SDK-Clientbibliotheken

Die Azure-Clientbibliotheken werden für jeden Dienst einzeln bereitgestellt. Sie installieren jede Bibliothek basierend auf dem Azure-Dienst, den Sie verwenden müssen.

Für jedes neue Projekt mit Azure müssen folgende Aktionen ausgeführt werden:

• Erstellen von Azure-Ressourcen.
• Installieren Sie Azure-Clientbibliotheken über einen Paket-Manager wie NPM.
• Verwenden Sie eine verwaltete Identität, um sich mit der Azure-Clientbibliothek zu authentifizieren, und verwenden Sie dann Konfigurationsinformationen für den Zugriff auf bestimmte Dienste.

Schützen von Konfigurationsinformationen

Sie haben mehrere Optionen zum Speichern von Konfigurationsinformationen:

• Azure Key Vault zum Erstellen und Verwalten von Geheimnissen, Schlüsseln und Zertifikaten, die auf Cloudressourcen zugreifen, die noch keinen Zugriff mit verwalteten Identitäten bieten.
• Dotenv ist ein beliebtes npm-Paket zum Lesen von Umgebungsvariablen aus einer Datei vom Typ .env. Fügen Sie unbedingt die .env-Datei zur .gitignore-Datei hinzu, damit die .env-Datei nicht in die Quellcodeverwaltung eingecheckt wird.

Erstellen von Umgebungsvariablen

Zum Verwenden der Azure-Einstellungen, die von den Azure SDK-Bibliotheken für den Zugriff auf die Azure-Cloud benötigt werden, legen Sie die gängigsten Werte auf Umgebungsvariablen fest. Mit den folgenden Befehlen werden die Umgebungsvariablen für die lokale Arbeitsstation festgelegt.

In den folgenden Beispielen ist die Client-ID die Dienstprinzipal-ID und das Dienstprinzipalgeheimnis.

AZURE_SUBSCRIPTION_ID="<REPLACE-WITH-YOUR-AZURE-SUBSCRIPTION-ID>"
AZURE_TENANT_ID="<REPLACE-WITH-YOUR-AZURE-TENANT-ID>"
AZURE_CLIENT_ID="<REPLACE-WITH-YOUR-AZURE-CLIENT-ID>"
AZURE_CLIENT_SECRET="<REPLACE-WITH-YOUR-AZURE-CLIENT-SECRET>"

set AZURE_SUBSCRIPTION_ID="<REPLACE-WITH-YOUR-AZURE-SUBSCRIPTION-ID>"
set AZURE_TENANT_ID="<REPLACE-WITH-YOUR-AZURE-TENANT-ID>"
set AZURE_CLIENT_ID="<REPLACE-WITH-YOUR-AZURE-CLIENT-ID>"
set AZURE_CLIENT_SECRET="<REPLACE-WITH-YOUR-AZURE-CLIENT-SECRET>"

Ersetzen Sie die in diesen Befehlen angezeigten Werte durch die Werte Ihrer spezifischen Umgebungsvariablen.

Erstellen einer Datei vom Typ .env

Ein weiterer gebräuchlicher Mechanismus ist die Verwendung des NPM-Pakets DOTENV, um eine .env-Datei für diese Einstellungen zu erstellen. Wenn Sie .env verwenden möchten, fügen Sie die Datei zu .gitignore hinzu, damit Sie die Datei nicht in die Quellcodeverwaltung einchecken. Das Hinzufügen der .env-Datei zur .ignore-Datei von Git ist die Standardmethode, um sicherzustellen, dass diese Einstellungen in die Quellcodeverwaltung eingecheckt werden.

NPM-Pakete installieren

Wir empfehlen, für jedes Projekt immer einen separaten Order und eine eigene package.json-Datei zu erstellen. Dazu gehen Sie folgendermaßen vor:

1. Öffnen Sie ein Terminal, eine Eingabeaufforderung oder eine Bash-Shell, und erstellen Sie einen neuen Ordner für das Projekt. Wechseln Sie dann in den neuen Ordner.

   mkdir MY-NEW-PROJECT && cd MY-NEW-PROJECT
   

2. Initialisieren Sie die Paketdatei:

   npm init -y
   

   Dadurch wird die Datei „package.json“ erstellt, und die Mindesteigenschaften werden initialisiert.

3. Installieren Sie die benötigten Azure cl-Bibliotheken wie im folgenden Beispiel:

   npm install @azure/identity
   

Verwenden der Quellcodeverwaltung mit Visual Studio Code

Wir empfehlen, sich anzugewöhnen, bei jedem Start eines Projekts ein Quellcodeverwaltungs-Repository zu erstellen. Dieser Schritt kann über Visual Studio Code ausgeführt werden.

1. Klicken Sie in Visual Studio Code auf das Symbol für die Quellcodeverwaltung, um den Explorer für die Quellcodeverwaltung zu öffnen. Klicken Sie anschließend auf Repository initialisieren, um ein lokales Git-Repository zu initialisieren:

   

2. Wenn Sie das Repository initialisiert haben und Dateien zum Speichern in der Quellcodeverwaltung besitzen, geben Sie die Meldung Initial commit ein, und wählen Sie das Häkchen aus, um den ersten Commit Ihrer Quelldateien zu erstellen.

   

3. Erstellen Sie ein neues Repository auf GitHub, und kopieren Sie die Repository-URL für die nächsten Schritte.

4. Verwenden Sie im integrierten Visual Studio-Terminal den folgenden Git-Befehl, um Ihr Remoterepository ihrem lokalen Repository hinzuzufügen. Ersetzen Sie YOUR-ALIAS und YOUR-REPOSITORY durch Ihre eigenen Werte.

   git remote add origin https://github.com/YOUR-ALIAS/YOUR-REPOSITORY
   

Visual Studio Code umfasst eine Reihe integrierter Git-Features. Weitere Informationen finden Sie unter Verwenden der Versionskontrolle in VS Code.

Nächste Schritte

• Erstellen und Verwenden eines Dienstprinzipals
• Authentifizieren mit den Azure-Modulen für Node.js