快速入門:使用 Azure 入口網站將 Azure Cache for Redis 事件路由傳送至 Web 端點

Azure Event Grid 是一項雲端事件服務。 在本快速入門中,您將使用 Azure 入口網站,建立Azure Cache for Redis 執行個體、訂閱該執行個體的事件、觸發事件,以及檢視結果。 通常,您會將事件傳送至可處理事件資料及採取行動的端點。 但為簡化本快速入門,您會傳送事件至 Web 應用程式,應用程式會收集並顯示訊息。

如果您沒有 Azure 訂閱,請在開始之前,先建立 Azure 免費帳戶

完成時,您會看到事件資料已傳送至 Web 應用程式。

以 JSON 格式調整的 Azure 事件方格檢視器。

建立 Azure Cache for Redis 快取執行個體

  1. 若要建立快取,請登入 Azure 入口網站,然後選取 [建立資源] 。

    [建立資源] 在左側導覽窗格中反白顯示。

  2. 在 [新增] 頁面上選取 [資料庫] ,然後選取 [Azure Cache for Redis] 。

    在 [新增] 上,[資料庫] 和 [Azure Cache for Redis] 會反白顯示。

  3. 在 [新的 Redis 快取] 頁面上,設定新快取的設定。

    設定 選擇值 描述
    訂用帳戶 下拉並選取您的訂用帳戶。 這個新的 Azure Cache for Redis 執行個體建立所在的訂用帳戶。
    資源群組 下拉並選取資源群組,或選取 [新建] 並輸入新的資源群組名稱。 用來建立快取和其他資源的資源群組名稱。 將所有的應用程式資源放在一個資源群組中,您將可輕鬆地一併管理或刪除這些資源。
    DNS 名稱 輸入唯一名稱。 快取名稱必須為介於 1 到 63 個字元之間的字串,而且只能包含數字、字母或連字號。 名稱的開頭和結尾必須是數字或字母,且不可包含連續的連字號。 快取執行個體的主機名稱將為 <DNS 名稱>.redis.cache.windows.net
    位置 下拉並選取位置。 選取其他將使用快取的服務附近的區域
    快取類型 使用下拉式選單並選取階層 快取的可用大小、效能和功能取決於階層。 如需詳細資訊,請參閱 Azure Cache for Redis 概觀
  4. 選取 [網路] 索引標籤,或選取頁面底部的 [網路] 按鈕。

  5. 在 [網路功能] 索引標籤中,選取您的連線方法。

  6. 選取 [下一步: 進階] 索引標籤,或選取頁面底部的 [下一步: 進階] 按鈕。

  7. 在基本或標準快取執行個體的 [進階] 索引標籤中,如果您想要啟用非 TLS 連接埠,請選取啟用切換。 您也可以選擇要使用 Redis 第 4 版或第 6 版。

    Redis 版本 4 或 6。

  8. 在高階快取執行個體的 [進階] 索引標籤中,設定非 TLS 連接埠、叢集和資料持續性的設定。 您也可以選擇要使用 Redis 第 4 版或第 6 版。

  9. 選取 [下一步:標籤] 索引標籤,或選取頁面底部的 [下一步:標籤] 按鈕。

  10. 在 [標記] 索引標籤中,如果您想要分類資源,可以選擇性地輸入名稱和值。

  11. 選取 [檢閱 + 建立]。 您會移至 [檢閱 + 建立] 索引標籤,其中 Azure 會驗證您的組態。

  12. 出現綠色的「通過驗證」訊息之後,請選取 [建立]。

建立快取需要一些時間。 您可以在 Azure Cache for Redis 的 [概觀] 頁面上監視進度。 當 [狀態] 顯示為 [執行中] 時,表示快取已可供使用。

建立訊息端點

在訂閱快取執行個體的事件之前,讓我們先建立事件訊息的端點。 端點通常會根據事件資料來採取動作。 為了簡化此快速入門,您將部署預建 Web 應用程式,顯示事件訊息。 部署的解決方案包括 App Service 方案、App Service Web 應用程式,以及 GitHub 的原始程式碼。

  1. 在 GitHub README 中選取 [部署至 Azure],將解決方案部署至您的訂用帳戶。

[部署至 Azure] 按鈕。

  1. 在 [自訂部署] 頁面上,執行下列步驟:

    1. 針對 [資源群組],請選取您在建立快取執行個體時所建立的資源群組。 當您完成本教學課程之後,您可以藉由刪除資源群組,更輕鬆地進行清除。
    2. 在 [網站名稱] 輸入 Web 應用程式的名稱。
    3. 在 [裝載方案名稱] 輸入要用來裝載 Web 應用程式的 App Service 方案名稱。
    4. 選取 [我同意上方所述的條款及條件] 核取方塊。
    5. 選取 [購買]。
    設定 建議的值 描述
    訂用帳戶 下拉並選取您的訂用帳戶。 要在其下建立此 Web 應用程式的訂用帳戶。
    資源群組 下拉並選取資源群組,或選取 [新建] 並輸入新的資源群組名稱。 將所有的應用程式資源放在一個資源群組中,您將可輕鬆地一併管理或刪除這些資源。
    網站名稱 輸入 Web 應用程式的名稱。 這個值不能空白。
    主控方案名稱 用來主控 Web 應用程式的 App Service 方案名稱。 這個值不能空白。
  2. 選取入口網站中的警示 (鐘圖示),然後選取 [移至資源群組]。

    Azure 入口網站部署通知。

  3. 在 [資源群組] 頁面上的資源清單中,選取您所建立的 Web 應用程式。 您也會在此清單中看到 App Service 方案和快取執行個體。

  4. 在 Web 應用程式的 [App Service] 頁面上,選取瀏覽至網站的 URL。 URL 應該是此格式:https://<your-site-name>.azurewebsites.net

  5. 確認您看到網站,但其中尚未發佈任何事件。

    空事件方格檢視器網站。

啟用事件格線資源提供者

如果您先前在 Azure 訂用帳戶中從未使用過事件方格,可能必須註冊事件方格資源提供者。

在 Azure 入口網站中:

  1. 選取左側功能表上的 [訂用帳戶] 。
  2. 選取您用於事件方格的訂用帳戶。
  3. 在左側功能表的 [設定] 下,選取 [資源提供者] 。
  4. 尋找 Microsoft.EventGrid
  5. 如果未註冊,請選取 [註冊] 。

可能需要一點時間才能完成註冊。 選取 [重新整理] 來更新狀態。 當 [狀態] 是 [已註冊] 時,代表已準備好繼續進行。

訂閱 Azure Cache for Redis 執行個體

在此步驟中,您會訂閱主題並告知事件方格您要追蹤哪些事件,以及要將這些事件傳送至何處。

  1. 在入口網站中,瀏覽至您稍早建立的快取執行個體。

  2. 在 [Azure Cache for Redis] 頁面上,選取左側功能表上的 [事件]。

  3. 選取 [Web Hook]。 您正在使用端點的 Webhook 將事件傳送至您的檢視器應用程式。

    Azure 入口網站 [事件] 頁面。

  4. 在 [建立事件訂用帳戶] 頁面上,輸入下列項目:

    設定 建議的值 描述
    名稱 輸入事件訂閱的名稱。 此值長度必須介於 3 與 64 個字元之間。 其只能包含字母、數字和破折號。
    事件類型 向下拉並選取您要推送至目的地的事件類型。 在本快速入門中,我們將調整快取執行個體。 修補、調整、匯入和匯出都是可用的選項。
    端點類型 選取 [Web Hook]。 用來接收事件的事件處理常式。
    端點 選取 [選取端點] 並輸入 Web 應用程式的 URL、將 api/updates 新增至首頁 URL (例如:https://cache.azurewebsites.net/api/updates),然後選取 [確認選取項目]。 這是您稍早所建立 Web 應用程式的 URL。
  5. 現在,在 [建立事件訂閱] 頁面上,選取 [建立] 以建立事件訂閱。

  6. 再次檢視您的 Web 應用程式,並注意訂閱驗證事件是否已傳送至其中。 選取眼睛圖示以展開事件資料。 事件方格會傳送驗證事件,以便端點確認接收事件資料。 Web 應用程式包括用於驗證訂閱的程式碼。

    Azure 事件方格檢視器。

將事件傳送至端點

現在,讓我們觸發事件以了解 Event Grid 如何將訊息散發至您的端點。 我們將調整您的 Azure Cache for Redis 執行個體。

  1. 在 Azure 入口網站中,瀏覽至您的 Azure Cache for Redis 執行個體,然後選取左側功能表上的 [調整]。

  2. 從 [調整] 頁面選取所需的定價層,然後選取 [選取]。

    您可以調整具有下列限制的不同定價層:

    • 您無法從較高的定價層調整至較低的定價層。
      • 您無法從進階快取向下調整至標準基本快取。
      • 您無法從標準快取向下調整到基本快取。
    • 您可以從基本快取調整到標準快取,但您無法同時變更大小。 如果您需要不同的大小,您可以進行後續調整作業,調整到您需要的大小。
    • 您無法直接從基本快取調整至進階快取。 首先,在單一調整作業中從基本調整至標準,然後在後續的調整作業中從標準調整至進階
    • 您無法從較大的大小向下調整至 C0 (250 MB) 的大小。

    當快取正在調整成新的定價層時,系統會使用左邊的 Azure Cache for Redis 顯示 [調整中] 狀態。 調整完成時,狀態會從 [正在調整] 變更為 [執行中]

  3. 您已觸發此事件,而 Event Grid 會將訊息傳送至您在訂閱時設定的端點。 訊息為 JSON 格式,且其包含具有一或多個事件的陣列。 在下列範例中,JSON 訊息會包含具有單一事件的陣列。 檢視您的 Web 應用程式,並注意已收到 ScalingCompleted 事件。

    以 JSON 格式調整的 Azure 事件方格檢視器。

清除資源

如果您打算繼續使用此事件,請不要清除在本快速入門中建立的資源。 否則,請刪除您在本快速入門中建立的資源。

選取資源群組,然後選取 [刪除資源群組]。

後續步驟

您現在知道如何建立自訂主題和事件訂閱,深入了解 Event Grid 可協助您: