Snabbstart: Skapa en PowerShell-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 PowerShell-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 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.

Konfigurera din miljö

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

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 PowerShell. 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:

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

    • Välj en mall för projektets första funktion: Välj HTTP trigger.

    • Ange ett funktionsnamn: Skriv HttpExample.

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

    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.

Publicera projektet på 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 och välj sedan knappen Distribuera till funktionsapp i området Azure: Functions.

    Publicera projektet till Azure

  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. Som standard distribueras PowerShell-appen till Windows funktionsapp. Om du vill använda Linux-funktionsappen väljer du Advanced alternativet .

    • 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 se till 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 meddelandefältet.

    Meddelande om skapande av Azure-resurser

  3. När du är klar skapas följande Azure-resurser i din prenumeration med hjälp av namn som baseras på funktionsappens 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 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

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 Azure 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.

Anslut till en Azure Storage kö