Snabbstart: Skapa en C#-funktion i Azure från kommandoraden

  • Artikel

I den här artikeln använder du kommandoradsverktyg 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 miljön i Azure Functions.

Den här artikeln skapar en HTTP-utlöst funktion som körs på .NET 8 i en isolerad arbetsprocess. Information om .NET-versioner som stöds för C#-funktioner finns i Versioner som stöds. Det finns också en Visual Studio Code-baserad version av den här artikeln.

Slutförande av den här snabbstarten medför en liten kostnad på några USD-cent eller mindre på ditt Azure-konto.

Konfigurera din lokala miljö

Innan du börjar måste du ha följande:

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

Installera Azure Functions Core Tools

Det rekommenderade sättet att installera Core Tools beror på operativsystemet på din lokala utvecklingsdator.

Följande steg använder ett Windows-installationsprogram (MSI) för att installera Core Tools v4.x. Mer information om andra paketbaserade installationsprogram finns i Core Tools readme.

Ladda ned och kör installationsprogrammet för Core Tools baserat på din version av Windows:

Om du tidigare använde Windows-installationsprogrammet (MSI) för att installera Core Tools i Windows bör du avinstallera den gamla versionen från Lägg till Ta bort program innan du installerar den senaste versionen.

Skapa ett lokalt funktionsprojekt

I Azure Functions är ett funktionsprojekt en container för en eller flera enskilda funktioner som var och en svarar på en specifik utlösare. Alla funktioner i ett projekt delar samma lokala konfigurationer och värdkonfigurationer. I det här avsnittet skapar du ett funktionsprojekt som innehåller en enda funktion.

  1. func init Kör kommandot så här för att skapa ett funktionsprojekt i en mapp med namnet LocalFunctionProj med den angivna körningen:

    func init LocalFunctionProj --worker-runtime dotnet-isolated --target-framework net8.0

  2. Navigera till projektmappen:

    cd LocalFunctionProj

    Den här mappen innehåller olika filer för projektet, inklusive konfigurationsfiler med namnet local.settings.json och host.json. Eftersom local.settings.json kan innehålla hemligheter som hämtats från Azure undantas filen som standard från källkontrollen i .gitignore-filen .

  3. Lägg till en funktion i projektet med hjälp av följande kommando, där --name argumentet är det unika namnet på din funktion (HttpExample) och --template argumentet anger funktionens utlösare (HTTP).

    func new --name HttpExample --template "HTTP trigger" --authlevel "anonymous"

    func new skapar en HttpExample.cs kodfil.

(Valfritt) Granska filinnehållet

Om du vill kan du hoppa över till Kör funktionen lokalt och granska filinnehållet senare.

HttpExample.cs

HttpExample.cs innehåller en Run metod som tar emot begärandedata i variabeln req som ett HttpRequest-objekt. Parametern är dekorerad med HttpTriggerAttribute för att definiera utlösarbeteendet.

using System.Net;
using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.Logging;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

namespace Company.Function
{
    public class HttpExample
    {
        private readonly ILogger<HttpExample> _logger;

        public HttpExample(ILogger<HttpExample> logger)
        {
            _logger = logger;
        }

        [Function("HttpExample")]
        public IActionResult Run([HttpTrigger(AuthorizationLevel.AuthLevelValue, "get", "post")] HttpRequest req)
        {            
            _logger.LogInformation("C# HTTP trigger function processed a request.");

            return new OkObjectResult("Welcome to Azure Functions!");
        }
    }
}

Returobjektet är ett IActionResult-objekt som innehåller de data som skickas tillbaka till HTTP-svaret.

Mer information finns i Azure Functions HTTP-utlösare och bindningar.

Kör funktionen lokalt

  1. Kör funktionen genom att starta den lokala Azure Functions-körningsvärden från mappen LocalFunctionProj :

    func start

    Mot slutet av utdata bör följande rader visas:

     ...

 Now listening on: http://0.0.0.0:7071
 Application started. Press Ctrl+C to shut down.

 Http Functions:

         HttpExample: [GET,POST] http://localhost:7071/api/HttpExample
 ...

    Kommentar

    Om HttpExample inte visas som ovan startade du förmodligen värden utanför rotmappen i projektet. I så fall kan du använda Ctrl+C för att stoppa värden, navigera till projektets rotmapp och köra föregående kommando igen.

  2. Kopiera URL:en för din HttpExample funktion från den här utdatan till en webbläsare och bläddra till funktions-URL:en så bör du få meddelandet Välkommen till Azure Functions .

  3. När du är klar använder du Ctrl+C och väljer y att stoppa funktionsvärden.

Skapa stödresurser för Azure-resurser för din funktion

Innan du kan distribuera funktionskoden till Azure måste du skapa tre resurser:

  • En resursgrupp, som är en logisk container för relaterade resurser.
  • Ett lagringskonto som används för att underhålla tillstånd och annan information om dina funktioner.
  • En funktionsapp som tillhandahåller miljön för att köra funktionskoden. En funktionsapp mappar till ditt lokala funktionsprojekt och låter dig gruppera funktioner som en logisk enhet för enklare hantering, distribution och delning av resurser.

Använd följande kommandon för att skapa dessa objekt. Både Azure CLI och PowerShell stöds.

  1. Om du inte redan har gjort det loggar du in på Azure:

    az login

    Kommandot az login loggar in dig på ditt Azure-konto.

  2. Skapa en resursgrupp med namnet AzureFunctionsQuickstart-rg i den valda regionen:

    az group create --name AzureFunctionsQuickstart-rg --location <REGION>

    Kommandot az group create skapar en resursgrupp. I kommandot ovan ersätter <REGION> du med en region nära dig med hjälp av en tillgänglig regionkod som returneras från kommandot az account list-locations .

  3. Skapa ett allmänt lagringskonto i din resursgrupp och region:

    az storage account create --name <STORAGE_NAME> --location <REGION> --resource-group AzureFunctionsQuickstart-rg --sku Standard_LRS --allow-blob-public-access false

    Kommandot az storage account create skapar lagringskontot.

    I föregående exempel ersätter du <STORAGE_NAME> med ett namn som är lämpligt för dig och unikt i Azure Storage. Namn får endast innehålla siffror med tre till 24 tecken och gemener. Standard_LRS anger ett konto för generell användning som stöds av Functions.

Viktigt!

Lagringskontot används för att lagra viktiga appdata, ibland inklusive själva programkoden. Du bör begränsa åtkomsten från andra appar och användare till lagringskontot.

  1. Skapa funktionsappen i Azure:

    az functionapp create --resource-group AzureFunctionsQuickstart-rg --consumption-plan-location <REGION> --runtime dotnet-isolated --functions-version 4 --name <APP_NAME> --storage-account <STORAGE_NAME>

    Kommandot az functionapp create skapar funktionsappen i Azure.

    I föregående exempel ersätter <STORAGE_NAME> du med namnet på det konto som du använde i föregående steg och ersätter <APP_NAME> med ett globalt unikt namn som passar dig. <APP_NAME> är även DNS-standarddomänen för funktionsappen.

    Det här kommandot skapar en funktionsapp som körs i din angivna språkkörning under Azure Functions Consumption Plan, vilket är kostnadsfritt för den mängd användning som du får här. Kommandot skapar också en associerad Azure Application Insights-instans i samma resursgrupp, med vilken du kan övervaka funktionsappen och visa loggar. Mer information finns i Övervaka Azure Functions. Instansen medför inga kostnader förrän du aktiverar den.

Distribuera funktionsprojektet till Azure

När du har skapat funktionsappen i Azure är du nu redo att distribuera ditt lokala funktionsprojekt med hjälp av kommandot func azure functionapp publish .

I följande exempel ersätter du <APP_NAME> med namnet på din app.

func azure functionapp publish <APP_NAME>

Publiceringskommandot visar resultat som liknar följande utdata (trunkerade för enkelhetens skull):

...

Getting site publishing info...
Creating archive for current directory...
Performing remote build for functions project.

...

Deployment successful.
Remote build succeeded!
Syncing triggers...
Functions in msdocs-azurefunctions-qs:
    HttpExample - [httpTrigger]
        Invoke url: https://msdocs-azurefunctions-qs.azurewebsites.net/api/httpexample

Anropa funktionen i Azure

Eftersom funktionen använder en HTTP-utlösare och stöder GET-begäranden anropar du den genom att göra en HTTP-begäran till dess URL. Det är enklast att göra detta i en webbläsare.

Kopiera den fullständiga anropande URL:en som visas i utdata från publiceringskommandot till ett webbläsaradressfält. När du navigerar till den här URL:en bör webbläsaren visa liknande utdata som när du körde funktionen lokalt.

Kör följande kommando för att visa direktuppspelningsloggar i nära realtid:

func azure functionapp logstream <APP_NAME>

I ett separat terminalfönster eller i webbläsaren anropar du fjärrfunktionen igen. En utförlig logg över funktionskörningen i Azure visas i terminalen.

Rensa resurser

Om du fortsätter till nästa steg och lägger till en Azure Storage-köutdatabindning behåller du alla resurser på plats när du bygger vidare på det du redan har gjort.

Annars använder du följande kommando för att ta bort resursgruppen och alla dess inneslutna resurser för att undvika ytterligare kostnader.

az group delete --name AzureFunctionsQuickstart-rg

Nästa steg

Anslut till Azure Cosmos DB

Anslut till Azure Queue Storage