Menggunakan alat baris perintah Redis dengan Azure Cache for Redis

Artikel
04/27/2024

Gunakan alat baris perintah redis-cli untuk berinteraksi dengan Azure Cache for Redis sebagai klien. Gunakan alat ini untuk berinteraksi langsung dengan instans Azure Cache for Redis Anda dan untuk penelusuran kesalahan dan pemecahan masalah.

Menginstal redis-cli

Alat redis-cli diinstal secara otomatis dengan paket Redis, yang tersedia untuk beberapa sistem operasi. Lihat panduan sumber terbuka menginstal Redis untuk dokumentasi paling rinci tentang sistem operasi pilihan Anda.

Linux

Redis-cli berjalan secara asli di Linux, dan sebagian besar distribusi termasuk paket Redis yang berisi alat redis-cli. Di Ubuntu, misalnya, Anda menginstal paket Redis dengan perintah berikut:

sudo apt-get update
sudo apt-get install redis

Windows

Cara terbaik untuk menggunakan redis-cli pada komputer Windows adalah dengan menginstal Subsistem Windows untuk Linux (WSL). Subsistem Linux memungkinkan Anda menjalankan alat linux langsung di Windows. Untuk menginstal WSL, ikuti instruksi penginstalan WSL.

Setelah WSL diinstal, Anda dapat menginstal redis-cli menggunakan manajemen paket apa pun yang tersedia di distro Linux yang Anda pilih untuk WSL.

Mengumpulkan informasi akses cache

Anda dapat mengumpulkan informasi yang diperlukan untuk mengakses cache menggunakan metode ini:

Azure CLI menggunakan az redis list-keys
Azure PowerShell menggunakan Get-AzRedisCacheKey
Menggunakan portal Azure

Pada bagian ini, Anda mengambil kunci dari portal Microsoft Azure.

Mengambil nama host, port, dan kunci akses dari portal Azure

Untuk menyambungkan ke server Azure Cache for Redis Anda, klien cache memerlukan nama host, port, dan kunci untuk cache. Beberapa klien mungkin merujuk ke item ini dengan nama yang sedikit berbeda. Anda bisa mendapatkan nama host, port, dan kunci dari portal Azure.

Untuk mendapatkan kunci akses, pilih Autentikasi dari menu Sumber Daya. Lalu, pilih tab Kunci akses .
Untuk mendapatkan nama host dan port untuk cache Anda, pilih Gambaran Umum dari menu Sumber Daya. Nama host dalam bentuk <nama DNS>.redis.cache.windows.net.

Koneksi menggunakan redis-cli

Buka shell atau terminal di komputer dengan paket Redis terinstal. Jika menggunakan WSL, Anda dapat menggunakan Terminal Windows untuk membuka baris perintah Linux. Sebelum menyambungkan dengan redis-cli, periksa:

Apakah akses TLS diperlukan - Secara default, instans Azure Cache for Redis menggunakan enkripsi TLS untuk koneksi. Setiap kali TLS digunakan di sisi server, TLS di redis-cli harus diaktifkan menggunakan --tls opsi .
Port yang digunakan - Semua cache tingkat Enterprise dan Enterprise Flash menggunakan port 10000. Cache tingkat Dasar, Standar, dan Premium, namun, gunakan port 6379 untuk koneksi atau port 6380 non-TLS untuk koneksi TLS.
Apakah instans cache menggunakan pengklusteran - Jika Anda menggunakan cache tingkat Premium yang menggunakan pengklusteran atau cache tingkat Enterprise/Enterprise Flash yang menggunakan kebijakan kluster OSS, tambahkan -copsi untuk memastikan semua shard dapat diakses.

Contoh

Gunakan perintah berikut untuk menyambungkan ke instans Azure Cache for Redis tingkat Dasar, Standar, atau Premium menggunakan TLS:
```
redis-cli.exe -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls
```
Koneksi ke instans Azure Cache for Redis tingkat Dasar, Standar, atau Premium yang tidak menggunakan TLS:
```
redis-cli.exe -p 6379 -h yourcachename.redis.cache.windows.net -a YourAccessKey
```
Koneksi ke instans Azure Cache for Redis tingkat Dasar, Standar, atau Premium menggunakan TLS dan pengklusteran:
```
redis-cli.exe -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls -c
```
Koneksi ke instans cache tingkat Enterprise atau Enterprise Flash menggunakan kebijakan kluster Enterprise dengan TLS:
```
redis-cli.exe -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey --tls
```
Koneksi ke instans cache tingkat Enterprise atau Enterprise Flash menggunakan kebijakan kluster OSS tanpa TLS:
```
redis-cli.exe -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey -c
```

Menguji koneksi

Setelah koneksi dibuat, Anda dapat mengeluarkan perintah ke instans Azure Cache for Redis Anda. Salah satu cara mudah untuk menguji koneksi adalah dengan menggunakan PING perintah . Perintah ini kembali di konsol PONG .

yourcachename.redis.cache.windows.net:6380> PING
PONG

Anda juga dapat menjalankan perintah seperti SET dan GET:

yourcachename.redis.cache.windows.net:6380> SET hello world
OK
yourcachename.redis.cache.windows.net:6380> GET hello
"world"

Anda sekarang tersambung ke instans Azure Cache for Redis menggunakan redis-cli.

alternatif redis-cli

Meskipun redis-cli adalah alat yang berguna, Anda dapat terhubung ke cache dengan cara lain untuk pemecahan masalah atau pengujian:

Azure Cache for Redis menawarkan Konsol Redis yang disertakan dalam portal Azure tempat Anda dapat mengeluarkan perintah tanpa perlu menginstal alat baris perintah. Fitur Konsol Redis saat ini hanya tersedia di tingkat Dasar, Standar, dan Premium.
RedisInsight adalah alat grafis yang kaya sumber terbuka untuk mengeluarkan perintah Redis dan melihat konten instans Redis. Ini berfungsi dengan Azure Cache for Redis dan didukung di Linux, Windows, dan macOS.

Mulailah dengan membuat instans cache tingkat Perusahaan baru.