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

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

Skapa en funktionsapp

1. Logga in på Azure-portalen med ditt Microsoft 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 Söktjänster och Marketplace söker du efter och väljer Funktionsapp. Funktionsappfönstret visas. Välj Skapa.

4. Välj Förbrukningoch välj sedan knappen Välj. Fönstret Skapa funktionsapp visas.

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

   Anteckning

   Funktionsappens namn måste vara unikt. Vi föreslår att du använder något som <ditt namn eller dina initialer>triggerapp. Använd det här namnet överallt där du ser <din-funktionapp-namn> i denna övning.

   Inställning	Värde
   Projektinformation
   Abonnemang	Concierge-prenumeration
   Resursgrupp	I listrutan väljer du sandbox-resursgruppen [resursgruppsnamn för sandbox-miljö].
   Instansinformation
   Namn på funktionsapp	<din-funktionapp-namn>
   Operativsystem	Windows
   Körningsstack	Node.js
   Utgåva	Acceptera standardinställning
   Region	Välj den närmaste platsen som också är en av de tillåtna sandbox-regionerna.

   Med den kostnadsfria sandbox-miljön kan du skapa resurser i en delmängd av de globala Azure-regionerna. Välj en region i följande lista när du skapar resurser:

   • Västra USA 2
   • Sydcentrala USA
   • Centrala USA
   • Östra USA
   • Europa, västra

   • Sydostasien
   • Japan, östra
   • Södra Brasilien
   • Australien, sydöstra
   • Centrala Indien

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-baserad funktion

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

2. Under Funktioner i mittenfönstret väljer du Skapa funktion under Skapa i Azure-portalen.

3. Fönstret Skapa funktion visas.

4. Under Välj en mall väljer du HTTP-utlösare och sedan Nästa.

5. Acceptera standardfunktionens namn och auktoriseringsnivå. Välj Skapa. Fönstret HttpTrigger1 visas för din funktion och visar väsentligheter för den nya utlösaren.

6. Välj Kod + Test överst i fönstret. 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
       };
   }
   

   Den index.js filen är JavaScript-funktionen som genereras av portalen. Begäran hämtar namnet, antingen angivet som en frågesträng eller som en del av begärandetexten, och svarar med ett "Hello"-meddelande.

7. 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 trigga funktionen

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

2. I dialogrutan Hämta funktions-URL väljer du ikonen Kopiera till Urklipp i fältet Standard (funktionsnyckel ). 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 kommandot. Svaret 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.
   

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