Utveckla Azure Functions med hjälp av Visual Studio

Visual Studio är ett sätt att utveckla, testa och distribuera C#-klassbiblioteksfunktioner till Azure. Om den här upplevelsen är din första med Azure Functions kan du läsa Översikt över Azure Functions.

Den här artikeln innehåller detaljerad information om hur du använder Visual Studio för att utveckla C#-klassbiblioteksfunktioner och publicera dem i Azure. Det finns två modeller för att utveckla C#-klassbiblioteksfunktioner: den isolerade arbetsmodellen och den processbaserade modellen.

Om inget annat anges är procedurer och exempel som visas för Visual Studio 2022. Mer information om Visual Studio 2022-versioner finns i viktig information eller viktig information om förhandsversionen.

Förutsättningar

• Visual Studio 2022, inklusive arbetsbelastningen för Azure-utveckling.

• Andra resurser som du behöver, till exempel ett Azure Storage-konto, skapas i din prenumeration under publiceringsprocessen.

• Om du inte har något Azure-konto skapar du ett kostnadsfritt konto innan du börjar.

Skapa ett Azure Functions-projekt

Azure Functions-projektmallen i Visual Studio skapar ett C#-klassbiblioteksprojekt som du kan publicera till en funktionsapp i Azure. Du kan använda en funktionsapp för att gruppera funktioner som en logisk enhet för enklare hantering, distribution, skalning och delning av resurser.

1. På Visual Studio-menyn väljer du Arkiv>Nytt>projekt.

2. I dialogrutan Skapa ett nytt projekt anger du funktioner i sökrutan, väljer Azure Functions-mallen och väljer sedan Nästa.

3. I dialogrutan Konfigurera det nya projektet för Projektnamn anger du ett namn för projektet och väljer sedan Nästa. Funktionsappens namn måste vara ett giltigt C#-namnområde. Du kan inte använda understreck, bindestreck eller andra icke-alfanumeriska tecken.

4. I dialogrutan Ytterligare information vidtar du de åtgärder som anges i följande tabell:

   Inställning	Åtgärd	beskrivning
   Functions Worker	Välj .NET 8.0 Isolerad (långsiktigt stöd).	Visual Studio skapar ett funktionsprojekt som körs i en isolerad arbetsprocess. Den isolerade arbetsprocessen stöder även andra versioner av .NET och .NET Framework som inte erbjuder långsiktig support (LTS). Mer information finns i Översikt över Azure Functions-körningsversioner.
   Function	Välj Http-utlösare.	Visual Studio skapar en funktion som utlöses av en HTTP-begäran.
   Använda Azurite för körningslagringskonto (AzureWebJobsStorage)	Markera den här kryssrutan.	Eftersom en funktionsapp i Azure kräver ett lagringskonto tilldelas eller skapas en när du publicerar projektet till Azure. En HTTP-utlösare använder inte en anslutningssträng för lagringskontot. Alla andra utlösartyper kräver en giltig anslutningssträng för lagringskontot.
   Auktoriseringsnivå	Välj Anonym.	När du använder den här auktoriseringsinställningen kan alla klienter utlösa den skapade funktionen utan att ange en nyckel. Den här konfigurationen gör det enkelt att testa den nya funktionen. Mer information finns i auktoriseringsnivå.

   

   Inställning	Åtgärd	beskrivning
   Functions Worker	Välj .NET 8.0 In-process (Långsiktig support).	Visual Studio skapar ett funktionsprojekt som körs inom processen med version 4.x av Functions-runtimen. Mer information finns i Översikt över Azure Functions-körningsversioner.
   Function	Välj Http-utlösare.	Visual Studio skapar en funktion som utlöses av en HTTP-begäran.
   Använda Azurite för körningslagringskonto (AzureWebJobsStorage)	Markera den här kryssrutan.	Eftersom en funktionsapp i Azure kräver ett lagringskonto tilldelas eller skapas en när du publicerar projektet till Azure. En HTTP-utlösare använder inte en anslutningssträng för lagringskontot. Alla andra utlösartyper kräver en giltig anslutningssträng för lagringskontot.
   Auktoriseringsnivå	Välj Anonym	När du använder den här auktoriseringsinställningen kan alla klienter utlösa den skapade funktionen utan att ange en nyckel. Den här konfigurationen gör det enkelt att testa den nya funktionen. Mer information finns i auktoriseringsnivå.

   

   Se till att du anger auktoriseringsnivån till Anonym. Om du väljer standardnivån funktion måste du presentera funktionsnyckeln i begäranden för att få åtkomst till funktionsslutpunkten.

5. Välj Skapa för att skapa funktionsprojektet och funktionen HTTP-utlösare.

Det nya projektet har följande filer:

• host.json: Den här filen ger dig ett sätt att konfigurera Functions-värden. De här inställningarna gäller både när du kör lokalt och i Azure. Mer information finns i host.json referens.

• local.settings.json: Den här filen har inställningar som du använder när du kör funktioner lokalt. De här inställningarna används inte när din app körs i Azure. Mer information finns i Arbeta med appinställningar lokalt.

  Viktigt!

  Eftersom denlocal.settings.json filen kan innehålla hemligheter måste du undanta den från projektkällans kontroll. I dialogrutan Egenskaper för den här filen kontrollerar du att inställningen Kopiera till utdatakatalog är inställd på Kopiera om den är nyare.

Arbeta med appinställningar lokalt

När funktionsappen körs i Azure lagras de inställningar som krävs av dina funktioner krypterade i appinställningarna. Under den lokala utvecklingen läggs de här inställningarna i stället till i Values samlingen i local.settings.json-filen . Filen local.settings.json lagrar även inställningar som används av lokala utvecklingsverktyg.

Objekt i Values samlingen i projektets local.settings.json-fil är avsedda att spegla objekt i funktionsappens programinställningar i Azure.

Visual Studio laddar inte upp inställningarna automatiskt i local.settings.json när du publicerar projektet. För att se till att de här inställningarna också finns i funktionsappen i Azure laddar du upp dem när du har publicerat projektet. Mer information finns i Funktionsappinställningar. Värdena i en ConnectionStrings samling publiceras inte.

Koden kan också läsa funktionsappens inställningsvärden som miljövariabler. Mer information finns i Miljövariabler.

Konfigurera projektet för lokal utveckling

Functions-körningen använder ett lagringskonto internt. Under utvecklingen kan du använda ett giltigt lagringskonto för det här interna kontot, eller så kan du använda Azurite-emulatorn.

För alla andra utlösartyper än HTTP och webhooks måste du ange värdet Values.AzureWebJobsStorage för nyckeln i filenlocal.settings.json :

• För ett Lagringskonto anger du värdet till anslutningssträngen för ditt lagringskonto.
• För emulatorn anger du värdet till UseDevelopmentStorage=true.

Om du använder emulatorn ändrar du den här inställningen till en anslutningssträng för ett faktiskt lagringskonto före distributionen. Mer information finns i Lokal lagringsemulator.

Utför följande steg för att ange anslutningssträngen för lagringskontot:

1. Logga in på Azure-portalen och gå sedan till ditt lagringskonto.

2. Välj Säkerhets - och>. Under key1 kopierar du värdet för anslutningssträngen .

3. Öppna filenlocal.settings.json i Visual Studio-projektet. Ange värdet för AzureWebJobsStorage nyckeln till anslutningssträngen som du kopierade.

4. Upprepa föregående steg för att lägga till unika nycklar i matrisen Values för andra anslutningar som krävs av dina funktioner.

Lägga till en funktion i projektet

I C#-klassbiblioteksfunktioner definieras de bindningar som funktionerna använder genom att använda attribut i koden. När du skapar funktionsutlösare från de angivna mallarna tillämpas utlösarattributen åt dig.

1. Högerklicka på projektnoden i Solution Explorer och välj Lägg till>ny Azure-funktion.

2. I dialogrutan Lägg till nytt objekt väljer du Azure-funktion och sedan Lägg till.

3. Välj en utlösare och ange sedan de bindningsegenskaper som krävs. Om du väljer en utlösare för lagringstjänsten och vill konfigurera anslutningen markerar du kryssrutan för att konfigurera utlösaranslutningen. I följande exempel visas inställningarna för att skapa en utlösarfunktion för kölagring.

   

4. Välj Lägg till. Om du markerar kryssrutan för att konfigurera en lagringsanslutning i föregående steg visas sidan Anslut till beroende . Välj en Azurite Storage-emulator eller Azure Storage och välj sedan Nästa.

   • Om du väljer en Azurite-lagringsemulator visas sidan Anslut till Lagring Azurite-emulator . Utför följande steg:
     1. Välj Nästa.
     2. På sidan Sammanfattning av ändringar väljer du Slutför. Visual Studio konfigurerar beroendet och skapar utlösarklassen.
   • Om du väljer Azure Storage visas sidan Anslut till Azure Storage . Utför följande steg:
     1. Välj ett lagringskonto och välj sedan Nästa. Visual Studio försöker ansluta till ditt Azure-konto och hämta en slutpunkt.
     2. Välj Nästa.
     3. På sidan Sammanfattning av ändringar väljer du Slutför. Visual Studio konfigurerar beroendet och skapar utlösarklassen.

   Det här utlösarexemplet använder en programinställning för lagringsanslutningen med en nyckel med namnet QueueStorage. Den här nyckeln, som lagras i filenlocal.settings.json, refererar antingen till Azurite-emulatorn eller ett lagringskonto.

5. Granska den nyligen tillagda klassen. Följande C#-klass representerar till exempel en grundläggande utlösarfunktion för kölagring:

   En Run() metod tillskrivs Function. Det här attributet anger att metoden är startpunkten för funktionen.

   using System;
   using Azure.Storage.Queues.Models;
   using Microsoft.Azure.Functions.Worker;
   using Microsoft.Extensions.Logging;
   
   namespace Company.Function;
   
   public class QueueTriggerCSharp
   {
       private readonly ILogger<QueueTriggerCSharp> _logger;
   
       public QueueTriggerCSharp(ILogger<QueueTriggerCSharp> logger)
       {
           _logger = logger;
       }
   
       [Function(nameof(QueueTriggerCSharp))]
       public void Run([QueueTrigger("PathValue", Connection = "ConnectionValue")] QueueMessage message)
       {
           _logger.LogInformation("C# Queue trigger function processed: {messageText}", message.MessageText);
       }
   }
   

   En statisk Run() metod tillskrivs FunctionName. Det här attributet anger att metoden är startpunkten för funktionen.

   using System;
   using Microsoft.Azure.WebJobs;
   using Microsoft.Azure.WebJobs.Host;
   using Microsoft.Extensions.Logging;
   
   namespace Company.Function
   {
       public class QueueTriggerCSharp
       {
           [FunctionName("QueueTriggerCSharp")]
           public void Run([QueueTrigger("PathValue", Connection = "ConnectionValue")]string myQueueItem, ILogger log)
           {
               log.LogInformation($"C# Queue trigger function processed: {myQueueItem}");
           }
       }
   }
   

Ett bindningsspecifikt attribut tillämpas på varje bindningsparameter som tillhandahålls till startpunktsmetoden. Attributet tar bindningsinformationen som parametrar.

I föregående kod har den första parametern ett QueueTrigger attribut som anger en utlösarfunktion för kölagring. Könamnet och namnet på anslutningssträngens inställning överförs som parametrar till attributetQueueTrigger. I din klassrum:

• Parametern könamn ska matcha namnet på kön som du använde i ett tidigare steg för att skapa utlösaren, till exempel myqueue-items.
• Namnet på anslutningssträngsinställningen ska matcha det du använde i ett tidigare steg för att skapa utlösaren, till exempel QueueStorage.

Mer information finns i Azure Queue Storage-utlösare för Azure Functions.

Använd föregående procedur för att lägga till fler funktioner i funktionsappprojektet. Varje funktion i projektet kan ha en annan utlösare, men en funktion måste ha exakt en utlösare. Mer information finns i Azure Functions-utlösare och bindningar.

Lägga till bindningar

Precis som med utlösare läggs indata- och utdatabindningar till i funktionen som bindningsattribut. Utför följande steg för att lägga till bindningar i en funktion:

1. Se till att du konfigurerar projektet för lokal utveckling.

2. Lägg till lämpligt NuGet-tilläggspaket för varje specifik bindning. Bindningsspecifika NuGet-paketkrav finns i referensartikeln för bindningen. För paketkrav för Azure Event Hubs-utlösaren kan du till exempel läsa Utlösare och bindningar för Azure Event Hubs för Azure Functions.

3. Använd följande kommando i Package Manager-konsolen för att installera ett specifikt paket:

   Install-Package Microsoft.Azure.Functions.Worker.Extensions.<BINDING_TYPE> -Version <TARGET_VERSION>
   

   Install-Package Microsoft.Azure.WebJobs.Extensions.<BINDING_TYPE> -Version <TARGET_VERSION>
   

   I den här koden ersätter du <BINDING_TYPE> med det specifika namnet på bindningstillägget och ersätter <TARGET_VERSION> med en specifik version av paketet, till exempel 4.0.0. Giltiga versioner visas på de enskilda paketsidorna på NuGet.org.

4. Om det finns appinställningar som bindningen behöver lägger du till Values dem i samlingen i den lokala inställningsfilen.

   Funktionen använder dessa värden när den körs lokalt. När funktionen körs i funktionsappen i Azure använder den inställningarna för funktionsappen. Visual Studio gör det enkelt att publicera lokala inställningar till Azure.

5. Lägg till lämpligt bindningsattribut i metodsignaturen. I följande kod utlöser Run ett kömeddelande funktionen. Utdatabindningen skapar sedan ett nytt kömeddelande med samma text i en annan kö.

    public class QueueTrigger
   {
       private readonly ILogger _logger;
   
       public QueueTrigger(ILoggerFactory loggerFactory)
       {
           _logger = loggerFactory.CreateLogger<QueueTrigger>();
       }
   
       [Function("CopyQueueMessage")]
       [QueueOutput("myqueue-items-destination", Connection = "QueueStorage")]
       public string Run([QueueTrigger("myqueue-items-source", Connection = "QueueStorage")] string myQueueItem)
       {
           _logger.LogInformation($"C# Queue trigger function processed: {myQueueItem}");
           return myQueueItem;
       }
   }
   

   Attributet QueueOutput definierar bindningen för metoden. För flera utdatabindningar placerar du i stället det här attributet på en strängegenskap för det returnerade objektet. Mer information finns i Flera utdatabindningar.

   public static class SimpleExampleWithOutput
   {
       [FunctionName("CopyQueueMessage")]
       public static void Run(
           [QueueTrigger("myqueue-items-source", Connection = "QueueStorage")] string myQueueItem, 
           [Queue("myqueue-items-destination", Connection = "QueueStorage")] out string myQueueItemCopy,
           ILogger log)
       {
           log.LogInformation($"CopyQueueMessage function processed: {myQueueItem}");
           myQueueItemCopy = myQueueItem;
       }
   }
   

   Attributet Queue för parametern out definierar utdatabindningen.

   Anslutningen till Queue Storage hämtas från inställningen QueueStorage . Mer information finns i referensartikeln för den specifika bindningen.

En fullständig lista över bindningar som stöds av Functions finns i Bindningar som stöds. Ett mer komplett exempel på det här scenariot finns i Ansluta funktioner till Azure Storage med Visual Studio.

Köra funktioner lokalt

Du kan använda Azure Functions Core Tools för att köra Functions-projekt på din lokala utvecklingsdator. När du väljer F5 för att felsöka ett Functions-projekt börjar den lokala Functions-värden (func.exe) lyssna på en lokal port (vanligtvis 7071). Alla anropsbara funktionsslutpunkter skrivs till utdata och du kan använda dessa slutpunkter för att testa dina funktioner. Mer information finns i Utveckla Azure Functions lokalt med core tools. Du uppmanas att installera dessa verktyg första gången du startar en funktion från Visual Studio.

Utför följande steg för att starta funktionen i Visual Studio i felsökningsläge:

1. Välj F5. Om du uppmanas att göra det godkänner du begäran från Visual Studio om att ladda ned och installera Azure Functions Core Tools. Du kan också behöva aktivera ett brandväggsundantag så att verktygen kan hantera HTTP-begäranden.

2. När projektet körs testar du koden på samma sätt som du testar en distribuerad funktion.

   När du kör Visual Studio i felsökningsläge träffas brytpunkter som förväntat.

Publicera till Azure

När du publicerar ditt Functions-projekt i Azure använder Visual Studio zip-distribution för att distribuera projektfilerna. När det är möjligt bör du också välja Kör från paketfilen så att projektet körs i distributionspaketet (.zip). Mer information finns i Köra dina funktioner från en paketfil i Azure.

Distribuera inte till Functions med hjälp av Web Deploy (msdeploy).

Följ stegen nedan för att publicera projektet till en funktionsapp i Azure:

1. Högerklicka på projektet i Solution Explorer och välj sedan Publicera.

2. Gör följande val på sidan Publicera :

   • På Mål väljer du Azure och sedan Nästa.
   • På Specifikt mål väljer du Azure-funktionsapp och sedan Nästa.
   • På Functions-instansen väljer du Skapa ny.

   

3. Skapa en ny instans med hjälp av de värden som anges i följande tabell:

   Inställning	Värde	beskrivning
   Namn	Ett globalt unikt namn	Namnet måste unikt identifiera din nya funktionsapp. Acceptera det föreslagna namnet eller ange ett nytt namn. Följande tecken är giltiga: a-z, 0-9och -.
   Prenumerationsnamn	Namnet på din prenumeration	Funktionsappen skapas i en Azure-prenumeration. Acceptera standardprenumerationen eller välj en annan från listan.
   Resursgrupp	Namnet på resursgruppen	Funktionsappen skapas i en resursgrupp. Välj Ny för att skapa en ny resursgrupp. Du kan också välja en befintlig resursgrupp i listan.
   Plantyp	Flexförbrukning	När du publicerar projektet till en funktionsapp som körs i en Flex Consumption-plan kan det hända att du endast betalar för exekveringarna av din funktionsapp. Andra värdplaner kan medföra högre kostnader. VIKTIGT: När du skapar en Flex Consumption-plan måste du först välja App Service-plan och sedan välja Flex Consumption igen för att rensa ett problem med dialogrutan.
   Operativsystem	Linux	Flex Consumption-planen kräver för närvarande Linux.
   Plats	Platsen för apptjänsten	Välj en plats i en Azure-region som stöds av Flex Consumption-planen. När du väljer en region som inte stöds är knappen Skapa nedtonad.
   Instansminnesstorlek	2048	Minnesstorleken för de virtuella datorinstanser där appen körs är unik för Flex Consumption-planen.
   Azure Storage	Ett allmänt lagringskonto	Functions-körningen kräver ett lagringskonto. Välj Ny för att konfigurera ett allmänt lagringskonto. Du kan också använda ett befintligt konto som uppfyller kraven för lagringskontot.
   Application Insights	En Application Insights-instans	Du bör aktivera Application Insights-integrering för din funktionsapp. Välj Ny för att skapa en ny instans, antingen i en ny eller i en befintlig Log Analytics-arbetsyta. Du kan också använda en befintlig instans.

   

4. Välj Skapa för att skapa en funktionsapp och dess relaterade resurser i Azure. Statusen för resursskapande visas i det nedre vänstra hörnet i fönstret.

5. Välj Slutför. Fönstret för profilskapandets publiceringsförlopp visas. När profilen har skapats väljer du Stäng.

6. På sidan Publicera profil väljer du Publicera för att distribuera paketet som innehåller dina projektfiler till din nya funktionsapp i Azure.

   När distributionen är klar visas rot-URL:en för funktionsappen i Azure på publiceringsprofilsidan.

7. På sidan Publicera profil går du till avsnittet Värd . Välj ellipsen (...) och välj sedan Öppna i Azure-portalen. Den nya funktionsappens Azure-resurs öppnas i Azure Portal.

   

Funktionsappinställningar

Visual Studio laddar inte upp appinställningar automatiskt när du publicerar projektet. Om du lägger till inställningar i local.settings.json-filen måste du också lägga till dem i funktionsappen i Azure.

Det enklaste sättet att ladda upp de inställningar som krävs till funktionsappen i Azure är att hantera dem i Visual Studio. På sidan Publicera profil går du till avsnittet Värd . Välj ellipsen (...) och välj sedan Hantera Azure App Service-inställningar.

När du gör valet öppnas dialogrutan Programinställningar för funktionsappen. Du kan använda den här dialogrutan för att lägga till programinställningar eller ändra befintliga.

För varje inställning är det lokala värdet värdet i filenlocal.settings.json och fjärrvärdet är värdet i funktionsappen i Azure.

• Om du vill skapa en appinställning väljer du Lägg till inställning.
• Om du vill kopiera ett inställningsvärde från fältet Lokalt till fältet Fjärr väljer du Infoga värde från Lokalt.

Väntande ändringar skrivs till den lokala inställningsfilen och funktionsappen när du väljer OK.

Du kan också hantera programinställningar på något av följande sätt:

• Använd Azure-portalen.
• Använd publiceringsalternativet--publish-local-settings i Azure Functions Core Tools.
• Använd Azure CLI.

Fjärrfelsökning

Om du vill felsöka funktionsappen via fjärranslutning måste du publicera en felsökningskonfiguration för projektet. Du måste också aktivera fjärrfelsökning i funktionsappen i Azure.

Det här avsnittet förutsätter att en felsökningskonfiguration för funktionsappen publiceras.

Överväganden för fjärrfelsökning

• Fjärrfelsökning rekommenderas inte för en produktionstjänst.
• Om du vill använda fjärrfelsökning måste du vara värd för funktionsappen i en Premium- eller App Service-plan.
• Fjärrfelsökning stöds för närvarande endast när du kör C#-appen i Windows.
• Om funktionen Just My Code är aktiverad i Visual Studio inaktiverar du den. Anvisningar finns i Aktivera eller inaktivera Just My Code.
• Undvik långa stopp vid brytpunkter när du använder fjärrfelsökning. När en process stoppas i mer än några minuter behandlar Azure den som en process som inte svarar och stänger av den.
• När du felsöker skickar servern data till Visual Studio, vilket kan påverka bandbreddsavgifterna. Information om bandbreddspriser finns i Priskalkylatorn.
• Fjärrfelsökning inaktiveras automatiskt i funktionsappen efter 48 timmar. Därefter måste du aktivera fjärrfelsökning igen.

Bifoga felsökningsprogrammet

När du är klar med felsökningen bör du inaktivera fjärrfelsökning.

Inaktivera fjärrfelsökning

När du har slutfört fjärrfelsökningen av koden bör du inaktivera fjärrfelsökning i Azure-portalen. Fjärrfelsökning inaktiveras automatiskt efter 48 timmar, om du glömmer det.

1. På sidan Publicera profil går du till avsnittet Värd . Välj ellipsen (...) och välj sedan Öppna i Azure-portalen. Azure-portalen öppnas för funktionsappen som ditt projekt distribueras till.

2. I funktionsappen väljer du Inställningar>Konfiguration och går sedan till fliken Allmänna inställningar . Bredvid Fjärrfelsökning väljer du Av. Välj Spara och välj sedan Fortsätt.

När funktionsappen har startats om kan du inte längre fjärransluta till dina fjärrprocesser. Du kan använda samma flik i Azure-portalen för att aktivera fjärrfelsökning utanför Visual Studio.

Övervaka funktioner

Det rekommenderade sättet att övervaka dina funktioner är genom att integrera funktionsappen med Application Insights. Du bör aktivera den här integreringen när du skapar din funktionsapp under Visual Studio-publicering.

Om integreringen inte har konfigurerats under publiceringen av någon anledning bör du fortfarande aktivera Application Insights-integrering för funktionsappen i Azure.

Mer information om hur du använder Application Insights för övervakning finns i Övervaka körningar i Azure Functions.

Relaterat innehåll

• Utveckla Azure Functions lokalt med core tools