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

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

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

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

Det finns också en CLI-baserad version av den här artikeln.

1. Konfigurera din miljö

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

2. Skapa ditt lokala projekt

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

  1. Välj Azure-ikonen i Aktivitetsfälti området Azure: Funktioner väljer du sedan 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:

    • Välj ett språk för ditt funktionsprojekt: Välj C#.

    • 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å: Anonymous Välj , som gör att alla kan anropa din funktionsslutpunkt. Mer information om auktoriseringsnivåer finns i Auktoriseringsnycklar.

    • Välj hur du vill öppna projektet: Välj Add to workspace.

  4. Med den här informationen Visual Studio Code ett Azure Functions projekt med http Utlösa. 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....

    Execute-funktionen nu från Visual Studio Code

  3. I Ange begärandetext visas brödtextvärdet för begärandemeddelandet. { "name": "Azure" } Tryck på Retur för att skicka det här begärandemeddelandet till din funktion.

  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.

5. Publicera projektet i Azure

I det här avsnittet skapar du en funktionsapp och relaterade resurser i din Azure-prenumeration och distribuerar sedan koden.

Viktigt

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

  1. Välj Azure-ikonen i aktivitetsfältet. I området Azure: Funktioner väljer du sedan knappen Distribuera till funktionsapp....

  2. Ange följande information i meddelanderutorna:

    • Välj mapp: Välj en mapp från din arbetsyta eller bläddra till en som innehåller din funktionsapp. Du ser inte detta om du redan har en giltig funktionsapp öppen.

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

    • Välj Funktionsapp i Azure: Välj + Create new Function App. (Välj inte det alternativ Advanced som inte beskrivs i den här artikeln.)

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

    • Välj en plats för nya resurser: Välj en region nära dig för att få bättre prestanda.

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

    Meddelande om skapande av Azure-resurser

  3. När du är klar skapas följande Azure-resurser i din prenumeration med namn som baseras på funktionsappens namn:

    • En resursgrupp, som är en logisk container för relaterade resurser.
    • Ett standardkonto Azure Storage, som upprätthåller tillstånd och annan information om dina projekt.
    • En förbrukningsplan, som definierar den underliggande värden för din serverlösa funktionsapp.
    • En funktionsapp, som tillhandahåller miljön för att köra funktionskoden. Med en funktionsapp kan du gruppera funktioner som en logisk enhet för enklare hantering, distribution och delning av resurser inom samma värdplan.
    • En Application Insights-instans som är ansluten till funktionsappen, som spårar användningen av din serverlösa 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 funktionsappen baserat på funktionsappens namn som du anger. Som standard skapas de också i samma nya resursgrupp med funktionsappen. 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 distributionsresultat, inklusive de Azure-resurser som du skapade. Om du missar meddelandet väljer du klockikonen i det nedre högra hörnet för att se det igen.

    Skapa ett fullständigt meddelande

6. Kör funktionen i Azure

  1. Tillbaka i området Azure: Funktioner i sidofältet expanderar du din prenumeration, din nya funktionsapp och Functions. Högerklicka (välj Windows) eller Ctrl – klicka (macOS) på HttpExample funktionen och välj Kör funktion nu....

    Execute-funktionen nu i Azure från Visual Studio Code

  2. I Ange begärandetext visas brödtextvärdet för begärandemeddelandet. { "name": "Azure" }

    Tryck på Retur för att skicka det här begärandemeddelandet till din funktion.

  3. När funktionen körs i Azure och returnerar ett svar utlöses ett meddelande i Visual Studio Code.

5. Rensa resurser

När du fortsätter till nästa steg och lägger till en Azure Storage köutdatabindning I din funktion måste du ha alla resurser på plats för att kunna bygga vidare på det du redan har gjort.

Annars kan du använda följande steg för att ta bort funktionsappen 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 Functions-kostnader finns i Beräkna förbrukningsplankostnader.

Nästa steg

Du har nu 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 lägga till utdata Bindande. Den här bindningen skriver strängen från HTTP-begäran till ett meddelande i en Azure Queue Storage-kö.

Anslut till en Azure Storage kö