Azure Functions ontwikkelen met Visual Studio Code

Met Azure Functions-extensie voor Visual Studio Code kunt u lokaal functies ontwikkelen en deze implementeren in Azure. Als deze ervaring uw eerste ervaring is met Azure Functions, kunt u meer informatie krijgen op Een inleiding tot Azure Functions.

De Azure Functions-extensie biedt de volgende voordelen:

  • Bewerk, bouw en voer functies uit op uw lokale ontwikkelcomputer.
  • Publiceer uw Azure Functions project rechtstreeks naar Azure.
  • Schrijf uw functies in verschillende talen en profiteer van de voordelen van Visual Studio Code.

De extensie kan worden gebruikt met de volgende talen, die worden ondersteund door de Azure Functions runtime vanaf versie 2.x:

*Hiervoor moet u het C#-script instellen als de standaardprojecttaal.

In dit artikel zijn voorbeelden momenteel alleen beschikbaar voor JavaScript-functies (Node.js) en C#-klassebibliotheekfuncties.

In dit artikel vindt u meer informatie over het gebruik van de Azure Functions extensie om functies te ontwikkelen en deze te publiceren naar Azure. Voordat u dit artikel leest, moet u uw eerste functie maken met behulp van Visual Studio Code.

Belangrijk

Combineer geen lokale ontwikkeling en portalontwikkeling voor één functie-app. Wanneer u vanuit een lokaal project publiceert naar een functie-app, overschrijft het implementatieproces alle functies die u in de portal hebt ontwikkeld.

Vereisten

Voordat u de []extensie Azure Functions Azure Functions voor Visual Studio[Code]installeert en uit te voeren, moet u aan de volgende vereisten voldoen:

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Andere resources die u nodig hebt, zoals een Azure-opslagaccount, worden in uw abonnement gemaakt wanneer u publiceertmet behulp van Visual Studio Code .

Lokale vereisten uitvoeren

Deze vereisten zijn alleen vereist om uw functies lokaal uit te voeren en fouten op te sporen. Ze zijn niet vereist om projecten te maken of te publiceren naar Azure Functions.

  • De Azure Functions Core Tools versie 2.x of hoger. Het pakket Core Tools wordt gedownload en automatisch geïnstalleerd wanneer u het project lokaal start. Core Tools bevat de volledige Azure Functions runtime, dus downloaden en installeren kan enige tijd duren.

  • De C#-extensie voor Visual Studio Code.

  • .NET Core SLI hulpprogramma's.

De Azure Function-extensie installeren

U kunt de extensie Azure Functions gebruiken om functies te maken en te testen en te implementeren in Azure.

  1. Open in Visual Studio Code de optie Extensies en zoek naar Azure-functies of open deze koppeling in Visual Studio Codevscode:extension/ms-azuretools.vscode-azurefunctions.

  2. Selecteer Installeren om de extensie in Visual Studio Code te installeren:

    De extensie voor Azure Functions installeren

  3. Selecteer het pictogram Azure op de activiteitenbalk na de installatie. Het gebied Azure Functions moet nu in de zijbalk worden weergegeven.

    Gebied Azure Functions in de zijbalk

Een Azure Functions-project maken

Met de Functions-extensie kunt u een functie-app-project maken, samen met uw eerste functie. De volgende stappen laten zien hoe u een door HTTP geactiveerde functie maakt in een nieuw Functions-project. HTTP-trigger is de eenvoudigste functietriggersjabloon om te demonstreren.

  1. Selecteer vanuit Azure: Functies het pictogram Functie maken:

    Een functie maken

  2. Selecteer de map voor uw functie-app-project en selecteer vervolgens een taal voor uw functieproject.

  3. Selecteer de sjabloon HTTP-triggerfunctie of u kunt Nu overslaan selecteren om een project zonder functie te maken. U kunt later altijd een functie toevoegen aan uw project.

    De sjabloon voor de HTTP-trigger kiezen

  4. Typ HttpExample als functienaam, selecteer Enter en selecteer vervolgens Functieautorisatie. Voor dit autorisatieniveau moet u een functiesleutel verstrekken wanneer u het functie-eindpunt aanroept.

    Functieautorisatie selecteren

    Er wordt een functie gemaakt in de taal die u hebt gekozen en in de sjabloon voor een door HTTP geactiveerde functie.

    Door HTTP geactiveerde functiesjabloon in Visual Studio Code

Gegenereerde projectbestanden

Met de projectsjabloon maakt u een project in de door u gekozen taal en installeert u de vereiste afhankelijkheden. Voor elke taal heeft het nieuwe project de volgende bestanden:

  • host.js: hiermee kunt u de Functions-host configureren. Deze instellingen zijn van toepassing wanneer u functies lokaal en wanneer u ze in Azure gebruikt. Zie voor meer informatiehost.jsnaslaginformatie.

  • local.settings.js: onderhoudt de instellingen die worden gebruikt wanneer u functies lokaal gebruikt. Deze instellingen worden alleen gebruikt wanneer u functies lokaal gebruikt. Zie Lokaal instellingenbestand voor meer informatie.

    Belangrijk

    Omdat de local.settings.jsbestand geheimen kan bevatten, moet u deze uitsluiten van het broncodebeheer van uw project.

Afhankelijk van uw taal worden deze andere bestanden gemaakt:

Op dit moment kunt u invoer- en uitvoerbindingen toevoegen aan uw functie. U kunt ook een nieuwe functie toevoegen aan uw project.

Binding-extensies installeren

Met uitzondering van HTTP- en timertriggers worden bindingen geïmplementeerd in extensiepakketten. U moet de extensiepakketten installeren voor de triggers en bindingen die ze nodig hebben. Het proces voor het installeren van bindingsextensies is afhankelijk van de taal van uw project.

Voer de dotnet add package-opdracht uit in het terminalvenster om de extensiepakketten te installeren die u nodig hebt in uw project. Met de volgende opdracht wordt de Azure Storage-extensie geïnstalleerd, waarmee bindingen voor Blob-, Queue- en Table-opslag worden geïmplementeerd.

dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage --version 3.0.4

Een functie toevoegen aan uw project

U kunt een nieuwe functie toevoegen aan een bestaand project met behulp van een van de vooraf gedefinieerde Functions-triggersjablonen. Als u een nieuwe functietrigger wilt toevoegen, selecteert u F1 om het opdrachtenpalet te openen. Zoek en voer vervolgens de opdracht uit Azure Functions: Functie maken. Volg de aanwijzingen om uw triggertype te kiezen en de vereiste kenmerken van de trigger te definiëren. Als uw trigger een toegangssleutel of een connection string om verbinding te maken met een service, moet u deze voorbereiden voordat u de functietrigger maakt.

De resultaten van deze actie zijn afhankelijk van de taal van uw project:

Er wordt een nieuw C#-klassebibliotheekbestand (.cs) toegevoegd aan uw project.

Verbinding maken met services

U kunt uw functie verbinden met andere Azure-services door invoer- en uitvoerbindingen toe te voegen. Bindingen verbinden uw functie met andere services zonder dat u de verbindingscode moet schrijven. Het proces voor het toevoegen van bindingen is afhankelijk van de taal van uw project. Zie Concepten van Azure Functions-triggers en -bindingen voor meer informatie over bindingen.

De volgende voorbeelden maken verbinding met een opslagwachtrij met de naam , waarbij de connection string voor het opslagaccount is ingesteld in de outqueue toepassingsinstelling in local.settings.jsop MyStorageConnection .

Werk de functiemethode bij om de volgende parameter toe te voegen aan de Run methodedefinitie:

[Queue("outqueue"),StorageAccount("AzureWebJobsStorage")] ICollector<string> msg,

De parameter msg is een type ICollector<T> die een verzameling berichten vertegenwoordigt die worden geschreven naar een uitvoerbinding wanneer de functie is voltooid. Met de volgende code wordt een bericht toegevoegd aan de verzameling:

// Add a message to the output collection.
msg.Add(string.Format("Name passed to the function: {0}", name));

Berichten worden naar de wachtrij verzonden wanneer de functie is voltooid.

Zie de naslagdocumentatie voor Queue Storage-uitvoerbinding voor meer informatie. Zie Bindingen toevoegen aan een bestaande functie in Azure Functions voor meer algemene informatie over welke bindingen aan een functie kunnen Azure Functions.

Aanmelden bij Azure

Voordat u de app kunt publiceren, moet u zich aanmelden bij Azure.

  1. Als u niet al bent aangemeld, kiest u het Azure-pictogram in de activiteitenbalk en selecteert u vervolgens in het gedeelte Azure: Functions Aanmelden bij Azure... . Hier kunt u een gratis Azure-account maken als u dat nog niet hebt. Studenten kunnen een gratis Azure-account voor studenten maken .

    Aanmelden bij Azure binnen VS Code

    Als u al bent aangemeld, gaat u naar het volgende gedeelte.

  2. Wanneer u hierom wordt gevraagd in de browser, kiest u uw Azure-account en meld u zich aan met uw Azure-accountreferenties.

  3. Nadat u bent aangemeld, kunt u het nieuwe browservenster sluiten. De abonnementen die bij uw Azure-account horen, worden weergegeven in de zijbalk.

Publiceren naar Azure

Visual Studio Met code kunt u uw Functions-project rechtstreeks naar Azure publiceren. In dit proces maakt u een functie-app en de bijbehorende resources in uw Azure-abonnement. De functie-app biedt een context waar u uw functies kunt uitvoeren. Het project wordt in uw Azure-abonnement verpakt en geïmplementeerd in de nieuwe functie-app.

Wanneer u vanuit Visual Studio Code publiceert naar een nieuwe functie-app in Azure, kunt u kiezen voor een snel pad voor het maken van een functie-app met standaardwaarden of een geavanceerd pad, waar u meer controle hebt over de externe resources die zijn gemaakt.

Wanneer u publiceert vanuit Visual Studio Code, profiteert u van de zip-implementatietechnologie.

Snelle functie-app maken

Wanneer u + Nieuwe functie-app maken in Azure... kiest, genereert de extensie automatisch waarden voor de Azure-resources die nodig zijn voor uw functie-app. Deze waarden zijn gebaseerd op de naam van de functie-app die u kiest. Zie het quickstart-artikelover Visual Studio Code voor een voorbeeld van het gebruik van standaardinstellingen om uw project te publiceren naar een nieuwe functie-app in Azure.

Als u expliciete namen wilt verstrekken voor de gemaakte resources, moet u het pad voor geavanceerd maken kiezen.

Een project publiceren naar een nieuwe functie-app in Azure met behulp van geavanceerde opties

Met de volgende stappen publiceert u uw project naar een nieuwe functie-app die is gemaakt met geavanceerde opties voor maken:

  1. Voer in het opdrachtpalet de Azure Functions: Implementeren naar functie-app in.

  2. Als u niet bent aangemeld, wordt u gevraagd om u aan te melden bij Azure. U kunt ook een gratis Azure-account maken. Nadat u zich vanuit de browser aanmeldt, gaat u terug naar Visual Studio Code.

  3. Als u meerdere abonnementen hebt, selecteert u een abonnement voor de functie-app en selecteert u vervolgens + Nieuwe functie-app maken in Azure... Geavanceerd. Met deze optie Geavanceerd hebt u meer controle over de resources die u in Azure maakt.

  4. Geef de volgende informatie op nadat u hier om wordt gevraagd:

    Prompt Waarde Beschrijving
    Functie-app selecteren in Azure Nieuwe functie-app maken in Azure Typ bij de volgende prompt een globaal unieke naam die uw nieuwe functie-app identificeert en selecteer vervolgens Enter. Geldige tekens voor de naam van en functie-app zijn a-z, 0-9 en -.
    Een besturingssysteem selecteren Windows De functie-app wordt uitgevoerd op Windows.
    Een hostingplan selecteren Verbruiksabonnement Er wordt gebruik gemaakt van hosting van een serverloos verbruiksplan.
    Selecteer een runtime voor uw nieuwe app Uw projecttaal De runtime moet overeenkomen met het project dat u publiceert.
    Selecteer een resourcegroep voor nieuwe resources Nieuwe resourcegroep maken Typ bij de volgende prompt de naam van een resourcegroep, zoals myResourceGroup , en selecteer vervolgens Enter. U kunt ook een bestaande resourcegroep selecteren.
    Selecteer een opslagaccount Nieuw opslagaccount maken Typ bij de volgende prompt een wereldwijd unieke naam voor het nieuwe opslagaccount dat wordt gebruikt door uw functie-app en selecteer vervolgens Enter. Storage accountnamen moeten tussen 3 en 24 tekens lang zijn en mogen alleen cijfers en kleine letters bevatten. U kunt ook een bestaand account selecteren.
    Een locatie voor nieuwe resources selecteren regio Selecteer een locatie in een regio bij u in de buurt of in de buurt van andere services die door uw functies worden gebruikt.

    Er wordt een melding weergegeven nadat uw functie-app is gemaakt en het implementatiepakket is toegepast. Selecteer in deze melding de optie Uitvoer weergeven om de resultaten van het maken en implementeren te bekijken, inclusief de Azure-resources die u hebt gemaakt.

De URL van een door HTTP geactiveerde functie in Azure downloaden

Als u een door HTTP geactiveerde functie wilt aanroepen vanuit een client, hebt u de URL van de functie nodig wanneer deze wordt geïmplementeerd in uw functie-app. Deze URL bevat alle vereiste functiesleutels. U kunt de extensie gebruiken om deze URL's voor uw geïmplementeerde functies op te halen. Als u alleen de externe functie in Azure wilt uitvoeren, gebruikt u de functie Execute now van de extensie.

  1. Selecteer F1 om het opdrachtenpalet te openen en zoek en voer vervolgens de opdracht uit Azure Functions: Functie-URL kopiëren.

  2. Volg de aanwijzingen om uw functie-app te selecteren in Azure en vervolgens de specifieke HTTP-trigger die u wilt aanroepen.

De functie-URL wordt gekopieerd naar het klembord, samen met eventuele vereiste sleutels die worden doorgegeven door de code queryparameter. Gebruik een HTTP-hulpprogramma om POST-aanvragen te verzenden of een browser voor GET-aanvragen naar de externe functie.

Wanneer de URL van functies in Azure wordt opgehaald, gebruikt de extensie uw Azure-account om automatisch de sleutels op te halen die nodig zijn om de functie te starten. Meer informatie over functietoegangssleutels. Voor het starten van niet-HTTP-geactiveerde functies is het gebruik van de beheersleutel vereist.

Projectbestanden opnieuw publiceren

Wanneer u continue implementatie in stelt,wordt uw functie-app in Azure bijgewerkt wanneer u bronbestanden bij werkt op de verbonden bronlocatie. We raden continue implementatie aan, maar u kunt de updates van uw projectbestand ook opnieuw publiceren vanuit Visual Studio Code.

Belangrijk

Als u in een bestaande functie-app publiceert, wordt de inhoud van die app in Azure overschreven.

  1. Selecteer F1 in Visual Studio Code om het opdrachtenpalet te openen. In het opdrachtenpalet zoekt en selecteert u Azure Functions: Naar functie-app implementeren.

  2. Als u niet bent aangemeld, wordt u gevraagd om u aan te melden bij Azure. Nadat u zich hebt aangemeld vanuit de browser, gaat u terug naar Visual Studio Code. Als u meerdere abonnementen hebt, selecteert u een abonnement waarin uw functie-app is opgenomen.

  3. Selecteer uw bestaande functie-app in Azure. Wanneer u wordt gewaarschuwd dat alle bestanden in de functie-app worden overschreven, selecteert u Implementeren om de waarschuwing te bevestigen en door te gaan.

Het project wordt opnieuw gemaakt, opnieuw ingepakt en geüpload naar Azure. Het bestaande project wordt vervangen door het nieuwe pakket en de functie-app wordt opnieuw gestart.

Functies uitvoeren

Met Azure Functions-extensie kunt u afzonderlijke functies uitvoeren, in uw project op uw lokale ontwikkelcomputer of in uw Azure-abonnement.

Voor HTTP-triggerfuncties roept de extensie het HTTP-eindpunt aan. Voor andere soorten triggers worden beheerders-API's aanroepen om de functie te starten. De bericht body van de aanvraag die naar de functie wordt verzonden, is afhankelijk van het type trigger. Wanneer een trigger testgegevens vereist, wordt u gevraagd om gegevens in een specifieke JSON-indeling in te voeren.

Functies uitvoeren in Azure

Een functie uitvoeren in Azure vanuit Visual Studio Code.

  1. Voer in het opdrachtpalet de volgende Azure Functions: Functie nu uitvoeren in en kies uw Azure-abonnement.

  2. Kies uw functie-app in Azure in de lijst. Als u uw functie-app niet ziet, moet u ervoor zorgen dat u bent aangemeld bij het juiste abonnement.

  3. Kies de functie die u wilt uitvoeren in de lijst en typ de bericht-body van de aanvraag in Aanvraag body invoeren. Druk op Enter om dit aanvraagbericht naar uw functie te verzenden. De standaardtekst in Aanvraagtekst invoeren moet de indeling van de body aangeven. Als uw functie-app geen functies heeft, wordt er een meldingsfout weergegeven met deze fout.

  4. Wanneer de functie wordt uitgevoerd in Azure en een antwoord retourneert, wordt er een melding in Visual Studio Code.

U kunt uw functie ook uitvoeren vanuit het gebied Azure: Functions door met de rechtermuisknop te klikken (Ctrl+klikken op Mac) op de functie die u wilt uitvoeren vanuit uw functie-app in uw Azure-abonnement en Functie nu uitvoeren te kiezen....

Bij het uitvoeren van functies in Azure gebruikt de extensie uw Azure-account om automatisch de sleutels op te halen die nodig zijn om de functie te starten. Meer informatie over functietoegangssleutels. Voor het starten van niet-HTTP-geactiveerde functies is het gebruik van de beheersleutel vereist.

Functies lokaal uitvoeren

De lokale runtime is dezelfde runtime die als host voor uw functie-app in Azure wordt gebruikt. Lokale instellingen worden gelezen uit delocal.settings.js in het bestand. Als u uw Functions-project lokaal wilt uitvoeren, moet u voldoen aan aanvullende vereisten.

Het project zo configureren dat het lokaal wordt uitgevoerd

De Functions-runtime maakt intern Azure Storage voor alle triggertypen dan HTTP en webhooks. U moet daarom de sleutel Values.AzureWebJobsStorage instellen op een geldig Azure Storage account connection string.

In deze sectie wordt de Azure Storage voor Visual Studio Code met Azure Storage Explorer gebruikt om verbinding te maken met de opslag en de opslag op te connection string.

Het opslagaccount instellen op connection string:

  1. Open Visual Studio Cloud Explorer, vouw Storage Account Uw Storage-account uit en selecteer Vervolgens Eigenschappen en kopieer de waarde primaire > verbindingsreeks.

  2. Open in uw project de local.settings.json file en stel de waarde van de sleutel AzureWebJobsStorage in op de connection string u hebt gekopieerd.

  3. Herhaal de vorige stap om unieke sleutels toe te voegen aan de matrix Waarden voor alle andere verbindingen die vereist zijn voor uw functies.

Zie Lokaal instellingenbestand voor meer informatie.

Lokaal fouten opsporen in functies

Als u fouten in uw functies wilt opsporen, selecteert u F5. Als u Core [Tools]nog niet hebt gedownloadAzure Functions Core Tools, wordt u gevraagd dit te doen. Wanneer Core Tools is geïnstalleerd en wordt uitgevoerd, wordt uitvoer weergegeven in de terminal. Dit is hetzelfde als het uitvoeren van de Core Tools-opdracht vanuit de terminal, maar met extra build-taken en een func host start gekoppeld debugger.

Wanneer het project wordt uitgevoerd, kunt u de functie Nu uitvoeren... van de extensie gebruiken om uw functies te activeren zoals u zou doen wanneer het project in Azure wordt geïmplementeerd. Nu het project wordt uitgevoerd in de foutopsporingsmodus, worden onderbrekingspunten in Visual Studio Code zoals verwacht.

  1. Voer in het opdrachtpalet de volgende Azure Functions: Functie nu uitvoeren in en kies Lokaal project.

  2. Kies de functie die u wilt uitvoeren in uw project en typ de bericht body van de aanvraag in Aanvraag body invoeren. Druk op Enter om dit aanvraagbericht naar uw functie te verzenden. De standaardtekst in Aanvraagtekst invoeren moet de indeling van de body aangeven. Als uw functie-app geen functies heeft, wordt er een meldingsfout weergegeven met deze fout.

  3. Wanneer de functie lokaal wordt uitgevoerd en nadat het antwoord is ontvangen, wordt er een melding in Visual Studio Code. Informatie over de uitvoering van de functie wordt weergegeven in het deelvenster Terminal.

Voor het lokaal uitvoeren van functies is het niet nodig om sleutels te gebruiken.

Lokale instellingen

Bij het uitvoeren in een functie-app in Azure worden de instellingen die door uw functies zijn vereist, veilig opgeslagen in app-instellingen. Tijdens lokale ontwikkeling worden deze instellingen in plaats daarvan toegevoegd aan het Values object in local.settings.json-file. In local.settings.jsbestand worden ook instellingen opgeslagen die worden gebruikt door lokale ontwikkelhulpprogramma's.

Omdat de local.settings.jsop geheimen kan bevatten, zoals verbindingsreeksen, moet u deze nooit opslaan in een externe opslagplaats. Zie Bestand met lokale instellingen voor meer informatie over lokale instellingen.

Standaard worden deze instellingen niet automatisch gemigreerd wanneer het project naar Azure wordt gepubliceerd. Nadat het publiceren is uitgevoerd, krijgt u de optie om instellingen van local.settings.jsnaar uw functie-app in Azure te publiceren. Zie Toepassingsinstellingen publiceren voor meer informatie.

Waarden in ConnectionStrings worden nooit gepubliceerd.

De waarden voor de instellingen van de functietoepassing kunnen ook in uw code worden gelezen als omgevingsvariabelen. Zie de secties Omgevingsvariabelen van deze taalspecifieke referentieartikelen voor meer informatie:

Toepassingsinstellingen in Azure

De instellingen in het local.settings.jsbestand in uw project moeten hetzelfde zijn als de toepassingsinstellingen in de functie-app in Azure. Alle instellingen die u toevoegt aan local.settings.jsu moet ook toevoegen aan de functie-app in Azure. Deze instellingen worden niet automatisch geüpload wanneer u het project publiceert. Op dezelfde manier moeten alle instellingen die u in uw functie-app in de portal maakt, worden gedownload naar uw lokale project.

Toepassingsinstellingen publiceren

De eenvoudigste manier om de vereiste instellingen naar uw functie-app in Azure te publiceren, is door de koppeling Upload instellingen te gebruiken die wordt weergegeven nadat u uw project hebt gepubliceerd:

Upload-toepassingsinstellingen

U kunt instellingen ook publiceren met behulp van de opdracht Azure Functions: Upload lokale instelling in het opdrachtpalet. U kunt afzonderlijke instellingen toevoegen aan toepassingsinstellingen in Azure met behulp van de opdracht Azure Functions: Nieuwe instelling toevoegen.

Tip

Zorg ervoor dat u uw local.settings.jsin het bestand opgeslagen voordat u het publiceert.

Als het lokale bestand is versleuteld, wordt het opnieuw ontsleuteld, gepubliceerd en versleuteld. Als er instellingen zijn met conflicterende waarden op de twee locaties, wordt u gevraagd om te kiezen hoe u wilt doorgaan.

Bekijk bestaande app-instellingen in het gebied Azure: Functions door uw abonnement, uw functie-app en Application Instellingen.

Instellingen voor functie-apps weergeven in Visual Studio Code

Instellingen downloaden van Azure

Als u toepassingsinstellingen in Azure hebt gemaakt, kunt u deze downloaden naar uw local.settings.json-file met behulp van de opdracht Azure Functions: Download Remote Instellingen.

Net als bij het uploaden wordt het lokale bestand, als het is versleuteld, opnieuw ontsleuteld, bijgewerkt en versleuteld. Als er instellingen zijn met conflicterende waarden op de twee locaties, wordt u gevraagd om te kiezen hoe u wilt doorgaan.

Functies bewaken

Wanneer u functies lokaal hebt uitgevoerd,worden logboekgegevens gestreamd naar de Terminal-console. U kunt ook logboekgegevens krijgen wanneer uw Functions-project wordt uitgevoerd in een functie-app in Azure. U kunt verbinding maken met streaminglogboeken in Azure om bijna realtime logboekgegevens te bekijken, of u kunt Application Insights inschakelen voor een vollediger begrip van de werking van uw functie-app.

Streaminglogboeken

Wanneer u een toepassing ontwikkelt, is het vaak handig om logboekregistratiegegevens bijna in realtime te bekijken. U kunt een stroom logboekbestanden weergeven die door uw functies worden gegenereerd. Deze uitvoer is een voorbeeld van streaminglogboeken voor een aanvraag naar een http-geactiveerde functie:

Uitvoer van streaminglogboeken voor HTTP-trigger

Zie Streaminglogboeken voor meer informatie.

Ga als volgt te werkt om de streaminglogboeken voor uw functie-app in Azure in te schakelen:

  1. Selecteer F1 om het opdrachtpalet te openen, zoek naar de opdracht Azure Functions: Start Streaming Logs en voer deze uit .

  2. Selecteer uw functie-app in Azure en selecteer vervolgens Ja om toepassingslogboeken in te schakelen voor de functie-app.

  3. Activeer uw functies in Azure. U ziet dat logboekgegevens worden weergegeven in het uitvoervenster van Visual Studio code.

  4. Als u klaar bent, moet u de opdracht Azure Functions: Stop Streaming Logs uitvoeren om logboekregistratie voor de functie-app uit te schakelen.

Notitie

Streaminglogboeken ondersteunen slechts één exemplaar van de Functions-host. Wanneer uw functie wordt geschaald naar meerdere exemplaren, worden gegevens van andere exemplaren niet weergegeven in de logboekstroom. Live Metrics Stream in Application Insights ondersteunt meerdere exemplaren. Ook in bijna realtime is streaminganalyse gebaseerd op voorbeeldgegevens.

Application Insights

U wordt aangeraden de uitvoering van uw functies te controleren door uw functie-app te integreren met Application Insights. Wanneer u een functie-app in de Azure Portal, vindt deze integratie standaard plaats. Wanneer u uw functie-app maakt tijdens Visual Studio publiceren, moet u Application Insights integreren. Zie Application Insights integration voor meer informatie.

Zie Monitor Insights (Bewaking van Azure Functions) voor meer informatie over bewaking met behulp van Application Azure Functions.

#C-scriptprojecten

Standaard worden alle C#-projecten gemaakt als C#-gecompileerde klassebibliotheekprojecten. Als u liever met C#-scriptprojecten werkt, moet u C#-script selecteren als de standaardtaal in de Azure Functions extensie-instellingen:

  1. Selecteer > Bestandsvoorkeuren > Instellingen.

  2. Ga naar User Instellingen > Extensions > Azure Functions.

  3. Selecteer C#Script in Azure Function: Project Language.

Nadat u deze stappen hebt voltooid, bevatten aanroepen naar de onderliggende Core Tools de optie , waarmee --csx C#-script -projectbestanden (.csx) worden gegenereerd en gepubliceerd. Wanneer u deze standaardtaal hebt opgegeven, worden alle projecten die u maakt standaard ingesteld op C#-scriptprojecten. U wordt niet gevraagd om een projecttaal te kiezen wanneer een standaardinstelling is ingesteld. Als u projecten in andere talen wilt maken, moet u deze instelling wijzigen of verwijderen uit de settings.jsin het bestand. Nadat u deze instelling hebt verwijderd, wordt u opnieuw gevraagd uw taal te kiezen wanneer u een project maakt.

Naslag voor opdrachtenpalet

De Azure Functions biedt een handige grafische interface op het gebied van interactie met uw functie-apps in Azure. Dezelfde functionaliteit is ook beschikbaar als opdrachten in het opdrachtenpalet (F1). Deze Azure Functions zijn beschikbaar:

Azure Functions opdracht Description
Nieuwe Instellingen Hiermee maakt u een nieuwe toepassingsinstelling in Azure. Zie Toepassingsinstellingen publiceren voor meer informatie. Mogelijk moet u deze instelling ook downloaden naar uw lokale instellingen.
Implementatiebron configureren Verbindt uw functie-app in Azure met een lokale Git-opslagplaats. Zie Continue implementatie voorAzure Functions.
Verbinding maken naar GitHub-opslagplaats Verbindt uw functie-app met een GitHub opslagplaats.
Functie-URL kopiëren Haalt de externe URL op van een http-geactiveerde functie die wordt uitgevoerd in Azure. Zie Get the URL of the deployed function (De URL van de geïmplementeerde functie op halen) voor meer informatie.
Functie-app maken in Azure Hiermee maakt u een nieuwe functie-app in uw abonnement in Azure. Zie de sectie over publiceren naar een nieuwe functie-app in Azure voor meer informatie.
Gegevens ontsleutelen Instellingen Ontsleutelt lokale instellingen die zijn versleuteld door Azure Functions: Versleutelen Instellingen.
Functie-app verwijderen Hiermee verwijdert u een functie-app uit uw abonnement in Azure. Als er geen andere apps in het App Service zijn, krijgt u de mogelijkheid om die ook te verwijderen. Andere resources, zoals opslagaccounts en resourcegroepen, worden niet verwijderd. Als u alle resources wilt verwijderen, moet u in plaats daarvan de resourcegroep verwijderen. Uw lokale project wordt niet beïnvloed.
Functie verwijderen Hiermee verwijdert u een bestaande functie uit een functie-app in Azure. Omdat deze verwijdering geen invloed heeft op uw lokale project, kunt u overwegen om de functie lokaal te verwijderen en vervolgens uw project opnieuw te publiceren.
Proxy verwijderen Hiermee verwijdert u Azure Functions proxy van uw functie-app in Azure. Zie Werken met Azure Functions-proxy's voor meer informatie over Azure Functions-proxy's.
Instelling verwijderen Hiermee verwijdert u een functie-app-instelling in Azure. Deze verwijdering heeft geen invloed op de instellingen in uw local.settings.jsbestand.
Verbinding met de repo verbreken Hiermee verwijdert u de continue implementatieverbinding tussen een functie-app in Azure en een opslagplaats voor broncodebeheer.
Externe Instellingen Hiermee downloadt u instellingen van de gekozen functie-app in Azure naar local.settings.json-file. Als het lokale bestand is versleuteld, wordt het opnieuw ontsleuteld, bijgewerkt en versleuteld. Als er instellingen zijn met conflicterende waarden op de twee locaties, wordt u gevraagd om te kiezen hoe u wilt doorgaan. Zorg ervoor dat u wijzigingen in uw local.settings.jsin het bestand opgeslagen voordat u deze opdracht uit te voeren.
Instellingen bewerken Wijzigt de waarde van een bestaande functie-app-instelling in Azure. Deze opdracht heeft geen invloed op de instellingen in uw local.settings.jsbestand.
Instellingen versleutelen Versleutelt afzonderlijke items in de Values matrix in de lokale instellingen. In dit bestand is ook ingesteld op , waarmee wordt aangegeven dat de lokale runtime de instellingen IsEncrypted ontsleutelt voordat deze worden true gebruikt. Versleutel lokale instellingen om het risico op het lekken van waardevolle informatie te verminderen. In Azure worden toepassingsinstellingen altijd versleuteld opgeslagen.
Functie nu uitvoeren Start handmatig een functie met behulp van beheer-API's. Deze opdracht wordt gebruikt voor het lokaal testen tijdens debuggen en voor functies die worden uitgevoerd in Azure. Bij het activeren van een functie in Azure verkrijgt de extensie eerst automatisch een beheersleutel, die wordt gebruikt voor het aanroepen van de externe beheer-API's die functies starten in Azure. De body van het bericht dat naar de API wordt verzonden, is afhankelijk van het type trigger. Voor timertriggers hoeft u geen gegevens door te geven.
Initialiseer Project voor gebruik met VS Code Hiermee voegt u de Visual Studio Code-projectbestanden toe aan een bestaand Functions-project. Gebruik deze opdracht om te werken met een project dat u hebt gemaakt met behulp van Core Tools.
Installatie of update Azure Functions Core Tools Installeert of werkt Azure Functions Core Tools, die wordt gebruikt om functies lokaal uit te voeren.
Opnieuw implementeren Hiermee kunt u projectbestanden vanuit een verbonden Git-opslagplaats opnieuw implementeren naar een specifieke implementatie in Azure. Als u lokale updates opnieuw wilt publiceren vanuit Visual Studio Code, moet u uw project opnieuw publiceren.
Naam van Instellingen Wijzigt de sleutelnaam van een bestaande functie-app-instelling in Azure. Deze opdracht heeft geen invloed op de instellingen in uw local.settings.jsbestand. Nadat u de naam van de instellingen in Azure hebt gewijzigd, moet u deze wijzigingen downloaden naar het lokale project.
Opnieuw starten Start de functie-app opnieuw op in Azure. Als u updates implementeert, wordt ook de functie-app opnieuw gestart.
AzureWebJobsStorage instellen Hiermee stelt u de waarde van de AzureWebJobsStorage toepassingsinstelling in. Deze instelling is vereist voor Azure Functions. Deze wordt ingesteld wanneer een functie-app wordt gemaakt in Azure.
Begin Start een gestopte functie-app in Azure.
Streaminglogboeken starten Start de streaminglogboeken voor de functie-app in Azure. Gebruik streaminglogboeken tijdens het oplossen van externe problemen in Azure als u logboekregistratiegegevens bijna in realtime wilt zien. Zie Streaminglogboeken voor meer informatie.
Stoppen Stopt een functie-app die wordt uitgevoerd in Azure.
Streaminglogboeken stoppen Stopt de streaminglogboeken voor de functie-app in Azure.
In-/uitschakelen als sleufinstelling Wanneer deze optie is ingeschakeld, zorgt ervoor dat een toepassingsinstelling voor een bepaalde implementatiesleuf blijft bestaan.
Installatie van Azure Functions Core Tools Hiermee verwijdert Azure Functions Core Tools, wat vereist is voor de extensie.
Upload Lokale Instellingen Uploadt instellingen van uw local.settings.json-file naar de gekozen functie-app in Azure. Als het lokale bestand is versleuteld, wordt het opnieuw ontsleuteld, geüpload en versleuteld. Als er instellingen zijn met conflicterende waarden op de twee locaties, wordt u gevraagd om te kiezen hoe u wilt doorgaan. Zorg ervoor dat u wijzigingen in uw local.settings.jsin het bestand opgeslagen voordat u deze opdracht uit te voeren.
Commit weergeven in GitHub Toont de meest recente door commit in een specifieke implementatie wanneer uw functie-app is verbonden met een opslagplaats.
Implementatielogboeken weergeven Toont de logboeken voor een specifieke implementatie naar de functie-app in Azure.

Volgende stappen

Zie Werken met Azure Functions Core Tools voor meer informatie over Azure Functions Core Tools.

Zie voor meer informatie over het ontwikkelen van functies als .NET-klassebibliotheken Azure Functions C#-referentie voor ontwikkelaars. Dit artikel bevat ook koppelingen naar voorbeelden van het gebruik van kenmerken om de verschillende typen bindingen te declaren die worden ondersteund door Azure Functions.