Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Artikel ini menjelaskan cara membuat dan menghapus instans cache Azure Redis dengan menggunakan Azure CLI. Artikel ini juga memperlihatkan cara menggunakan Azure CLI untuk mendapatkan detail cache termasuk status provisi, nama host, port, dan kunci.
Prasyarat
- Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.
Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai menggunakan Azure Cloud Shell.
Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.
Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah az login. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Mengautentikasi ke Azure menggunakan Azure CLI.
Saat diminta, instal ekstensi Azure CLI saat pertama kali digunakan. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan dan mengelola ekstensi dengan Azure CLI.
Jalankan az version untuk menemukan versi dan pustaka dependen yang terinstal. Untuk meng-upgrade ke versi terbaru, jalankan az upgrade.
- Pastikan Anda masuk ke Azure dengan langganan tempat Anda ingin membuat cache. Untuk menggunakan langganan yang berbeda dari langganan yang Anda gunakan untuk masuk, jalankan
az account set -s <subscriptionId>, ganti<subscriptionId>dengan ID langganan yang ingin Anda gunakan.
Nota
Azure Managed Redis menggunakan perintah Azure CLI az redisenterprise .
redisenterprise Ekstensi untuk Azure CLI versi 2.61.0 atau yang lebih tinggi meminta Anda menginstal saat pertama kali menjalankan az redisenterprise perintah.
Azure Cache for Redis menggunakan az redisenterprise perintah untuk tingkat Enterprise dan perintah az redis untuk tingkat Dasar, Standar, dan Premium. Anda dapat menggunakan skrip berikut untuk membuat dan mengelola Azure Managed Redis atau Azure Cache for Redis Enterprise. Untuk Azure Cache for Redis Basic, Standard, dan Premium, gunakan skrip Azure Cache for Redis .
Membuat cache Azure Managed Redis
Untuk membuat cache Azure Managed Redis dengan menggunakan Azure CLI, parameter name, location, resourceGroup, dan sku diperlukan. Parameter lain bersifat opsional dan memiliki default.
Anda dapat menggunakan skrip Azure CLI di bagian ini untuk membuat cache Azure Managed Redis dengan pengaturan default. Anda juga dapat menggunakan metode lain berikut untuk membuat cache:
Cache name harus berupa string 1-63 karakter yang unik di wilayah Azure. Nama hanya boleh berisi angka, huruf, dan tanda hubung, harus dimulai dan diakhir dengan angka atau huruf, dan tidak boleh berisi tanda hubung berturut-turut.
location harus menjadi wilayah Azure di dekat layanan lain yang menggunakan cache Anda.
Pilih sku yang memiliki fitur dan performa yang sesuai untuk cache Anda.
Autentikasi Microsoft Entra diaktifkan secara default untuk semua cache baru dan direkomendasikan untuk keamanan.
Penting
Gunakan ID Microsoft Entra dengan identitas terkelola untuk mengotorisasi permintaan terhadap cache Anda jika memungkinkan. Otorisasi menggunakan ID Microsoft Entra dan identitas terkelola memberikan keamanan yang lebih baik dan lebih mudah digunakan daripada otorisasi kunci akses bersama. Untuk informasi selengkapnya tentang menggunakan identitas terkelola dengan cache Anda, lihat Menggunakan Microsoft Entra untuk autentikasi cache dengan Azure Managed Redis.
Enkripsi Transport Layer Security (TLS) 1.2-1.3 diaktifkan secara default untuk semua cache baru. Anda dapat mengaktifkan port dan koneksi non-TLS selama atau setelah pembuatan cache, tetapi karena alasan keamanan, menonaktifkan TLS tidak disarankan.
Skrip berikut menetapkan variabel, lalu menggunakan perintah az group create dan az redisenterprise create untuk membuat grup sumber daya dengan cache Azure Managed Redis Balanced B1 SKU di dalamnya.
# 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
Dapatkan detail untuk cache Azure Managed Redis
Skrip berikut menggunakan perintah az redisenterprise show dan az redisenterprise database list-keys untuk mendapatkan dan menampilkan detail nama, nama host, port, dan kunci untuk cache sebelumnya.
Penting
Operasi list-keys hanya berfungsi ketika kunci akses diaktifkan untuk cache. Output perintah ini dapat membahayakan keamanan dengan menampilkan rahasia, dan dapat memicu peringatan informasi sensitif. Untuk informasi selengkapnya, lihat Menggunakan Azure CLI untuk mengelola informasi sensitif.
# 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]}
Membersihkan sumber daya
Skrip berikut menggunakan perintah az group delete dan az redisenterprise delete untuk menghapus cache sebelumnya, lalu menghapus grup sumber dayanya.
# 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
Penting
Gunakan skrip ini untuk membuat dan mengelola tingkat Basic, Standard, dan Premium untuk Azure Cache for Redis dengan perintah Azure CLI, az redis.
Tingkat Redis Enterprise Azure Cache dan Azure Managed Redis menggunakan perintah az redisenterprise .
redisenterprise Ekstensi untuk Azure CLI versi 2.61.0 atau yang lebih tinggi meminta Anda menginstal saat pertama kali menjalankan az redisenterprise perintah.
Untuk membuat dan mengelola cache Tingkat Perusahaan Azure Cache for Redis, gunakan skrip Azure Managed Redis .
Membuat cache Azure Cache for Redis
Anda dapat menggunakan skrip Azure CLI berikut untuk membuat Azure Cache for Redis dengan tingkatan Basic, Standard, atau Premium. Untuk membuat dan mengelola cache Tingkat Perusahaan Azure Cache for Redis, gunakan skrip Azure Managed Redis .
Untuk membuat cache Azure Cache for Redis Basic, Standard, atau Premium dengan menggunakan Azure CLI, parameter name, location, resourceGroup, sku, dan size diperlukan. Parameter lain bersifat opsional dan memiliki default.
Anda dapat menggunakan skrip Azure CLI di bagian ini untuk membuat cache Azure Cache for Redis Basic dengan pengaturan default. Anda juga dapat menggunakan metode lain berikut untuk membuat cache:
Cache name harus berupa string 1-63 karakter yang unik di wilayah Azure. Nama hanya boleh berisi angka, huruf, dan tanda hubung, harus dimulai dan diakhir dengan angka atau huruf, dan tidak boleh berisi tanda hubung berturut-turut.
location harus menjadi wilayah Azure di dekat layanan lain yang menggunakan cache Anda.
Pilih sku dan size yang memiliki fitur dan performa yang sesuai untuk cache Anda.
Enkripsi Transport Layer Security (TLS) 1.2-1.3 diaktifkan secara default untuk semua cache baru. Anda dapat mengaktifkan port dan koneksi non-TLS selama atau setelah pembuatan cache, tetapi karena alasan keamanan, menonaktifkan TLS tidak disarankan.
Penting
Autentikasi Microsoft Entra direkomendasikan untuk keamanan. Anda dapat mengaktifkan Autentikasi Microsoft Entra selama atau setelah pembuatan cache.
Gunakan ID Microsoft Entra dengan identitas terkelola untuk mengotorisasi permintaan terhadap cache Anda jika memungkinkan. Otorisasi menggunakan ID Microsoft Entra dan identitas terkelola memberikan keamanan yang lebih baik dan lebih mudah digunakan daripada otorisasi kunci akses bersama. Untuk informasi selengkapnya tentang menggunakan identitas terkelola dengan cache Anda, lihat Menggunakan ID Microsoft Entra untuk autentikasi cache.
Skrip berikut menggunakan perintah az group create dan az redis create untuk membuat grup sumber daya dengan cache Azure Cache for Redis Basic C0 di dalamnya.
# 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
Dapatkan detail dari cache Azure Cache for Redis
Skrip berikut menggunakan perintah az redis show dan az redis list-keys untuk mendapatkan dan menampilkan detail nama, nama host, port, dan kunci untuk cache sebelumnya.
Penting
Operasi list-keys hanya berfungsi ketika kunci akses diaktifkan untuk cache. Output perintah ini dapat membahayakan keamanan dengan menampilkan rahasia, dan dapat memicu peringatan informasi sensitif. Untuk informasi selengkapnya, lihat Menggunakan Azure CLI untuk mengelola informasi sensitif.
# 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]}
Membersihkan sumber daya
Skrip berikut menggunakan perintah az group delete dan az redis delete untuk menghapus cache sebelumnya, lalu menghapus grup sumber dayanya.
# 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