Freigeben über

Konfigurieren Ihrer JavaScript-Entwicklungsumgebung für Azure

  • Artikel

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.

Typ

Beschreibung

Abonnement für die Testversion

Erstellen Sie ein kostenloses Testabonnement.

Bestehendes Abonnement

Wenn Sie bereits über ein Abonnement verfügen, greifen Sie mit folgenden Komponenten auf Ihr vorhandenes Abonnement zu:

Mehrere Abonnements

Wenn Sie mehrere Abonnements verwalten müssen, lesen Sie hier, wie Sie eine Verwaltungsgruppe mit JavaScript erstellen.

Einmalige Softwareinstallation

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

Name/Installationsprogramm Beschreibung
Node.js LTS Installieren Sie die aktuelle Laufzeitumgebung mit langfristigem Support (Long-Term Support, LTS) für die Entwicklung auf lokalen Arbeitsstationen.
Visual Studio Code Visual Studio Code bietet eine hervorragende Integrations- und Codierungsumgebung mit JavaScript, ist aber nicht erforderlich. Sie können einen beliebigen Code-Editor verwenden.
Visual Studio Code-Erweiterungen Installieren Sie alle relevanten Erweiterungen für Azure-Dienste, die Sie verwenden möchten.

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.

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

Name Beschreibung
Azure-Befehlszeilenschnittstelle Lokale oder cloudbasierte CLI zum Erstellen und Verwenden von Azure-Ressourcen
Azure Developer CLI Entwicklerorientiertes Befehlszeilentool zum Erstellen von Cloud-Apps im Entwicklerworkflow.
Visual Studio Code-Erweiterungen für Azure VS Code-Erweiterungen für die IDE
Git oder Git für Windows Befehlszeilentools für die Quellcodeverwaltung. Wenn Sie es vorziehen, können Sie ein anderes Quellcodeverwaltungstool verwenden.
Docker für Windows oder Mac Verwenden Sie Entwicklungscontainer für konsistente Entwicklungsumgebungen.
Node.js LTS Weitere Informationen

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.

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.

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

  1. Öffnen Sie das Azure-Portal in einem Webbrowser.

  2. Geben Sie in der Suchleiste Ressourcengruppen ein, und wählen Sie die entsprechende Option aus.

  3. Wählen Sie + Erstellen aus.

  4. Geben Sie Ihre Einstellungen für Ressourcengruppen ein:

    Eigenschaft Wert
    Subscription Wählen Sie Ihr Abonnement aus.
    Resource group Geben Sie den Namen Ihrer Ressourcengruppe ein. Dieser Ressourcengruppenname wird als Teil eines Ressourcen-URI verwendet, wenn Sie auf den Ressourcen-Manager (Verwaltungsebene) zugreifen. Der Name wird nicht für die Steuerung (z. B. das Erstellen einer Datenbank) oder eine Datenebene (Einfügen von Daten in eine Tabelle) verwendet.
    Region Wählen Sie eine geographische Region für die Ressourcengruppe aus.

  5. Wählen Sie zum Start der Validierung Überprüfen und erstellen aus.

  6. Wählen Sie nach erfolgreicher Validierung Erstellen aus.

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>"

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:

    Initialisieren eines Git-Repositorys

  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.

    Durchführen eines ersten Commits für das Repository

  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