練習 - 設定 GitHub 存放庫的 Webhook

8 分鐘

在此練習中，您將為 GitHub 存放庫設置一個 Webhook。您將學習如何監聽特定事件，此情況下是 Gollum 事件。您還會學習如何在觸發事件時，在您的函式中設置 Webhook 回呼。

設定

使用網頁瀏覽器登入您的 GitHub 帳戶。
在左側功能表窗格中，選取 [新增] 以建立新的存放庫。 [建立新的存放庫] 頁面隨即出現。
在 [存放庫名稱] 方塊中，輸入有意義的名稱，例如 LearnWebhookTest。
選取 [公用 ] 以啟動您的Wiki模組，並在功能表中尋找它。
選取 [建立存放庫]。 [快速設定] 頁面隨即出現。
選取 [建立新檔案] 連結。
在頂端功能表列，選取 [Wiki] 以顯示存放庫 (或 repo) 中的頁面。 [歡迎] 頁面隨即出現。
選取 [Create the first page] \(建立第一個頁面\)。 [建立新頁面] 範本隨即出現。
新增一些文字，然後選取 [儲存頁面]。 Wiki 中的第一頁是首頁。

新增 Gollum 事件的 Webhook

Gollum 是 GitHub 事件的名稱，每當建立或更新存放庫 Wiki 中的頁面時，就會引發此事件。

在Wiki檢視的首頁上，有一個頁面提要列，列出存放庫中的頁面。選取 [Home] \(首頁\) 以顯示首頁。
在首頁的頂端功能表列中，選取 [Settings] (設定)。 [設定] 窗格隨即出現。
在 [Settings] (設定) 側邊欄中，選取 [Webhooks]。 [Webhooks] 窗格隨即出現。
選取右上角的 [Add webhook] (新增 Webhook)。 GitHub 可能會要求您確認 GitHub 的密碼。

在 [ Webhooks/新增 Webhook ] 窗格上，針對每個設定輸入下列值。

設定	值
承載 URL	您在前一個練習中的 Azure 函數應用程式的 URL。如需說明，請參閱下方附註。
內容類型	從下拉式清單中，選取 [application/json]。
要由哪些事件觸發此 Webhook？	選取 [Let me select individual events] (讓我選取個別事件)。在出現的事件清單中，向下捲動並選取 [Wiki] 核取方塊。請確定沒有選取其他核取方塊。
使用中	已核取。

提示

從命令列選取 [取得函式 URL]，以從 [Azure HttpTrigger] 窗格複製函式 URL。您的 URL 看起來類似：https://<your-functionapp-name>.azurewebsites.net/api/HttpTrigger1?code=aUjXIpqdJ0ZHPQuB0SzFegxGJu0nAXmsQBnmkCpJ6RYxleRaoxJ8cQ==

選取 [新增 Webhook]。 [Webhooks] 窗格隨即出現。
確認新的 Webhook 出現。名稱的結尾應該是 (gollum)。

測試 Webhook

在 GitHub 的頂端功能表列中，選取 [Wiki]。您稍早建立的 [首頁 ] 頁面隨即出現。
選取 [編輯]。 [編輯首頁] 窗格隨即出現。
在窗格的文字區域中，輸入下列文字：
```
Testing Webhook
```
選取 [Save Page] \(儲存頁面\)。 [首頁] 頁面再次出現。
在頂端功能列中，選取 [Settings] (設定)。 [設定] 窗格隨即出現。
在側邊欄中，選取 [Webhooks]。 [Webhooks] 窗格隨即出現。
選取 [編輯]。 [Webhooks/Manage webhook] (Webhook/管理 Webhook) 窗格隨即出現。
選擇您的 Webhook，然後選取最近傳遞索引標籤。

在清單中，選取省略號（...）以選擇最新的交貨項目。

您應該會看到標頭節，包括事件：

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

您也應該看到 Payload 區段包含資訊，指出您的 Wiki 頁面已編輯。承載包含頁面、 存放庫和 寄件者 區段，其看起來應該類似下列範例：

    "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" : {
        ...
    }

在 [最近的傳遞項目] 索引標籤下，選取 [回應] 索引標籤。

您應該會看到 Azure 函式所產生的回應訊息。在此範例中，訊息本文應包含：此 HTTP 觸發的函式已成功執行。請在查詢字串或要求的訊息本文中傳入名稱，以獲得個人化的回應。

練習 - 設定 GitHub 存放庫的 Webhook

設定

新增 Gollum 事件的 Webhook

測試 Webhook

意見反應