Snabbstart: Skapa en C#-funktion i Azure med Visual Studio Code

  • Artikel
  • 7 minuter för att läsa

I den här artikeln använder du Visual Studio Code för att skapa en C#-funktion som svarar på HTTP-begäranden. När du har testat koden lokalt distribuerar du den till den serverlösa Azure Functions.

Den här artikeln stöder skapande av båda typerna av kompilerade C#-funktioner:

Körningsmodell Description
Pågår Funktionskoden körs i samma process som Functions-värdprocessen. Stöder både .NET Core 3.1 och .NET 6.0. Mer information finns i Utveckla C#-klassbiblioteksfunktioner med hjälp av Azure Functions.
Isolerad process Funktionskoden körs i en separat .NET-arbetsprocess. Stöder både .NET 5.0 och .NET 6.0. Mer information finns i Utveckla isolerade processfunktioner i C#.

Den här artikeln skapar en HTTP-utlöst funktion som körs på .NET 6.0. Det finns också en CLI-baserad version av den här artikeln.

Den här snabbstarten medför en liten kostnad på några cent eller mindre för ditt Azure-konto.

Konfigurera din miljö

Kontrollera att du har följande krav på plats innan du börjar:

Du behöver också ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.

Skapa ditt lokala projekt

I det här avsnittet använder du Visual Studio Code för att skapa ett lokalt Azure Functions-projekt i C#. Senare i den här artikeln ska du publicera funktionskoden till Azure.

  1. Välj Azure-ikonen i Aktivitetsfältet och gör sedan följande i Azure: I området för funktioner väljer du ikonen Skapa nytt projekt....

    Välj Skapa ett nytt projekt

  2. Välj en katalogplats för projektarbetsytan och välj Välj.

    Anteckning

    De här stegen har utformats för att utföras utanför en arbetsyta. Välj i det här fallet inte en projektmapp som ingår i en arbetsyta.

  3. Ange följande information i meddelanderutorna:

    Prompt Urval
    Välj ett språk för funktionsprojektet Välj C#.
    Välj en .NET-körning Välj .NET 6.
    Välj en mall för projektets första funktion Välj HTTP trigger.
    Ange ett funktionsnamn Skriv HttpExample.
    Ange ett namnområde Skriv My.Functions.
    Auktoriseringsnivå Välj Anonymous , vilket gör att vem som helst kan anropa funktionsslutpunkten. Mer information om auktoriseringsnivå finns i Auktoriseringsnycklar.
    Välj hur du vill öppna projektet Välj Add to workspace.

    Anteckning

    Om du inte ser .NET 6 som ett körningsalternativ kontrollerar du följande:

    • Kontrollera att du har installerat .NET 6.0 SDK.
    • Tryck på F1 och Preferences: Open user settings skriv och sök sedan efter och ändra Azure Functions: Project Runtime standardkörningsversionen till ~4 .

  4. Med den här informationen Visual Studio Code ett Azure Functions med en HTTP-utlösare. Du kan visa de lokala projektfilerna i Utforskaren. Mer information om filer som skapas finns i Genererade projektfiler.

Köra funktionen lokalt

Visual Studio Koden integreras med Azure Functions Core-verktyg så att du kan köra det här projektet på din lokala utvecklingsdator innan du publicerar till Azure.

  1. Du anropar funktionen genom att trycka på F5 för att starta funktionsappsprojektet. Utdata från Core Tools visas på panelen Terminal. Din app startar i terminalpanelen. Du kan se URL-slutpunkten för den HTTP-utlösta funktionen som körs lokalt.

    Vs Code-utdata för lokal funktion

    Om du har problem med att Windows på en dator kontrollerar du att standardterminalen för Visual Studio Code inte är inställd på WSL Bash.

  2. När Core Tools är igång går du till området Azure: Funktioner. Under Funktioner expanderar du Lokal Project > Functions. Högerklicka (välj Windows) eller Ctrl - klicka (macOS) på HttpExample funktionen och välj Kör funktion nu....

    Kör funktionen nu från Visual Studio Code

  3. I Enter request body (Ange begärandetext) trycker du på Retur för att skicka ett meddelande om begäran till funktionen.

  4. När funktionen körs lokalt och returnerar ett svar utlöses ett meddelande i Visual Studio Code. Information om funktionskörningen visas i terminalpanelen.

  5. Tryck på Ctrl + C för att stoppa Core Tools och koppla från felsökningsprogrammet.

När du har kontrollerat att funktionen körs korrekt på den lokala datorn är det dags att använda Visual Studio Code för att publicera projektet direkt till Azure.

Logga in på Azure

Innan du kan publicera appen måste du logga in på Azure.

  1. Om du inte redan är inloggad väljer du Azure-ikonen i aktivitets fältet och väljer sedan Logga in på Azure i avsnittet Azure: Functions . Om du inte redan har en, kan du skapa ett kostnads fritt Azure-konto. Studenter kan skapa ett kostnads fritt Azure-konto för studenter.

    Logga in på Azure i VS Code

    Om du redan är inloggad går du till nästa avsnitt.

  2. När du uppmanas till webbläsaren väljer du ditt Azure-konto och loggar in med dina autentiseringsuppgifter för Azure-kontot.

  3. När du har loggat in kan du stänga det nya webbläsarfönstret. De prenumerationer som tillhör ditt Azure-konto visas i sido fältet.

Publicera projektet på Azure

I det här avsnittet ska du skapa en Function-app och relaterade resurser i din Azure-prenumeration och sedan distribuera din kod.

Viktigt

Om du publicerar till en befintlig funktionsapp skrivs innehållet i den appen över i Azure.

  1. Välj Azure-ikonen i aktivitets fältet och välj sedan knappen distribuera till Function-appen i avsnittet Azure: functions.

    Publicera projektet till Azure

  2. Ange följande information i meddelanderutorna:

    • Välj mapp: Välj en mapp från din arbets yta eller bläddra till en mapp som innehåller din Function-app. Du ser inte det här om du redan har en giltig Function-app öppen.

    • Välj prenumeration: Välj den prenumeration som ska användas. Du ser inte det här om du bara har en prenumeration.

    • Välj Funktionsapp i Azure: Välj - Create new Function App. (Välj inte Advanced alternativet, som inte beskrivs i den här artikeln.)

    • Ange ett globalt unikt namn för Function-appen: Ange ett namn som är giltigt i en URL-sökväg. Namnet du skriver verifieras för att säkerställa att det är unikt i Azure Functions.

    • Välj en plats för nya resurser: om du vill ha bättre prestanda väljer du en region nära dig.

    Tillägget visar status för enskilda resurser när de skapas i Azure i meddelande fältet.

    Meddelande om skapande av Azure-resurs

  3. När det är slutfört skapas följande Azure-resurser i din prenumeration med hjälp av namn baserat på ditt funktions program namn:

    • En resurs grupp, som är en logisk behållare för relaterade resurser.
    • Ett standard Azure Storage-kontosom upprätthåller tillstånd och annan information om dina projekt.
    • En förbruknings plan som definierar den underliggande värden för din server lös Function-app.
    • En Function-app som tillhandahåller miljön för att köra funktions koden. Med en Function-app kan du gruppera funktioner som en logisk enhet för enklare hantering, distribution och delning av resurser inom samma värd plan.
    • En Application Insights instans som är ansluten till Function-appen, som spårar användningen av din server lös funktion.

    Ett meddelande visas när funktionsappen har skapats och distributionspaketet har tillämpats.

    Tips

    Som standard skapas de Azure-resurser som krävs av din Function-app baserat på namnet på den Function-app som du anger. Som standard skapas de också i samma nya resurs grupp med Function-appen. Om du antingen vill anpassa namnen på dessa resurser eller återanvända befintliga resurser måste du i stället publicera projektet med avancerade alternativ för att skapa.

  4. Välj Visa utdata i det här meddelandet för att Visa skapande-och distributions resultaten, inklusive de Azure-resurser som du har skapat. Om du saknar meddelandet väljer du klock ikonen i det nedre högra hörnet för att se den igen.

    Skapa fullständig avisering

Kör funktionen i Azure

  1. Gå tillbaka till avsnittet Azure: Functions i sido fältet, expandera din prenumeration, din nya Function-app och functions. Högerklicka (Windows) eller CTRL- klicka (MacOS) på HttpExample funktionen och välj Kör funktion nu....

    Kör funktionen nu i Azure från Visual Studio Code

  2. I Ange brödtext för begäran visas bröd texten för begär ande meddelandet { "name": "Azure" } . Skicka meddelandet till din funktion genom att trycka på RETUR.

  3. När funktionen körs i Azure och returnerar ett svar, aktive ras ett meddelande i Visual Studio Code.

Rensa resurser

När du fortsätter till Nästa steg och lägger till en Azure Storage Queue-bindning till din funktion måste du hålla alla dina resurser på plats för att bygga vidare på det du redan har gjort.

Annars kan du använda följande steg för att ta bort Function-appen och dess relaterade resurser för att undvika ytterligare kostnader.

  1. I Visual Studio Code, trycker du på F1 för att öppna kommando paletten. I paletten kommando söker du efter och väljer Azure Functions: Open in portal .

  2. Välj Function-appen och tryck på RETUR. Sidan Function-appen öppnas i Azure Portal.

  3. På fliken Översikt väljer du den namngivna länken bredvid resurs grupp.

    Välj den resursgrupp som du vill ta bort från sidan för funktionsappar.

  4. Granska listan över resurser som ingår och verifiera att det är dem som du vill ta bort på sidan Resursgrupp.

  5. Välj Ta bort resursgrupp och följ instruktionerna.

    Borttagningen kan ta några minuter. När du är färdig visas ett meddelande i några sekunder. Du kan även välja klockikonen längst upp på sidan för att se meddelandet.

Mer information om funktions kostnader finns i uppskatta förbruknings plan kostnader.

Nästa steg

Du har använt Visual Studio Code för att skapa en funktionsapp med en enkel HTTP-utlöst funktion. I nästa artikel expanderar du funktionen genom att ansluta till antingen Azure Cosmos DB eller Azure Queue Storage. Mer information om hur du ansluter till andra Azure-tjänster finns i Lägga till bindningar till en befintlig funktion i Azure Functions.