使用 Azure CLI 建立 Azure Redis

發行項
11/19/2024

在此案例中，您將瞭解如何建立 Azure Redis 實例。接著，您將瞭解如何取得快取的詳細數據，包括布建狀態、主機名、埠和快取的密鑰。最後會了解如何刪除快取。

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

必要條件

在 Azure Cloud Shell 中使用 Bash 環境。如需詳細資訊，請參閱 Azure Cloud Shell 中的 Bash 快速入門。
若要在本地執行 CLI 參考命令，請安裝 Azure CLI。若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。如需詳細資訊，請參閱〈如何在 Docker 容器中執行 Azure CLI〉。
- 如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。請遵循您終端機上顯示的步驟，完成驗證程序。如需其他登入選項，請參閱使用 Azure CLI 登入。
- 出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。如需擴充功能詳細資訊，請參閱使用 Azure CLI 擴充功能。
- 執行 az version 以尋找已安裝的版本和相依程式庫。若要升級至最新版本，請執行 az upgrade。

範例指令碼

Azure 受控 Redis

若要建立 Azure 受控 Redis （預覽）實例，請登入 Azure 入口網站，然後選取 [建立資源]。
在 [新增] 頁面上選取 [資料庫]，然後選取 [Azure Cache for Redis]。

在 [新的 Redis 快取] 頁面上，設定新快取的設定。

設定	選擇值	描述
訂用帳戶	下拉並選取您的訂用帳戶。	要在其中建立這個新 Azure 受控 Redis 實例的訂用帳戶。
資源群組	下拉並選取資源群組，或選取 [新建] 並輸入新的資源群組名稱。	用來建立快取和其他資源的資源群組名稱。將所有的應用程式資源放在一個資源群組中，您將可輕鬆地一併管理或刪除這些資源。
DNS 名稱	輸入區域中唯一的名稱。	當快取名稱與快取的區域名稱合併 (只包含數字、字母或連字號) 時，必須為介於 1 到 63 個字元之間的字串。（如果快取名稱長度少於 45 個字元，則應該適用於所有目前可用的區域。名稱必須以數位或字母開頭和結尾，且不能包含連續連字元。快取執行個體的主機名稱為 `\<DNS name\>.\<Azure region\>.redis.azure.net`。
地點	下拉並選取位置。	Azure 受控 Redis 可在選取的 Azure 區域中取得。
快取類型	下拉式清單並選取效能層級和快取大小。	層會決定 Redis 實例的效能，而快取大小會決定可用來儲存數據的記憶體。如需選擇正確效能層級的指引，請參閱 Chosing 正確的層級

顯示 [Azure 受控 Redis 基本] 索引標籤的螢幕快照。

選取 [下一步：網络] ，然後選取公用或私人端點。
選取 [下一步：進階]。在這裡，您可以設定任何要新增至實例的 Redis 模組。

將 [叢集原則] 設定為 [企業]，以用於非叢集快取，或設定為叢集快取的 OSS。 如需選擇 叢集原則的詳細資訊，請參閱叢集原則。

如果您使用 主動式異地複寫，則必須在建立期間加以設定。如需如何執行這項操作的指示，請參閱設定 Azure 受控 Redis 實例的作用中異地複寫。

重要

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

重要

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

重要

建立快取實例之後，您無法變更模組。您必須在建立 Azure Cache for Redis 執行個體時啟用模組。建立快取之後，沒有選項可啟用模組的設定。
選取 [下一步：標記] 並略過。
完成時，選取 [下一步:檢閱 + 建立]。
檢閱設定並選取 [建立]。

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

Azure Cache for Redis

若要建立快取，請登入 Azure 入口網站。在入口網站功能表中，選取 [建立資源]。
在 [開始使用] 窗格中，於搜尋列中輸入「Azure Cache for Redis」。在搜尋結果中，尋找「Azure Cache for Redis」，然後選取 [建立]。

在 [新增 Azure Cache for Redis] 窗格的 [基本] 索引標籤上，為您的快取設定下列設定：

設定	動作	描述
訂用帳戶	選取 Azure 訂閱。	用於建立新 Azure Cache for Redis 執行個體的訂用帳戶。
資源群組	選取資源群組，或選取 [新建] 並輸入新的資源群組名稱。	用來建立快取和其他資源的資源群組名稱。將所有的應用程式資源放在一個資源群組中，您將可輕鬆地一併管理或刪除這些資源。
DNS 名稱	輸入唯一名稱。	快取名稱必須是 1 到 63 個字元的字串，且只能包含數字、字母和連字號。名稱的開頭和結尾必須是數字或字母，且不可包含連續的連字號。快取執行個體的主機名稱為 `\<DNS name>.redis.cache.windows.net`。
地點	選取位置。	靠近使用您快取其他服務的 Azure 區域。
快取 SKU	選取 [SKU]。	快取的可用大小、效能和功能參數取決於 SKU。如需詳細資訊，請參閱 Azure Cache for Redis 概觀。
快取大小	選取快取大小。	如需詳細資訊，請參閱 Azure Cache for Redis 概觀。

選取 [網路] 索引標籤，或選取 [下一步: 網路]。
在 [網路] 索引標籤上，選取要用於快取的連線方法。
選取 [進階] 索引標籤，或選取 [下一步: 進階]。
在 [進階] 窗格中，根據下列資訊驗證或選取驗證方法：
- 根據預設，對於新的基本、標準或進階快取，會啟用 Microsoft Entra 驗證並停用存取金鑰驗證。
- 對於基本或標準快取，您可以選擇非 TLS 連接埠的選取項目。
- 對於標準和進階快取，您可以選擇啟用可用性區域。您無法在建立快取後停用可用性區域。
- 針對進階快取，設定適用於非 TLS 連接埠、叢集、受控識別和資料持續性的設定。
重要

為了獲得最佳安全性，建議您盡可能使用 Microsoft Entra ID 搭配受控識別來授權對快取的要求。使用 Microsoft Entra ID 和受控識別進行授權，提供比共用存取金鑰授權更優異的安全性和易用性。如需搭配快取使用受控識別的詳細資訊，請參閱使用 Microsoft Entra ID 進行快取驗證 (部分機器翻譯)。
(選用) 選取 [標籤] 索引標籤，或選取 [下一步: 標籤]。
(選用) 如果您想要分類快取資源，請在 [標籤] 索引標籤上輸入標籤名稱和值。
選取 [檢閱 + 建立] 按鈕。

在 [檢閱 + 建立] 索引標籤上，Azure 會自動驗證您的設定。
出現綠色的 [通過驗證] 訊息之後，請選取 [建立]。

新的快取部署會在幾分鐘內進行。您可以在 Azure Cache for Redis 概觀窗格上監視部署進度。當 [狀態] 顯示 [執行中] 時，表示快取已可供使用。

啟動 Azure Cloud Shell

Azure Cloud Shell 是免費的互動式 Shell，可讓您用來執行本文中的步驟。它具有預先安裝和設定的共用 Azure 工具，可與您的帳戶搭配使用。

若要開啟 Cloud Shell，只要選取程式碼區塊右上角的 [試試看] 即可。您也可以移至 https://shell.azure.com ，從另一個瀏覽器索引標籤啟動 Cloud Shell。

當開啟 Cloud Shell 時，請確認已為您的環境選取 Bash。後續的工作階段將會在 Bash 環境中使用 Azure CLI，請選取 [複製] 以複製程式碼區塊，並將其貼到 Cloud Shell 中，然後按 Enter 鍵加以執行。

系統會在登入的初始帳戶下自動驗證 Cloud Shell。使用下列腳本使用不同的訂用帳戶登入，並將 subscriptionId 取代為您的 Azure 訂用帳戶標識碼。

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

subscription="subscriptionId" # Set Azure subscription ID here

az account set -s $subscription # ...or use 'az login'

如需詳細資訊，請參閱設定使用中訂閱或以互動方式登入。

執行指令碼


# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-redis-cache-rg-$randomIdentifier"
tag="create-manage-cache"
cache="msdocs-redis-cache-$randomIdentifier"
sku="Balanced_B1"

# Create a resource group
echo "Creating $resourceGroup in "$location"..."
az group create --resource-group $resourceGroup --location "$location" --tags $tag

# Create a Balanced B1 Azure Managed Redis Cache
echo "Creating $cache"
az redisenterprise create --name $cache --resource-group $resourceGroup --location "$location" --sku $sku

# Get details of an Azure Managed Redis
echo "Showing details of $cache"
az redisenterprise show --name "$cache" --resource-group $resourceGroup 

# Retrieve the hostname and ports for an Azure Redis Cache instance
redis=($(az redisenterprise show --name "$cache" --resource-group $resourceGroup --query [hostName,enableNonSslPort,port,sslPort] --output tsv))

# Retrieve the keys for an Azure Redis Cache instance
keys=($(az redisenterprise list-keys --name "$cache" --resource-group $resourceGroup --query [primaryKey,secondaryKey] --output tsv))

# Display the retrieved hostname, keys, and ports
echo "Hostname:" ${redis[0]}
echo "Non SSL Port:" ${redis[2]}
echo "Non SSL Port Enabled:" ${redis[1]}
echo "SSL Port:" ${redis[3]}
echo "Primary Key:" ${keys[0]}
echo "Secondary Key:" ${keys[1]}

# Delete a redis cache
echo "Deleting $cache"
az redisenterprise delete --name "$cache" --resource-group $resourceGroup -y

# echo "Deleting all resources"
az group delete --resource-group $resourceGroup -y

清除資源

您可以使用下列命令來移除資源群組及所有與其相關聯的資源，除非您仍持續需要這些資源，否則請使用 az group delete 命令。某些資源可能需要一些時間才能建立或刪除。

az group delete --reourceg $resourceGroup

範例參考

此腳本會使用下列命令來建立資源群組和 Azure 受控 Redis。下表中的每個命令都會連結至命令特定的文件。

Command	注意
az group create	建立用來存放所有資源的資源群組。
az redisenterprise create	建立 Azure 受控 Redis 實例。
az redisenterprise show	擷取 Azure 受控 Redis 實例的詳細數據。
az redisenterprise list-keys	擷取 Azure 受控 Redis 實例的存取密鑰。
az redisenterprise delete	刪除 Azure 受控 Redis 實例。

啟動 Azure Cloud Shell

Azure Cloud Shell 是免費的互動式 Shell，可讓您用來執行本文中的步驟。它具有預先安裝和設定的共用 Azure 工具，可與您的帳戶搭配使用。

若要開啟 Cloud Shell，只要選取程式碼區塊右上角的 [試試看] 即可。您也可以移至 https://shell.azure.com ，從另一個瀏覽器索引標籤啟動 Cloud Shell。

系統會在登入的初始帳戶下自動驗證 Cloud Shell。使用下列腳本使用不同的訂用帳戶登入，並將 subscriptionId 取代為您的 Azure 訂用帳戶標識碼。

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

subscription="subscriptionId" # Set Azure subscription ID here

az account set -s $subscription # ...or use 'az login'

如需詳細資訊，請參閱設定使用中訂閱或以互動方式登入。

執行指令碼


# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-redis-cache-rg-$randomIdentifier"
tag="create-manage-cache"
cache="msdocs-redis-cache-$randomIdentifier"
sku="basic"
size="C0"

# Create a resource group
echo "Creating $resourceGroup in "$location"..."
az group create --resource-group $resourceGroup --location "$location" --tags $tag

# Create a Basic C0 (256 MB) Redis Cache
echo "Creating $cache"
az redis create --name $cache --resource-group $resourceGroup --location "$location" --sku $sku --vm-size $size

# Get details of an Azure Cache for Redis
echo "Showing details of $cache"
az redis show --name "$cache" --resource-group $resourceGroup

# Retrieve the hostname and ports for an Azure Redis Cache instance
redis=($(az redis show --name "$cache" --resource-group $resourceGroup --query [hostName,enableNonSslPort,port,sslPort] --output tsv))

# Retrieve the keys for an Azure Redis Cache instance
keys=($(az redis list-keys --name "$cache" --resource-group $resourceGroup --query [primaryKey,secondaryKey] --output tsv))

# Display the retrieved hostname, keys, and ports
echo "Hostname:" ${redis[0]}
echo "Non SSL Port:" ${redis[2]}
echo "Non SSL Port Enabled:" ${redis[1]}
echo "SSL Port:" ${redis[3]}
echo "Primary Key:" ${keys[0]}
echo "Secondary Key:" ${keys[1]}

# Delete a redis cache
echo "Deleting $cache"
az redis delete --name "$cache" --resource-group $resourceGroup -y

# echo "Deleting all resources"
az group delete --resource-group $resourceGroup -y

清除資源

az group delete --reourceg $resourceGroup

範例參考

此指令碼使用下列命令來建立資源群組與 Azure Cache for Redis。下表中的每個命令都會連結至命令特定的文件。

Command	注意
az group create	建立用來存放所有資源的資源群組。
az redis create	建立 Azure 受控 Redis 實例。
az redis show	擷取 Azure 受控 Redis 實例的詳細數據。
az redis list-keys	擷取 Azure 受控 Redis 實例的存取密鑰。
az redis 刪除	刪除 Azure 受控 Redis 實例。

下一步

如需 Azure CLI 的詳細資訊，請參閱 Azure CLI 文件。

如需使用叢集建立 Azure 受控 Redis 的 Azure 受控 Redis CLI 腳本範例，請參閱使用叢集的 Azure 受控 Redis。

共用方式為

使用 Azure CLI 建立 Azure Redis

必要條件

範例指令碼

Azure 受控 Redis

Azure Cache for Redis

啟動 Azure Cloud Shell

執行指令碼

清除資源

範例參考

啟動 Azure Cloud Shell

執行指令碼

清除資源

範例參考

下一步

意見反應

其他資源

共用方式為

使用 Azure CLI 建立 Azure Redis

必要條件

範例指令碼

Azure 受控 Redis

Azure Cache for Redis

啟動 Azure Cloud Shell

登入 Azure

執行指令碼

清除資源

範例參考

啟動 Azure Cloud Shell

登入 Azure

執行指令碼

清除資源

範例參考

下一步

意見反應

其他資源