KAL
Menu

Penyiapan

Menjalankan redis-server 8.0, menghubungkan redis-cli, dan memverifikasi koneksi dengan PING.

Daftar isi

Topik ini menyiapkan lingkungan Redis yang siap digunakan: menginstal redis-server dan redis-cli, menjalankan server pada port default, serta memverifikasi koneksi pertama dengan PING. Pilihan instalasi mencakup repositori paket resmi, Docker, dan berkas unduhan dari redis.io. Setelah penyiapan selesai, seluruh contoh perintah pada jalur ini dapat dijalankan langsung dari terminal.

Menginstal Redis#

Instalasi Redis tersedia melalui beberapa jalur, dan pilihannya bergantung pada sistem operasi serta lingkungan kerja. Pada distribusi Linux berbasis Debian dan Ubuntu, repositori paket resmi Redis di packages.redis.io menyediakan versi terbaru lengkap dengan redis-server dan redis-cli. Untuk lingkungan yang sudah menggunakan Docker, menjalankan Redis sebagai wadah lebih praktis karena tidak menyentuh konfigurasi sistem. Sistem operasi lain, seperti macOS dan Windows, dapat mengikuti petunjuk resmi pada halaman unduhan redis.io/downloads.

Perintah berikut memasang Redis pada distribusi berbasis Debian dan Ubuntu melalui repositori resmi Redis. Blok ini memerlukan hak administratif, sehingga tidak dijalankan di dalam sandbox dan hanya disalin ke terminal pembaca.

bash 
# tidak-dijalankan
# memasang paket prasyarat untuk menambahkan repositori resmi Redis
sudo apt-get install lsb-release curl gpg
# menambahkan kunci GPG repositori resmi Redis
curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
sudo chmod 644 /usr/share/keyrings/redis-archive-keyring.gpg
# mendaftarkan repositori resmi Redis ke daftar sumber apt
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list
# memasang Redis dari repositori resmi
sudo apt-get update
sudo apt-get install redis

Alternatif kedua menggunakan Docker. Perintah berikut menjalankan image resmi Redis 8.0 sebagai wadah yang memetakan port 6379 ke komputer lokal.

bash 
# tidak-dijalankan
# menjalankan Redis 8.0 sebagai wadah Docker pada port default
docker run -d --name redis -p 6379:6379 redis:8.0

Apabila Redis sudah terpasang, versi kedua alatnya dapat diperiksa dengan opsi --version. Keluaran berikut berasal dari lingkungan jalur ini, dan bagian hash build-nya dapat berbeda antar mesin.

bash 
# memeriksa versi redis-cli yang terpasang
redis-cli --version
# memeriksa versi redis-server yang terpasang
redis-server --version
text Keluaran 
redis-cli 8.0.2
Redis server v=8.0.2 sha=00000000:1 malloc=jemalloc-5.3.0 bits=64 build=d983be7b6fcea00d

Angka 8.0.2 menunjukkan versi Redis, sedangkan bagian lain dari keluaran berisi hash build dan pustaka alokasi memori yang tidak seragam antar mesin. Bagian yang penting untuk jalur ini adalah versi 8.0 atau yang lebih baru.

Menjalankan server Redis#

redis-server adalah proses yang menyimpan data dan melayani perintah klien. Server ini dijalankan sekali, kemudian tetap hidup di latar belakang selama menerima koneksi. Perintah berikut menjalankannya di latar depan pada port default 6379, sehingga keluaran log langsung terlihat di terminal.

bash 
# tidak-dijalankan
# menjalankan server Redis di latar depan pada port default
redis-server --port 6379

Server yang berjalan di latar depan berhenti seketika apabila Ctrl+C ditekan. Instalasi melalui apt biasanya mendaftarkan layanan redis-server pada systemd, sehingga server sudah berjalan sejak komputer dinyalakan dan dapat dikendalikan melalui systemctl. Untuk mengikuti contoh pada jalur ini, pastikan sebuah server berjalan di 127.0.0.1:6379, dan jalankan ulang redis-server apabila tidak ada proses yang merespons.

Menghubungkan dengan redis-cli#

redis-cli adalah klien command line resmi yang selalu terpasang bersama Redis. Klien ini bekerja dalam dua mode. Tanpa argumen perintah, redis-cli membuka sesi interaktif yang menampilkan prompt 127.0.0.1:6379>, yaitu alamat dan port server yang sedang dihubungi. Dengan argumen perintah, redis-cli mengeksekusi satu perintah saja lalu langsung kembali ke terminal, sehingga praktis untuk skrip dan pengujian cepat.

bash 
# tidak-dijalankan
# membuka sesi interaktif redis-cli, keluar dengan mengetik quit
redis-cli

Sesi interaktif ditutup dengan mengetik quit atau dengan menekan Ctrl+D. Mode satu perintah digunakan pada seluruh contoh jalur ini karena keluarannya dapat direproduksi secara persis, sedangkan tampilan sesi interaktif memuat prompt pada setiap barisnya.

Memverifikasi koneksi dengan PING#

Perintah PING menjadi uji koneksi yang paling sederhana: server yang hidup menjawab PONG. Pustaka klien dan alat pemantauan menggunakan PING untuk memeriksa ketersediaan server secara berkala, sehingga kebiasaan menggunakannya sejak awal berguna pada pengelolaan produksi. Jalankan PING dalam mode satu perintah untuk menguji server yang berjalan.

bash 
# menguji koneksi ke server Redis pada port default
redis-cli ping
text Keluaran 
PONG

Keluaran PONG menandakan koneksi menuju 127.0.0.1:6379 berjalan baik. PING juga menerima satu argumen pesan yang dikembalikan apa adanya, misalnya redis-cli ping uji-koneksi dijawab uji-koneksi. Untuk menghubungi server pada alamat atau port berbeda, redis-cli menyediakan opsi -h dan -p, meskipun seluruh contoh pada jalur ini menggunakan port default.

Kesalahan umum#

Kesalahan pertama yang paling sering muncul adalah Could not connect to Redis at 127.0.0.1:6379: Connection refused. Pesan itu berarti redis-cli berjalan dengan baik, tetapi tidak ada proses yang menerima koneksi di port tersebut, umumnya karena server belum dijalankan. Perbaikannya berupa urutan sederhana: jalankan redis-server terlebih dahulu, lalu ulangi pengujian PING sampai PONG muncul.

Kesalahan kedua muncul di sisi server, yaitu Address already in use ketika redis-server dimulai. Port 6379 sudah ditempati proses lain, sehingga server baru gagal mengikat portnya. Apabila proses pemilik port adalah server Redis yang sudah berjalan, server lama dapat langsung digunakan dan redis-server baru tidak perlu dijalankan.

Kesalahan ketiga adalah salah memahami mode redis-cli, bukan error server. redis-cli tanpa argumen membuka sesi interaktif dan tidak mengembalikan kendali terminal sebelum quit diketik, sehingga terminal tampak berhenti padahal klien sedang menunggu perintah. Apabila tujuannya hanya menjalankan satu perintah, tuliskan nama perintahnya langsung setelah redis-cli, sebagaimana pola pada seluruh contoh jalur ini.

Ringkasan#

  • Redis 8.0 dapat diinstal melalui repositori resmi apt, wadah Docker, atau berkas unduhan redis.io.
  • redis-server melayani port 6379 secara default, sedangkan redis-cli menghubunginya dalam mode interaktif maupun satu perintah.
  • PING yang dijawab PONG menjadi verifikasi koneksi yang paling sederhana.
  • Pesan Connection refused dan Address already in use menunjuk masalah yang berbeda, yaitu server belum berjalan atau port sudah terpakai.

Referensi#