Uw lokale JavaScript-ontwikkelomgeving configureren voor Azure

Bij het maken van cloudtoepassingen 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.

Type	Description
Proefabonnement	Maak een gratisproefabonnement.
Bestaand abonnement	Als u al een abonnement hebt, opent u uw bestaande abonnement in Azure Portal, de Azure CLI of Azure SDK's voor JavaScript.
Meerdere abonnementen	Als u meerdere abonnementen wilt beheren, leert u hoe u een beheergroep maakt met JavaScript.

Eenmalige software-installatie

Azure-ontwikkeling met JavaScript op uw lokale werkstation wordt aangeraden het volgende te installeren:

Naam/installatieprogramma	Beschrijving
Node.js LTS	Installeer de meest recente runtime-omgeving voor langetermijnondersteuning (LTS) voor het ontwikkelen van lokale werkstations.
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.

Azure-hostingruntime

Als u van plan bent om een Azure-resource te gebruiken als de hostingomgeving voor uw toepassing, zoals een Azure-web-app of Azure Functions, moet u controleren of de runtimeversie van node.js 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.

Name	Beschrijving
Azure-CLI	Lokale of cloudgebaseerde CLI voor het maken en gebruiken van Azure-resources.
Azure Developer CLI	Het opdrachtregelprogramma voor ontwikkelaars voor het bouwen van cloud-apps in de werkstroom voor ontwikkelaars.
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.

Eenmalige configuratie voor verificatie

Als u dezelfde verificatiecode in lokale ontwikkeling en de externe Azure-hostingomgeving wilt gebruiken, gebruikt u de DefaultAzureCredential.

Een resourcegroep maken voor uw project

Azure-portal

1. Open Azure Portal in een webbrowser.

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

3. Selecteer + Maken.

4. Voer de instellingen voor uw resourcegroep in:

   Eigenschappen	Weergegeven als
   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 + Shift + P.

2. Zoek naar een resourcegroep maken en selecteer deze.

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

   Prompt	Weergegeven als
   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 naamwaarde van een regio dicht bij u in de buurt.

   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 SDK-bibliotheken 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:

• Maak Azure-resources en sla de bijbehorende sleutels of configuratie op een veilige locatie op.
• Installeer Azure SDK-bibliotheken vanuit NPM of Yarn.
• Gebruik uw lokale service-principalreferentie om te verifiëren bij de Azure SDK 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 sleutels die toegang hebben tot en versleutelen van uw cloudresources, apps en oplossingen.
• Dotenv is een populair NPM-pakket voor het lezen van omgevingsvariabelen uit een .env bestand. Zorg ervoor dat u het .env bestand aan het .gitignore bestand toevoegt, zodat het .env bestand niet is ingecheckt bij broncodebeheer. Meer informatie over omgevingsvariabelen in web-apps voor Azure.

Omgevingsvariabelen maken voor de Azure-bibliotheken

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 geheim van de service-principal.

bash

AZURE_SUBSCRIPTION_ID="aa11bb33-cc77-dd88-ee99-0918273645aa"
AZURE_TENANT_ID="00112233-7777-8888-9999-aabbccddeeff"
AZURE_CLIENT_ID="12345678-1111-2222-3333-1234567890ab"
AZURE_CLIENT_SECRET="abcdef00-4444-5555-6666-1234567890ab"

cmd

set AZURE_SUBSCRIPTION_ID="aa11bb33-cc77-dd88-ee99-0918273645aa"
set AZURE_TENANT_ID=00112233-7777-8888-9999-aabbccddeeff
set AZURE_CLIENT_ID=12345678-1111-2222-3333-1234567890ab
set AZURE_CLIENT_SECRET=abcdef00-4444-5555-6666-1234567890ab

Vervang de waarden die in deze opdrachten worden weergegeven door de waarden van uw specifieke service-principal.

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 een .envbestand te gebruiken, moet u het bestand niet inchecken bij broncodebeheer. 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
   

   Hiermee maakt u het bestand package.json en initialiseert u de minimale eigenschappen.

3. Installeer de Azure SDK-bibliotheken die u nodig hebt, zoals in dit voorbeeld:

   npm install @azure/ai-text-analytics@5.0.0
   

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 of Azure DevOps 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-ALIAS en YOUR-REPOSITORY door uw eigen waarden.

   git remote add origin https://github.com/YOUR-ALIAS/YOUR-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