Övning – Skapa en Azure-funktion som utlöses av en webhook

Slutförd

I den här första övningen ska du skapa din kod för att parsa händelsemeddelanden för GitHub-wiki i Azure Functions. Du konfigurerar din funktion så att den körs när ett webhook-meddelande tas emot.

Skapa en funktionsapp

  1. Logga in på Azure-portalen med ditt MS Learn-konto.

  2. Välj Skapa en resurs. Fönstret Skapa en resurs visas.

  3. I det vänstra menyfönstret, under Kategorier, väljer du Beräkning, och i sökrutan tjänsten Search s och Marketplace söker du efter och väljer Funktionsapp. Fönstret Funktionsapp visas.

  4. Välj Skapa. Fönstret Skapa funktionsapp visas.

  5. På fliken Grundläggande anger du följande värden för varje inställning.

    Kommentar

    Funktionsappens namn måste vara unikt. Vi föreslår att du till exempel använder <ditt namn eller dina initialer>triggerapp. Använd det här namnet vid alla förekomster av <your-functionapp-name> i den här övningen.

    Inställning Värde
    Projektinformation
    Prenumeration Concierge-prenumeration
    Resursgrupp I listrutan väljer du sandbox-resursgruppen [resursgruppsnamn för sandbox-miljö].
    Instansinformation
    Namn på funktionsapp <namnet-på-din-funktionsapp>
    Publicera Kod
    CLR-stack Node.js
    Version Acceptera standard
    Region Välj den plats som är närmast dig och som också är en av de tillåtna Sandbox-regionerna.
    Operativsystem
    Operativsystem Windows
    Värd
    Värdalternativ och planer Förbrukning (serverlös)

    Med den kostnadsfria sandbox-miljön kan du skapa resurser i några av Azures globala regioner. Välj en region från följande lista när du skapar resurser:

    • Västra USA 2
    • USA, södra centrala
    • Central US
    • East US
    • Europa, västra
    • Sydostasien
    • Japan, östra
    • Brasilien, södra
    • Sydöstra Australien
    • Indien, centrala
  6. Välj Nästa: Lagring för att öppna fliken Lagring . Ange följande värden för varje inställning.

    Inställning Värde
    Lagring
    Lagringskonto (Ny) och acceptera standardnamnet.
  7. Välj Granska + skapa.

  8. Azure verifierar dina poster. När du har verifierat väljer du Skapa.

Skapa en webhook-utlöst funktion

  1. När distributionen är klar väljer du Gå till resurs. Fönstret Översikt visas för funktionsappen.

  2. Under Funktioner väljer du Skapa i Azure-portalen.

  3. Fönstret Skapa funktion visas.

  4. Under Välj en mall väljer du HTTP-utlösare och sedan Skapa. Fönstret HttpTrigger1 visas för din funktion och visar väsentligheter för den nya utlösaren.

  5. I det vänstra menyfönstret, under Utvecklare, väljer du Kod + Test. Fönstret Kod + test visas för din funktion och visar JavaScript-filen som skapades från mallen. Det bör se ut som följande kod.

    module.exports = async function (context, req) {
        context.log('JavaScript HTTP trigger function processed a request.');
    
        const name = (req.query.name || (req.body && req.body.name));
        const responseMessage = name
            ? "Hello, " + name + ". This HTTP triggered function executed successfully."
            : "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.";
    
        context.res = {
            // status: 200, /* Defaults to 200 */
            body: responseMessage
        };
    }
    

    Filen index.js är JavaScript-funktionen som genereras av portalen. Begäran läser namn, antingen skickas som en frågesträng eller som en del av begärandetexten och svarar med ett "Hello"-meddelande.

  6. Ovanför koden finns sökvägen med en listruta som visar filnamnet. I listrutan väljer du function.json. JSON-filen som skapades av mallen visas. Det bör se ut som följande kod.

    {
        "bindings": [
            {
                "authLevel": "function",
                "type": "httpTrigger",
                "direction": "in",
                "name": "req",
                "methods": [
                    "get",
                    "post"
                ]
            },
            {
                "type": "http",
                "direction": "out",
                "name": "res"
            }
        ]
    }
    

    JSON-bindningarna anger att funktionen utlöses av HTTP GET- och POST-begäranden riktade mot funktionsappens URL.

Testa att utlösa din funktion

  1. I den översta menyraden väljer du Hämta funktions-URL.

  2. Välj standard i listrutan Nyckel i dialogrutan Hämta funktions-URL. Under Funktionsnyckel väljer du standard. I fältet URL väljer du ikonen Kopiera till Urklipp . URL:en ser ut ungefär så här:

    https://<your-functionapp-name>.azurewebsites.net/api/HttpTrigger1?code=aUjXIpqdJ0ZHPQuB0SzFegxGJu0nAXmsQBnmkCpJ6RYxleRaoxJ8cQ==
    
  3. Klistra in den här URL:en i en webbläsare och lägg till frågesträngsparametern i slutet av URL:en: &name=<yourname>, till exempel &name=Dick och Jane.

  4. Tryck på Retur för att köra begäran. Det svar som returneras av funktionen visas i webbläsaren. Det ser ut ungefär så här:

    Hello Dick and Jane. This HTTP triggered function executed successfully.
    

Klar! Nu har du en funktion som kan utlösas av en URL.