Uw JavaScript-ontwikkelomgeving configureren voor Azure

Wanneer u cloudtoepassingen maakt, geven ontwikkelaars doorgaans de voorkeur aan het testen van code op hun lokale werkstations voordat ze die code implementeren in een cloudomgeving zoals Azure. Lokale ontwikkeling biedt u het voordeel van een grotere verscheidenheid aan hulpprogramma's, samen met een vertrouwde omgeving.

Dit artikel bevat installatie-instructies voor het maken en valideren van een lokale ontwikkelomgeving die geschikt is voor JavaScript met Azure.

Eenmalige abonnement maken

Azure-resources worden gemaakt binnen een abonnement en resourcegroep.

Typ

Beschrijving

Proefabonnement

Maak een gratisproefabonnement.

Bestaand abonnement

Als u al een abonnement hebt, hebt u toegang tot uw bestaande abonnement met:

• Azure-portal
• Azure-CLI
• Azure-clientbibliotheken voor JavaScript
• Visual Studio Code-extensies

Over meerdere abonnementen

Als u meerdere abonnementen wilt beheren, leert u hoe u een beheergroep maakt met JavaScript.

Eenmalige software-installatie

Bij Azure-ontwikkeling met JavaScript op uw lokale werkstation raden we aan de volgende hulpprogramma's te installeren:

Naam/installatieprogramma	Beschrijving
Node.js LTS	Installeer de meest recente runtime-omgeving voor langetermijnondersteuning (LTS) voor het ontwikkelen van lokale werkstations. Meer informatie over het selecteren van een versie van Node.js voor Azure.
Visual Studio Code	Visual Studio Code biedt u een geweldige JavaScript-integratie- en coderingservaring, maar dit is niet vereist. U kunt elke code-editor gebruiken.
Visual Studio Code-extensies	Installeer alle relevante extensies voor Azure-services die u wilt gebruiken.

Azure-hostingruntime

Wanneer u een Azure-resource gebruikt als hostingomgeving voor uw toepassing, zoals een Azure-web-app of Azure Functions, controleert u of uw lokale Node.js runtimeversie van de ontwikkelomgeving van Node.js overeenkomt met de Azure-resourceruntime die u wilt gebruiken.

Aanbevolen lokale installaties

De volgende algemene installaties van lokale werkstations worden aanbevolen om u te helpen bij uw lokale ontwikkelingstaken.

Naam	Beschrijving
Azure-CLI	Lokale of cloudgebaseerde CLI voor het maken en gebruiken van Azure-resources.
Azure Developer CLI	Het ontwikkelaarsgerichte opdrachtregelprogramma voor het bouwen van cloud-apps in de ontwikkelaarsworkflow.
Visual Studio Code-extensies voor Azure	VS Code-extensies voor de IDE.
Git of Git voor Windows	Opdrachtregelprogramma's voor broncodebeheer. U kunt desgewenst een ander hulpprogramma voor broncodebeheer gebruiken.
Docker voor Windows of Mac	Ontwikkelcontainers gebruiken voor consistente ontwikkelomgevingen.
Node.js LTS	Meer informatie

Node.js installeren

Azure ondersteunt LTS-versies van Node.js. Meer informatie over het selecteren van een versie van Node.js voor Azure.

Eenmalige configuratie voor verificatie

Als u dezelfde verificatiecode in lokale ontwikkeling en de externe Azure-hostingomgeving wilt gebruiken, gebruikt u de DefaultAzureCredential. Meer informatie over deze beheerde identiteit.

Een resourcegroep maken voor uw project

Azure-portal

1. Open Azure Portal in een webbrowser.

2. Voer resourcegroepen in de zoekbalk in en selecteer deze.

3. Selecteer + Aanmaken.

4. Voer de instellingen voor uw resourcegroep in:

   Eigenschap	Waarde
   Abonnement	Selecteer uw abonnement.
   Resourcegroep	Voer de naam van de resourcegroep in. Deze resourcegroepnaam wordt gebruikt als onderdeel van een resource-URI wanneer u toegang krijgt tot Resource Manager (beheervlak). De naam wordt niet gebruikt voor het beheren (zoals het maken van een database) of het gegevensvlak (het invoegen van gegevens in een tabel).
   Regio	Selecteer een geografische regio voor de resourcegroep.

5. Selecteer Beoordelen en maken om de validatie te starten.

6. Wanneer de validatie is geslaagd, selecteert u Maken.

Visual Studio Code

1. Open het opdrachtenpalet, Ctrl + +

2. Zoek naar 'maak een resourcegroep aan' en selecteer deze.

3. Beantwoord de aanwijzingen met behulp van de volgende instellingen:

   Snel	Waarde
   Abonnement selecteren	Meld u aan bij Azure als u hierom wordt gevraagd. Selecteer een bestaand abonnement of maak een Azure-account als u er nog geen hebt.
   Voer de naam van de nieuwe resourcegroep in.	Voer de naam van de resourcegroep in. Deze resourcegroepnaam wordt gebruikt als onderdeel van een resource-URI wanneer u toegang krijgt tot Resource Manager (beheervlak). De naam wordt niet gebruikt voor het beheren (zoals het maken van een database) of het gegevensvlak (het invoegen van gegevens in een tabel).
   Selecteer een locatie voor nieuwe resources.	Selecteer een geografische regio voor de resourcegroep.

Azure-CLI

1. Meld u aan bij Azure:

   az login
   

   Voltooi de verificatie in een browser.

2. Geef uw abonnementsnamen en id's weer. Kopieer de SubscriptionId-waarde om de volgende opdracht te gebruiken.

   az account subscription list --output table 
   

3. Stel uw standaardabonnement in, dat wordt gebruikt door volgende opdrachten:

   az account set --subscription YOUR_SUBSCRIPTION_ID
   

4. Selecteer een van de locaties die worden ondersteund voor uw abonnement. Kopieer de waarde van Naam van een regio dicht bij u.

   az account list-locations --output table
   

5. Gebruik de volgende Azure CLI om een resourcegroep te maken met de naam of id van uw abonnement:

   az group create --name "YOUR_RESOURCE_GROUP_NAME" --location YOUR_REGION
   

   Voorbeeld:

   az group create --name "my-azure-app" --location westus
   

Werken met Azure en de Azure SDK-clientbibliotheken

De Azure-clientbibliotheken worden afzonderlijk verstrekt voor elke service. U installeert elke bibliotheek op basis van de Azure-service die u moet gebruiken.

Elk nieuw project met Behulp van Azure moet:

• Azure-resources maken.
• Installeer Azure-clientbibliotheken vanuit een pakketbeheerder, zoals NPM.
• Gebruik beheerde identiteit om te verifiëren met de Azure-clientbibliotheek en gebruik vervolgens configuratiegegevens voor toegang tot specifieke services.

Configuratiegegevens beveiligen

U hebt verschillende opties voor het opslaan van configuratiegegevens:

• Azure Key Vault voor het maken en onderhouden van geheimen, sleutels en certificaten die toegang hebben tot cloudresources, die nog geen beheerde identiteitstoegang bieden.
• Dotenv is een populair NPM-pakket voor het lezen van omgevingsvariabelen uit een .env bestand. Zorg ervoor dat u het .env bestand toevoegt aan het .gitignore bestand, zodat het .env bestand niet is ingecheckt bij broncodebeheer.

Omgevingsvariabelen maken

Als u de Azure-instellingen wilt gebruiken die nodig zijn voor de Azure SDK-bibliotheken voor toegang tot de Azure-cloud, stelt u de meest voorkomende waarden in op omgevingsvariabelen. Met de volgende opdrachten worden de omgevingsvariabelen voor het lokale werkstation ingesteld.

In de volgende voorbeelden is de client-ID de service-principal-ID en het service-principal-geheim.

Bash

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

Cmd

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

Vervang de waarden tussen <> haakjes in deze opdrachten door de waarden van uw specifieke omgevingsvariabele.

Een bestand maken .env

Een ander veelvoorkomend mechanisme is om het DOTENV NPM-pakket te gebruiken om een .env bestand voor deze instellingen te maken. Als u van plan bent om een .env te gebruiken, moet u het bestand toevoegen aan .gitignore, zodat u het bestand niet in de broncontrole incheckt. Voeg het bestand toe aan het .env.ignore git-bestand als standaardmethode om ervoor te zorgen dat deze instellingen worden ingecheckt bij broncodebeheer.

NPM-pakketten installeren

Voor elk project raden we u aan altijd een afzonderlijke map en een eigen package.json bestand te maken met behulp van de volgende stappen:

1. Open een terminal, opdrachtprompt of bash-shell en maak een nieuwe map in het project. Ga vervolgens naar die nieuwe map.

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

2. Initialiseer het pakketbestand:

   npm init -y
   

   Met deze opdracht maakt u het package.json bestand en initialiseert u de minimale eigenschappen.

3. Installeer de Azure-clientbibliotheken die u nodig hebt, zoals dit voorbeeld van de verificatieclientbibliotheek:

   npm install @azure/identity
   

Broncodebeheer gebruiken met Visual Studio Code

U wordt aangeraden om een opslagplaats voor broncodebeheer te maken wanneer u een project start. U kunt dit doen vanuit Visual Studio Code.

1. Selecteer in Visual Studio Code het pictogram voor broncodebeheer om de Broncodebeheerverkenner te openen en selecteer vervolgens Opslagplaats initialiseren om een lokale Git-opslagplaats te initialiseren:

   

2. Nadat de opslagplaats is geïnitialiseerd en u bestanden in broncodebeheer wilt opslaan, voert u het bericht Initial commit in en selecteert u het vinkje om de eerste doorvoering van uw bronbestanden te maken.

   

3. Maak een nieuwe opslagplaats op GitHub en kopieer de URL van de opslagplaats voor de volgende stap.

4. Gebruik in de geïntegreerde Visual Studio-terminal de volgende Git-opdracht om uw externe opslagplaats toe te voegen aan uw lokale opslagplaats. Vervang <YOUR-ACCOUNT> en <REPOSITORY> door uw eigen waarden.

   git remote add origin https://github.com/<YOUR-ACCOUNT>/<REPOSITORY>
   

Visual Studio Code bevat veel ingebouwde Git-functies. Zie Versiebeheer gebruiken in VS Code voor meer informatie.

Volgende stappen

• Een service-principal maken en gebruiken
• Verifiëren met de Azure-modules voor Node.js