共用方式為

快速入門：在 .NET Core 中使用 Azure Redis

  • 適用於: ✅ Azure Cache for Redis, ✅ Azure Managed Redis

在本快速入門中，您會將 Azure Cache for Redis 納入 .NET Core 應用程式中，以便存取可從 Azure 內的任何應用程式存取的安全專用快取。 您會在 .NET Core 主控台應用程式中明確地搭配使用 StackExchange.Redis 用戶端與 C# 程式碼。

跳至 GitHub 上的程式碼

複製 GitHub 上的存放庫 https://github.com/Azure-Samples/azure-cache-redis-samples/tree/main/quickstart/dotnet-core。

先決條件

建立 Azure 受控 Redis 實例

  1. 若要建立 Azure 受控 Redis 實例，請登入 Azure 入口網站，然後選取 [ 建立資源]。

  2. 在「建立資源」頁面中的搜索框中輸入Azure Managed Redis。

  3. 選擇 Azure Managed Redis 磁貼並選擇 「建立」。

  4. 在 「建立 Azure Managed Redis 實例 」面板中，在 「基礎 」標籤中設定新快取的設定。

    設定 選擇值 說明
    訂閱 下拉並選取您的訂用帳戶。 這個新的 Azure Managed Redis 執行個體建立所在的訂用帳戶。
    資源群組 下拉並選取資源群組，或選取 [新建] 並輸入新的資源群組名稱。 用來建立快取和其他資源的資源群組名稱。 將所有的應用程式資源放在一個資源群組中，您將可輕鬆地一併管理或刪除這些資源。
    名稱 輸入區域中唯一的名稱。 當快取名稱與快取的區域名稱合併 (只包含數字、字母或連字號) 時，必須為介於 1 到 63 個字元之間的字串。 (如果快取名稱長度小於 45 個字元，則應該適用於所有目前可用的區域。) 名稱必須以數字或字母開頭和結尾，且不能包含連續連字號。 快取執行個體的主機名稱為 \<DNS name\>.\<Azure region\>.redis.azure.net。
    區域 下拉並選取位置。 Azure Managed Redis 可在選取的 Azure 區域中使用。
    數據層 選取內存以提供高效能，或選取效能較低的Flash快取 記憶體內部層包括 平衡、 記憶體優化和 計算優化。 使用 Flash 層來使用記憶體內部 （RAM） 和磁碟上的 （SSD） 資料記憶體。
    快取大小 下拉選單並選取大小。 快取大小取決於階層。 最小的尺寸是平衡等級。 記憶體內部層大小最大的是記憶體優化層。
    效能 打開下拉選單並選取效能偏好。 效能取決於 vCPU 的數目。 vCPU 數目會隨著層級而有所不同。 計算最佳化具有最多的 vCPU。

    如需選擇正確效能層級的指引，請參閱 選擇正確的層級。

    這很重要

    所有使用超過 235 GB 儲存空間的記憶體內層級皆在公開預覽中，包括記憶體優化 M350 及以上版本;平衡 B350 及以上;以及 Compute Optimized X350 及以上版本。 所有這些層級和更高層級都處於公開預覽狀態。

    所有 Flash 優化層都處於公開預覽狀態。

  5. 選擇 「下一頁：網路」 ，並選擇 「停用公共存取並使用私人存取 」或 「啟用所有網路的公開存取」。

  6. 選取 [下一步：主動式異地複寫]。 若要使用主動式異地復寫功能，必須在布建期間啟用此功能。 沒有作用中異地複寫的快取無法在稍後新增或加入作用中異地複寫群組。 如需詳細資訊，請參閱設定 Azure Managed Redis 執行個體的作用中異地複寫。

  7. 選取 [ 下一步：進階 ] 索引標籤。

    設定您想要新增至 實例的任何 Redis 模組 。

    設定 叢集原則：

    • 使用 Enterprise 以使用 RedisSearch 或其他模組
    • 針對叢集快取使用 OSS 。
    • 針對非叢集快取使用非叢集式（預覽版）。

    如需選擇叢集原則的詳細資訊，請參閱叢集原則。

    根據預設，針對新的受控快取：

    • 已啟用 Microsoft Entra ID。
    • 存取金鑰驗證基於安全性原因已停用。

    這很重要

    您無法在建立快取執行個體之後變更模組。 模組必須在建立 Azure Managed Redis 實例時啟用。 建立快取之後，沒有選項可啟用模組的設定。

    這很重要

    為了獲得最佳安全性，建議您盡可能使用 Microsoft Entra ID 搭配受控識別來授權對快取的要求。 使用 Microsoft Entra 識別碼和受控識別進行授權，可提供優於共用存取密鑰授權的安全性與使用便利性。 如需搭配快取使用受控識別的詳細資訊，請參閱 使用 Microsoft Entra ID 進行快取驗證。

    這很重要

    建立 Azure 受控 Redis 實例之後，您無法變更叢集原則。 如果您使用 RediSearch，則需要企業叢集原則，而且 NoEviction 是唯一支援的收回原則。

    這很重要

    如果您在異地複寫群組中使用這個快取執行個體，在建立執行個體之後就無法變更收回原則。 建立快取之前，請務必了解主要節點的收回原則。 如需關於作用中異地複寫的詳細資訊，請參閱作用中異地複寫必要條件。

  8. 選取 [下一步：標記] 並略過。

  9. 選取 下一步:檢閱 + 建立。

  10. 檢閱設定並選取 [建立]。

    Redis 執行個體需要幾分鐘的時間才能建立。 您可以在 Azure Managed Redis 的 [概觀] 頁面上監視進度。 當 [狀態] 顯示為 [執行中] 時，表示快取已可供使用。

建立 Azure Cache for Redis 執行個體

  1. 在 Azure 入口網站中，搜尋並選取 [Azure Cache for Redis]。

  2. 在 [Azure Cache for Redis] 頁面上，選取 [建立>Azure Cache for Redis]。

  3. 在 [新增 Redis 快取] 頁面的 [基本] 索引卷標上，設定下列設定：

    • 訂用帳戶：選取要使用的訂用帳戶。
    • 資源群組：選取資源群組，或選取 [ 新建 ]，然後輸入新的資源組名。 將所有應用程式資源放在相同的資源群組中，可讓您輕鬆地管理或刪除它們。
    • 名稱：輸入區域中唯一的快取名稱。 名稱必須：
      • 為 1 到 63 個字元的字串。
      • 只包含數字、字母和連接號。
      • 以數字或字母開頭和結尾。
      • 未包含連續的連字號。
    • 區域：選取一個 Azure 區域，使其靠近使用您快取的其他服務。
    • 快取 SKU：選取 SKU 以判斷快取可用的大小、效能和功能。
    • 快取大小：選取快取大小。 如需詳細資訊，請參閱 Azure Cache for Redis 概觀。

    顯示 [新增 Redis 快取] 頁面 [基本] 索引標籤的螢幕擷取畫面。

  4. 選取 網路 標籤，或選取 下一步：網路。

  5. 在 [網路] 索引標籤上，選取要用於快取的連線方法。 建議使用私人端點以提高安全性。 如果您選取 [私人端點]，請選取 [新增私人端點 ]，然後建立私人端點。

  6. 選取 [ 進階] 索引卷標，或選取 [ 下一步：進階]。

  7. 在 [ 進階 ] 窗格上，設定下列選項：

    • 選取 Microsoft Entra 驗證 或 存取金鑰驗證。 Microsoft Entra Authentication 默認是啟用的。
    • 選擇是否 要啟用 非 TLS 埠。
    • 針對進階快取，您可以設定或停用 可用性區域。 您無法在建立快取後停用可用性區域。 針對標準快取，系統會自動配置可用性區域。 可用性區域不適用於基本 SKU。
    • 針對進階快取，請設定 複本計數、 叢集 和 分區計數、 系統指派的受控識別和數據 持續性的設定。

    下圖顯示標準 SKU 的 [ 進階 ] 索引標籤。

    顯示標準 SKU 快取 [進階] 窗格的螢幕快照。

    這很重要

    盡可能使用 Microsoft Entra ID 搭配受控識別，以授權對快取的要求。 使用 Microsoft Entra ID 和受控識別的授權可提供更佳的安全性，而且比共用存取密鑰授權更容易使用。 如需搭配快取使用受控識別的詳細資訊，請參閱 使用 Microsoft Entra ID 進行快取驗證。

  8. 或者，選取 [標籤] 索引標籤或選取 [下一步：標籤]，然後輸入標籤名稱和值以分類您的快取資源。

  9. 選取 [檢閱 + 建立]，一旦通過驗證，請選取 [ 建立]。

新的快取部署需要數分鐘的時間。 您可以在入口網站 Azure Cache for Redis 頁面上監視部署進度。 當快取 狀態 顯示 [ 執行中] 時，快取即可供使用。

在快取上使用 Microsoft Entra ID 驗證

Azure 受控 Redis 快取預設會啟用Microsoft Entra Authentication。

  1. 在 Azure 入口網站中，選取您想要在其中使用 Microsoft Entra 權杖型驗證的快取。

  2. 從 [資源] 功能表中選取 [驗證]。

  3. 選取 [選取成員]，然後輸入有效使用者的名稱。 當您選取 [儲存] 時，您輸入的使用者預設會自動獲指派「資料擁有者存取原則」。 您也可以輸入受控識別或服務主體，以連線到快取執行個體。

    此螢幕擷取畫面顯示資源功能表中選取的驗證，並已核取 [啟用 Microsoft Entra 驗證]。

如需搭配 Azure CLI 使用 Microsoft Entra ID 的詳細資訊，請參閱身分識別的參考頁面。

安裝程式庫以使用 Microsoft Entra ID 驗證

Azure.StackExchange.Redis 程式庫包含Microsoft Entra ID 驗證方法，以使用 Microsoft Entra ID 連線至 Azure Redis 服務。 其適用於所有 Azure Cache for Redis、Azure Cache for Redis Enterprise 和 Azure Managed Redis。

dotnet add package Microsoft.Azure.StackExchangeRedis

使用 Microsoft Entra ID 連線至快取

  1. 在您的程式碼中包括程式庫

    using Azure.Identity;
using StackExchange.Redis

  2. 使用預設 Azure 認證來驗證用戶端連線。 這可讓您的程式碼在本機執行時使用登入使用者認證，而在 Azure 中執行時使用 Azure 受控識別，並且不需要變更程式碼。

var configurationOptions = await ConfigurationOptions.Parse($"{_redisHostName}").ConfigureForAzureWithTokenCredentialAsync(new DefaultAzureCredential());
ConnectionMultiplexer _newConnection = await ConnectionMultiplexer.ConnectAsync(configurationOptions);
IDatabase Database = _newConnection.GetDatabase();

若要編輯 appsettings.json 檔案

  1. 編輯 Web.config 檔案。 然後，新增下列內容：

    "_redisHostName":"<cache-hostname>"

  2. 將 <cache-hostname> 取代為您的快取主機名稱，因為其出現在 Azure 入口網站 [資源] 功能表的 [概觀] 區段中。

    例如，使用 Azure Managed Redis 或企業層：my-redis.eastus.azure.net:10000

  3. 儲存檔案。

如需詳細資訊，請參閱 StackExchange.Redis 和 GitHub 存放庫中的程式碼。

若要編輯 appsettings.json 檔案

  1. 編輯 appsettings.json 檔案。 然後，新增下列內容：

    "_redisHostName":"<cache-hostname>"

  2. 將 <cache-hostname> 取代為您的快取主機名稱，因為其出現在 Azure 入口網站 [資源] 功能表的 [概觀] 區段中。

    例如，使用 Azure Cache for Redis：my-redis.eastus.azure.net:6380

  3. 儲存檔案。

如需詳細資訊，請參閱 StackExchange.Redis 和 GitHub 存放庫中的程式碼。

執行範例程式

如果您已開啟任何檔案，則請儲存檔案，並使用下列命令來建置應用程式：

dotnet build

若要測試 .NET 物件的序列化，請使用下列命令來執行應用程式：

dotnet run

螢幕擷取畫面：顯示主控台應用程式已完成。

清理資源

如果您想要繼續使用在本文中建立的資源，請保留該資源群組。

否則，若已完成資源使用，則可刪除您建立的 Azure 資源群組，以避免衍生費用。

這很重要

刪除資源群組是無法回復的動作。 當您刪除資源群組時，其中包含的所有資源都將永久刪除。 請確定您不會不小心刪除錯誤的資源群組或資源。 如果您是在包含需保留資源的現有資源群組內部建立資源，則可以個別刪除每個資源，而不必刪除整個資源群組。

刪除資源群組

  1. 登入 Azure 入口網站，然後選取 [資源群組]。

  2. 選取您想要刪除的資源群組。

    如果有許多資源群組，請使用 [篩選任何欄位] 方塊，並輸入您針對本文所建立資源群組的名稱。 選取結果清單中的資源群組。

    此螢幕擷取畫面顯示工作窗格中要刪除的資源群組清單。

  3. 選擇 ，刪除資源群組。

  4. 系統將會要求您確認是否刪除資源群組。 輸入您的資源群組名稱以進行確認，然後選取 [刪除]。

    此螢幕擷取畫面顯示需要資源名稱才能確認刪除的表單。

不久後，系統便會刪除該資源群組及其所有的資源。

相關內容

  • Last updated on