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

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

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

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

Azure Event Grid Viewer scaling in JSON format.

建立 Azure Cache for Redis 快取實例

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

    Create a resource is highlighted in the left navigation pane.

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

    On New, Databases is highlighted, and Azure Cache for Redis is highlighted.

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

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

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

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

    Screenshot showing the Advanced tab in the working pane and the available option to select.

    • 針對 [基本] 或 [標準快取],切換非 TLS 埠的選取範圍。 如果您要啟用 Microsoft Entra Authentication,也可以選取 。
    • 針對 進階版 快取,請設定非 TLS 埠、叢集、受控識別和數據持續性的設定。 如果您要啟用 Microsoft Entra Authentication,也可以選取 。
  7. 選取 [ 下一步:標記 ] 索引標籤,或選取頁面底部的 [ 下一步:標記 ] 按鈕。

  8. 或者,如果您想要分類資源,請在 [ 標記 ] 索引標籤中輸入名稱和值。

  9. 選取 [檢閱 + 建立]。 系統會帶您前往 Azure 驗證設定的 [檢閱 + 建立] 索引標籤。

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

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

建立訊息端點

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

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

    Deploy to Azure button.

  2. 在 [ 自定義部署] 頁面上,執行下列步驟:

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

    Azure portal deployment notification.

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

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

  6. 確認您看到網站,但尚未張貼任何事件。

    Empty Event Grid Viewer site.

註冊事件方格資源提供者

除非您之前曾使用 Event Grid,否則您必須註冊事件方格資源提供者。 如果您之前已使用 Event Grid,請跳至下一節。

在 Azure 入口網站 中,執行下列步驟:

  1. 在左側功能表上,選取 [ 訂用帳戶]。

  2. 從訂用帳戶清單中選取您要用於事件方格的訂用帳戶。

  3. 在 [訂用帳戶] 頁面上,選取左側功能表上 設定 下的 [資源提供者]。

  4. 搜尋 Microsoft.EventGrid,並確認 [狀態 ] 為 [未註冊]。

  5. 在提供者清單中選取 [Microsoft.EventGrid ]。

  6. 選取 命令行上的 [註冊 ]。

    Image showing the registration of Microsoft.EventGrid provider with the Azure subscription.

  7. 重新整理以確定 Microsoft.EventGrid 的狀態已變更為 [已註冊]。

    Image showing the successful registration of Microsoft.EventGrid provider with the Azure subscription.

訂閱 Azure Cache for Redis 實例

在此步驟中,您將訂閱主題,告知事件方格您想要追蹤的事件,以及傳送事件的位置。

  1. 在入口網站中,流覽至您稍早建立的快取實例。

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

  3. 選取 [Web Hook]。 您會使用端點的 Web 攔截,將事件傳送至查看器應用程式。

    Azure portal Events page.

  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 Viewer.

將事件傳送至您的端點

現在,讓我們觸發事件以了解 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 事件。

    Azure Event Grid Viewer scaling in JSON format.

清除資源

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

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

下一步

既然您已瞭解如何建立自定義主題和事件訂用帳戶,請深入瞭解事件方格可協助您執行的動作: