Uw lokale JavaScript-dev-omgeving 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 breder scala 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.

Een een keer een abonnement maken

Azure-resources worden gemaakt binnen een abonnement en resourcegroep.

Een time-time software-installatie

Azure-ontwikkeling met JavaScript op uw lokale werkstation. We raden u aan het volgende te installeren:

Azure-hostingruntime

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

Een een time-configuratie voor verificatie

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

Dezelfde code gebruiken in alle omgevingen:

• Voor lokale ontwikkeling maaktu een service-principal om Azure-resources te maken en te beheren zonder uw persoonlijke account te gebruiken.
• Meer informatie voor azure-hosting.

Werken met Azure en de Azure SDK-clientbibliotheken

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

Elk nieuw project dat Azure gebruikt, moet het volgende doen:

• 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 om sleutels te maken en te onderhouden waarmee u uw cloudbronnen, apps en oplossingen kunt openen en versleutelen.
• Dotenv is een populair npm-pakket voor het lezen van omgevingsvariabelen uit een bestand. Zorg ervoor dat u het .env bestand toevoegt aan het .gitignore bestand, zodat .env het bestand niet wordt 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 de Azure SDK-bibliotheken nodig hebben 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-principalgeheim.

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"

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 die van uw specifieke service-principal.

Bestand .env maken

Een ander veelgebruikt 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 te .env gebruiken, moet .env bij broncodebeheer. Het bestand toevoegen aan het git-bestand is de standaard manier om ervoor te zorgen .env dat deze instellingen worden .ignore ingecheckt bij broncodebeheer.

NPM-pakketten installeren

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

1. Open een terminal, opdrachtprompt of bash-shell en maak een nieuwe map voor 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 een opslagplaats voor broncodebeheer te maken wanneer u een project start. U kunt dit doen vanuit Visual Studio Code.

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

   

2. Nadat de opslagplaats is initialiseerd en u bestanden hebt die u wilt opslaan in broncodebeheer, voert u het bericht in en selecteert u het vinkje om de eerste door te voeren van Initial commit uw bronbestanden.

   

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

4. Gebruik in Visual Studio geïntegreerde 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