Oefening: een Azure-functie maken die wordt geactiveerd door een webhook

In deze eerste oefening maakt u uw code voor het parseren van de GitHub-wiki-gebeurtenisberichten in Azure Functions. U configureert de functie die moet worden uitgevoerd wanneer een webhookbericht wordt ontvangen.

Een functie-app maken

1. Meld u aan bij Azure Portal met uw Microsoft Learn-account.

2. Klik op Een resource aanmaken. Het deelvenster Een resource maken wordt weergegeven.

3. Selecteer Compute in het linkermenuvenster onder Categorieën, en zoek in het zoekvak voor zoekservices en Marketplace naar functie-app en selecteer deze. Het deelvenster Functie-app wordt weergegeven. Selecteer Maken.

4. Selecteer Verbruik en selecteer vervolgens de knop Selecteren . Het deelvenster Functie-app maken wordt weergegeven.

5. Voer op het tabblad Basisinformatie de volgende waarden in voor elke instelling.

   Notitie

   De naam van de functie-app moet uniek zijn. We raden u aan iets te gebruiken zoals <uw naam of initialen>triggerapp. Gebruik deze naam overal waar u uw functie-app-naam< in deze oefening ziet>.

   Instelling	Waarde
   Projectdetails
   Abonnement	Concierge-abonnement
   Resourcegroep	Selecteer in de vervolgkeuzelijst de sandbox-resourcegroep ,[naam sandbox-resourcegroep].
   Exemplaardetails
   Naam van functie-app	<uw-functieapp-naam>
   Besturingssysteem	Ramen
   Runtimestack	Node.js
   Versie	Standaard accepteren
   Regio	Kies de dichtstbijzijnde locatie die ook een van de toegestane sandbox-regio's is.

   Met de gratis sandbox kunt u resources maken in een subset van de globale Azure-regio's. Selecteer een regio in de volgende lijst wanneer u resources maakt:

   • West VS 2
   • Zuid-Centraal VS
   • Centraal-Verenigde Staten
   • Oost-VS
   • West-Europa

   • Zuidoost-Azië
   • Japan Oost
   • Brazilië - zuid
   • Australië - zuidoost
   • Centraal India

6. Selecteer Volgende: Opslag om het tabblad Opslag te openen. Voer de volgende waarden in voor elke instelling.

   Instelling	Waarde
   Opslag
   Opslagaccount	(Nieuw) en accepteer de standaardnaam.

7. Selecteer Beoordelen en maken.

8. Azure controleert uw vermeldingen. Wanneer dit is geverifieerd, selecteert u Maken.

Een door webhook geactiveerde functie maken

1. Wanneer de implementatie is voltooid, selecteert u Ga naar de resource. Het deelvenster Overzicht wordt weergegeven voor uw functie-app.

2. Selecteer onder Functies in het middelste deelvenster de optie Functie Maken onder Maken in Azure Portal.

3. Het deelvenster Functie maken wordt weergegeven.

4. Selecteer onder Selecteer een sjabloon de HTTP-trigger en selecteer vervolgens Volgende.

5. Accepteer de standaardfunctienaam en het autorisatieniveau. Selecteer Maken. Het deelvenster HttpTrigger1 wordt weergegeven voor uw functie, met essentiële functies voor uw nieuwe trigger.

6. Selecteer Code + Testen bovenaan het venster. Het deelvenster Code en test wordt weergegeven voor uw functie, met daarin het JavaScript-bestand dat is gemaakt op basis van de sjabloon. Deze moet eruitzien als de volgende code.

   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
       };
   }
   

   Het bestandindex.js is de JavaScript-functie die door de portal wordt gegenereerd. Het verzoek leest een naam uit, die ofwel wordt doorgegeven als een querytekenreeks of als onderdeel van de verzoektekst, en reageert met een "Hallo"-bericht.

7. Boven de code bevindt zich het pad met een vervolgkeuzelijst met de bestandsnaam. Selecteer function.jsonin de vervolgkeuzelijst. Het JSON-bestand dat door de sjabloon is gemaakt, wordt weergegeven. Deze moet eruitzien als de volgende code.

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

   De JSON-bindingen geven aan dat de functie wordt geactiveerd door HTTP GET- en POST-aanvragen die zijn gericht op de URL van de functie-app.

Test het activeren van uw functie

1. Selecteer in de bovenste menubalk functie-URL ophalen.

2. Selecteer in het dialoogvenster Get function URL het pictogram Kopiëren naar klembord in het veld Default (Function key). De URL ziet er ongeveer als volgt uit:

   https://<your-functionapp-name>.azurewebsites.net/api/HttpTrigger1?code=aUjXIpqdJ0ZHPQuB0SzFegxGJu0nAXmsQBnmkCpJ6RYxleRaoxJ8cQ==
   

3. Plak deze URL in een browser en voeg aan het einde van de URL de querytekenreeksparameter toe: &name=<uwnaam>, bijvoorbeeld; &name=Dick en Jane.

4. Druk op Enter om de aanvraag uit te voeren. Het antwoord dat door de functie wordt geretourneerd, wordt weergegeven in de browser. Het ziet er ongeveer als volgt uit:

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

Gefeliciteerd! U hebt nu een functie die kan worden geactiveerd door een URL.