Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
W tym artykule opisano sposób tworzenia i usuwania wystąpienia usługi Azure Redis Cache przy użyciu interfejsu wiersza polecenia platformy Azure. W tym artykule pokazano również, jak używać interfejsu wiersza polecenia platformy Azure do uzyskiwania szczegółów pamięci podręcznej, w tym stanu aprowizacji, nazwy hosta, portów i kluczy.
Wymagania wstępne
- Jeśli nie masz jeszcze konta platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.
Użyj środowiska Bash w Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Get started with Azure Cloud Shell.
Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj Azure CLI. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie Azure CLI w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić Azure CLI w kontenerze Docker.
Jeśli korzystasz z instalacji lokalnej, zaloguj się do Azure CLI za pomocą polecenia az login. Aby zakończyć proces uwierzytelniania, wykonaj kroki wyświetlane na Twoim terminalu. Aby uzyskać inne opcje logowania, zobacz Uwierzytelnianie na platformie Azure przy użyciu interfejsu wiersza polecenia platformy Azure.
Gdy zostaniesz o to poproszony/a, zainstaluj rozszerzenie Azure CLI przy pierwszym użyciu. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Używanie rozszerzeń i zarządzanie nimi za pomocą interfejsu wiersza polecenia platformy Azure.
Uruchom az version, aby sprawdzić zainstalowaną wersję i biblioteki zależne. Aby zaktualizować do najnowszej wersji, uruchom az upgrade.
- Upewnij się, że jesteś zalogowany do platformy Azure przy użyciu subskrypcji, w ramach której chcesz utworzyć pamięć podręczną. Aby użyć innej subskrypcji niż ta, za pomocą której się zalogowałeś, uruchom polecenie
az account set -s <subscriptionId>, zastępując<subscriptionId>element identyfikatorem subskrypcji, którego chcesz użyć.
Uwaga / Notatka
Usługa Azure Managed Redis używa poleceń az redisenterprise interfejsu wiersza polecenia platformy Azure. Rozszerzenie Azure CLI w wersji 2.61.0 lub nowszej wyświetla monit o instalację przy pierwszym uruchomieniu polecenia redisenterprise.
Usługa Azure Cache for Redis używa az redisenterprise poleceń dla warstw Enterprise oraz poleceń az redis dla warstw Podstawowa, Standardowa i Premium. Poniższe skrypty umożliwiają tworzenie usługi Azure Managed Redis lub Azure Cache for Redis Enterprise oraz zarządzanie nimi. W przypadku Azure Cache for Redis Basic, Standard, Premium użyj skryptów Azure Cache for Redis.
Utwórz pamięć podręczną Redis zarządzaną przez Azure
Aby utworzyć pamięć podręczną Azure Managed Redis Cache przy użyciu interfejsu wiersza polecenia platformy Azure, wymagane są parametry name, location, resourceGroup oraz sku. Inne parametry są opcjonalne i mają wartości domyślne.
Skrypt interfejsu wiersza polecenia platformy Azure w tej sekcji umożliwia utworzenie pamięci podręcznej Azure Managed Redis Cache z ustawieniami domyślnymi. Możesz również użyć następujących innych metod, aby utworzyć pamięć podręczną:
Pamięć podręczna name musi być ciągiem o długości od 1 do 63 znaków unikatowych w regionie świadczenia usługi Azure. Nazwa może zawierać tylko cyfry, litery i łączniki, musi zaczynać się i kończyć cyfrą lub literą i nie może zawierać kolejnych łączników.
Powinien location to być region świadczenia usługi Azure w pobliżu innych usług korzystających z pamięci podręcznej.
Wybierz jednostkę SKU, która ma odpowiednie funkcje i wydajność odpowiednią dla twojej pamięci podręcznej.
Uwierzytelnianie Microsoft Entra jest domyślnie włączone dla wszystkich nowych pamięci podręcznych i jest zalecane dla bezpieczeństwa.
Ważne
Jeśli to możliwe, użyj Microsoft Entra ID i tożsamości zarządzanych do autoryzowania żądań uzyskania dostępu do pamięci podręcznej. Autoryzacja przy użyciu identyfikatora Entra firmy Microsoft i tożsamości zarządzanej zapewnia lepsze zabezpieczenia i jest łatwiejsza niż autoryzacja klucza dostępu współdzielonego. Aby uzyskać więcej informacji na temat używania tożsamości zarządzanych z pamięcią podręczną, zobacz Use Microsoft Entra for cache authentication with Azure Managed Redis (Używanie usługi Microsoft Entra do uwierzytelniania w pamięci podręcznej za pomocą usługi Azure Managed Redis).
Szyfrowanie Transport Layer Security (TLS) 1.2-1.3 jest domyślnie włączone dla wszystkich nowych pamięci podręcznych. Możesz włączyć port i połączenia inne niż TLS podczas tworzenia pamięci podręcznej lub po jej utworzeniu, ale ze względów bezpieczeństwa wyłączenie protokołu TLS nie jest zalecane.
Poniższy skrypt ustawia zmienne, a następnie używa poleceń az group create i az redisenterprise create, aby utworzyć grupę zasobów z pamięcią podręczną Azure Managed Redis o zestawie SKU B1 Balanced.
# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="redis-cache-rg-$randomIdentifier"
tag="create-manage-cache"
cache="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
Uzyskiwanie szczegółów dotyczących zarządzanej pamięci podręcznej Azure Redis
Poniższy skrypt używa poleceń az redisenterprise show i az redisenterprise database list-keys w celu pobrania i wyświetlenia szczegółów dotyczących nazwy, nazwy hosta, portów i kluczy dla poprzednio wspomnianej pamięci podręcznej.
Ważne
Operacja list-keys działa tylko wtedy, gdy klucze dostępu są włączone dla pamięci podręcznej. Dane wyjściowe tego polecenia mogą naruszyć bezpieczeństwo, wyświetlając wpisy tajne i mogą wyzwalać ostrzeżenie o poufnych informacjach. Aby uzyskać więcej informacji, zobacz Zarządzanie poufnymi informacjami przy użyciu interfejsu wiersza polecenia platformy Azure.
# Get details of an Azure Managed Redis cache
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 database list-keys --cluster-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]}
Uprzątnij zasoby
Poniższy skrypt używa poleceń az group delete i az redisenterprise delete , aby usunąć poprzednią pamięć podręczną, a następnie usunąć grupę zasobów.
# 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
Ważne
Użyj tych skryptów, aby tworzyć usługi Azure Cache for Redis w warstwach Podstawowa, Standardowa i Premium oraz zarządzać nimi za pomocą poleceń az redis interfejsu wiersza polecenia platformy Azure.
Warstwy Azure Cache for Redis Enterprise i Azure Managed Redis korzystają z poleceń az redisenterprise. Rozszerzenie Azure CLI w wersji 2.61.0 lub nowszej wyświetla monit o instalację przy pierwszym uruchomieniu polecenia redisenterprise.
Aby utworzyć pamięć podręczną usługi Azure Cache for Redis w warstwie Enterprise i zarządzać nią, użyj skryptów usługi Azure Managed Redis .
Utwórz pamięć podręczną Azure Cache for Redis
Możesz użyć następującego skryptu Azure CLI do utworzenia pamięci podręcznej Azure Cache for Redis w wersji Podstawowej, Standardowej lub Premium. Aby utworzyć pamięć podręczną usługi Azure Cache for Redis w warstwie Enterprise i zarządzać nią, użyj skryptów usługi Azure Managed Redis .
Aby utworzyć pamięć podręczną Azure Cache for Redis w warstwie Podstawowa, Standardowa lub Premium przy użyciu interfejsu wiersza polecenia platformy Azure, wymagane są parametry name, location, resourceGroup, sku i size. Inne parametry są opcjonalne i mają wartości domyślne.
W tej sekcji możesz użyć skryptu interfejsu wiersza polecenia platformy Azure, aby utworzyć pamięć podręczną Azure Cache for Redis w warstwie Podstawowa z ustawieniami domyślnymi. Możesz również użyć następujących innych metod, aby utworzyć pamięć podręczną:
- Witryna Azure Portal (Podstawowa, Standardowa lub Premium)
- Azure PowerShell
- Szablon ARM
- Szablon Bicep
Pamięć podręczna name musi być ciągiem o długości od 1 do 63 znaków unikatowych w regionie świadczenia usługi Azure. Nazwa może zawierać tylko cyfry, litery i łączniki, musi zaczynać się i kończyć cyfrą lub literą i nie może zawierać kolejnych łączników.
Powinien location to być region świadczenia usługi Azure w pobliżu innych usług korzystających z pamięci podręcznej.
Wybierz oznaczenie SKU i size które mają odpowiednie funkcje i wydajność dla twojej pamięci podręcznej.
Szyfrowanie Transport Layer Security (TLS) 1.2-1.3 jest domyślnie włączone dla wszystkich nowych pamięci podręcznych. Możesz włączyć port i połączenia inne niż TLS podczas tworzenia pamięci podręcznej lub po jej utworzeniu, ale ze względów bezpieczeństwa wyłączenie protokołu TLS nie jest zalecane.
Ważne
Zaleca się uwierzytelnianie Microsoft Entra dla bezpieczeństwa. Uwierzytelnianie Microsoft Entra można włączyć podczas tworzenia pamięci podręcznej lub po utworzeniu pamięci podręcznej.
Jeśli to możliwe, użyj Microsoft Entra ID i tożsamości zarządzanych do autoryzowania żądań uzyskania dostępu do pamięci podręcznej. Autoryzacja przy użyciu identyfikatora Entra firmy Microsoft i tożsamości zarządzanej zapewnia lepsze zabezpieczenia i jest łatwiejsza niż autoryzacja klucza dostępu współdzielonego. Aby uzyskać więcej informacji na temat używania tożsamości zarządzanych z pamięcią podręczną, zobacz Użyj Microsoft Entra ID do uwierzytelniania pamięci podręcznej.
Poniższy skrypt używa poleceń az group create i az redis create , aby utworzyć grupę zasobów z pamięcią podręczną Azure Cache for Redis Basic C0 w niej.
# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="redis-cache-rg-$randomIdentifier"
tag="create-manage-cache"
cache="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) Azure Redis cache
echo "Creating $cache"
az redis create --name $cache --resource-group $resourceGroup --location "$location" --sku $sku --vm-size $size
Uzyskiwanie szczegółów dotyczących pamięci podręcznej Azure Cache for Redis
Poniższy skrypt używa poleceń az redis show i az redis list-keys w celu pobrania i wyświetlenia nazwy, nazwy hosta, portów i kluczy dla poprzedniej pamięci podręcznej.
Ważne
Operacja list-keys działa tylko wtedy, gdy klucze dostępu są włączone dla pamięci podręcznej. Dane wyjściowe tego polecenia mogą naruszyć bezpieczeństwo, wyświetlając wpisy tajne i mogą wyzwalać ostrzeżenie o poufnych informacjach. Aby uzyskać więcej informacji, zobacz Zarządzanie poufnymi informacjami przy użyciu interfejsu wiersza polecenia platformy Azure.
# Get details of an Azure Cache for Redis cache
echo "Showing details of $cache"
az redis show --name "$cache" --resource-group $resourceGroup
# Retrieve the hostname and ports for an Azure Redis instance
redis=($(az redis show --name "$cache" --resource-group $resourceGroup --query [hostName,enableNonSslPort,port,sslPort] --output tsv))
# Retrieve the keys for an Azure Redis 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]}
Uprzątnij zasoby
Poniższy skrypt używa poleceń az group delete i az redis delete , aby usunąć poprzednią pamięć podręczną, a następnie usunąć jej grupę zasobów.
# Delete an Azure 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