Oefening: Een webhook instellen voor een GitHub-opslagplaats

8 minuten

In deze oefening stelt u een webhook in voor een GitHub-opslagplaats. U leert hoe u luistert naar specifieke gebeurtenissen (in dit geval de Gollum-gebeurtenis ) en hoe u de webhook-callback in uw functie maakt wanneer de gebeurtenis wordt geactiveerd.

Instellingen

Meld u met behulp van uw webbrowser aan bij uw GitHub-account.
Maak een nieuwe opslagplaats door Nieuw te selecteren in het linkermenuvenster. De pagina Een nieuwe opslagplaats maken wordt weergegeven.
Voer in het vak Opslagplaatsnaam een betekenisvolle naam in, zoals LearnWebhookTest.
Selecteer Openbaar om uw wikimodule te activeren en zoek deze in het menu.
Klik op Opslagplaats maken. De pagina Snelle instelling wordt weergegeven.
Selecteer de koppeling voor het maken van een nieuw bestand .
Selecteer Wiki in de bovenste menubalk om de pagina's in uw opslagplaats (of opslagplaats) weer te geven. Er wordt een welkomstpagina weergegeven.
Selecteer De eerste pagina maken. De sjabloon Nieuwe pagina maken wordt weergegeven.
Voeg tekst toe en selecteer Pagina opslaan. De eerste pagina in een Wiki is de startpagina.

Een webhook toevoegen voor de Gollum-gebeurtenis

Gollum is de naam van een GitHub-gebeurtenis die wordt geactiveerd wanneer een pagina in de wiki van een opslagplaats wordt gemaakt of bijgewerkt.

Op de startpagina in de wikiweergave bevindt zich een zijbalk Pagina's met een lijst met de pagina's in uw opslagplaats. Selecteer Start om de startpagina weer te geven.
Selecteer Instellingen op de startpagina in de bovenste menubalk. Het deelvenster Instellingen wordt weergegeven.
Selecteer Webhooks in de zijbalk Instellingen. Het deelvenster Webhooks wordt weergegeven.
Selecteer rechtsboven de optie Webhook toevoegen. GitHub kan u vragen uw wachtwoord voor GitHub te bevestigen.

Voer in het deelvenster Webhooks/Webhook toevoegen de volgende waarden in voor elke instelling.

Instelling	Weergegeven als
URL van de nettolading	URL voor uw Azure-functie-app uit de vorige oefening. Zie de volgende opmerking voor hulp.
Inhoudstype	Selecteer toepassing/json in de vervolgkeuzelijst.
Welke gebeurtenissen wilt u deze webhook activeren?	Selecteer Laat me afzonderlijke gebeurtenissen selecteren. Schuif omlaag in de lijst met gebeurtenissen die wordt weergegeven en schakel het selectievakje Wiki in. Zorg ervoor dat er geen andere selectievakjes zijn ingeschakeld.
Actief	Geselecteerd.

Tip

Kopieer de functie-URL vanuit het deelvenster Azure HttpTrigger door functie-URL ophalen te selecteren op de opdrachtbalk. Uw URL ziet er ongeveer als volgt uit: https://<your-functionapp-name>.azurewebsites.net/api/HttpTrigger1?code=aUjXIpqdJ0ZHPQuB0SzFegxGJu0nAXmsQBnmkCpJ6RYxleRaoxJ8cQ==

Selecteer Webhook toevoegen. Het deelvenster Webhooks wordt weergegeven.
Controleer of uw nieuwe webhook wordt weergegeven. Het moet (gollum) aan het einde van zijn naam hebben.

De webhook testen

Selecteer Wiki in GitHub in de bovenste menubalk. De startpagina die u eerder hebt gemaakt, wordt weergegeven.
Selecteer Bewerken. Het deelvenster Start bewerken wordt weergegeven.
Voer in het tekstgebied van het deelvenster de volgende tekst in:
```
Testing Webhook
```
Selecteer Pagina opslaan. De startpagina wordt opnieuw weergegeven.
Selecteer Instellingen in de bovenste menubalk. Het deelvenster Instellingen wordt weergegeven.
Selecteer Webhooks in de zijbalk. Het deelvenster Webhooks wordt weergegeven.
Selecteer Bewerken. Het deelvenster Webhooks/Webhook beheren wordt weergegeven.
Selecteer het tabblad Recente leveringen (mogelijk moet u naar de onderkant van de pagina schuiven).

Selecteer in de lijst de bovenste (meest recente) leveringsvermelding door het beletselteken (...) te selecteren.

U ziet de sectie Kopteksten , met inbegrip van de gebeurtenis:

Request URL: https://testwh123456.azurewebsites.net/api/HttpTrigger1?code=aUjXIpqdJ0ZHPQuB0SzFegxGJu0nAXmsQBnmkCpJ6RYxleRaoxJ8cQ%3D%3D
Request method: POST
Accept: */*
content-type: application/json
User-Agent: GitHub-Hookshot/16496cb
X-GitHub-Delivery: 9ed46280-6ab3-11e9-8a19-f1a14922a239
X-GitHub-Event: gollum
X-GitHub-Hook-ID: 312141005
X-GitHub-Hook-Installation-Target-ID: 394459163
X-GitHub-Hook-Installation-Target-Type: repository

U ziet ook dat de sectie Payload informatie bevat die aangeeft dat uw wikipagina is bewerkt. De nettolading bevat pagina's, opslagplaatsen en afzendersecties , die er ongeveer als volgt uit moeten zien:

    "pages": [
        {
            "page_name": "Home",
            "title": "Home",
            "summary": null,
            "action": "edited",
            "sha": "04d012c5f92a95ae3f7721173bf9f2b1b35ea22f",
            "html_url": "https://github.com/.../wiki/Home"
        }
    ],
    "repository" : {
        "id": 176302421,
        "node_id": "MDEwOlJlcG9zaXRvcnkxNzYzMDI0MjE=",
        "name": "tieredstorage",
        ...
    },
    "sender" : {
        ...
    }

Selecteer op het tabblad Recente leveringen het tabblad Antwoord .

Hier ziet u het antwoordbericht dat wordt gegenereerd door de Azure-functie. In dit voorbeeld moet de hoofdtekst het bericht bevatten. Deze door HTTP geactiveerde functie is uitgevoerd. Geef een naam door in de querytekenreeks of in de aanvraagtekst voor een persoonlijk antwoord.

Oefening: Een webhook instellen voor een GitHub-opslagplaats

Instellingen

Een webhook toevoegen voor de Gollum-gebeurtenis

De webhook testen

Feedback