Halaman ini menjelaskan cara terhubung ke instance Redis menggunakan Telnet dan
redis-cli
. Selain itu, halaman ini memberikan petunjuk tentang cara menghubungkan
saat menggunakan fitur seperti replika baca, AUTH, dan enkripsi dalam transit.
Terakhir, halaman ini memberikan petunjuk tentang cara menghubungkan dari lingkungan Google Kubernetes Engine.
Untuk mengetahui daftar lingkungan yang didukung Memorystore for Redis, lihat Lingkungan yang didukung. Google Cloud Beberapa lingkungan serverless yang didukung Memorystore memerlukan konektor Akses VPC Serverless. Lihat Persyaratan konektor Akses VPC Serverless untuk mengetahui detail selengkapnya.
Menghubungkan ke instance Redis dari VM Compute Engine menggunakan telnet
Anda dapat terhubung ke instance Redis dari VM Compute Engine mana pun yang menggunakan jaringan resmi instance Redis dengan alamat IP RFC 1918 yang didukung.
Jika Anda belum memiliki VM Compute Engine yang menggunakan jaringan resmi yang sama dengan instance Redis Anda, buat VM dan hubungkan ke VM tersebut dengan mengikuti Panduan memulai menggunakan VM Linux.
Instal
telnet
menggunakanapt-get
:sudo apt-get install telnet
Dari terminal, telnet ke alamat IP instance Redis, dengan mengganti variables dengan nilai yang sesuai.
telnet instance-ip-address 6379
Jika berhasil, perintah akan menampilkan hasil ini:
Trying instance-ip-address… Connected to instance-ip-address
Dalam sesi telnet, masukkan beberapa perintah Redis:
Enter:
PING
Hasil:
PONG
Enter
SET HELLO WORLD
Hasil:
+OK
Enter:
GET HELLO
Hasil:
$5 WORLD
Menghubungkan ke instance Redis dari VM Compute Engine menggunakan redis-cli
Anda dapat terhubung ke instance Redis dari VM Compute Engine mana pun yang menggunakan jaringan resmi instance Redis dengan alamat IP RFC 1918 yang didukung.
Jika Anda belum memiliki VM Compute Engine yang menggunakan jaringan yang diizinkan untuk instance Redis, buat VM dan hubungkan ke VM tersebut dengan mengikuti Membuat instance VM di subnet tertentu.
Instal
redis-cli
di VM Compute Engine dengan menjalankan perintah berikut dari terminal SSH Compute Engine:sudo apt-get install redis-tools
Jalankan perintah berikut di terminal Compute Engine, dan ganti variables dengan nilai yang sesuai.
redis-cli -h redis-instance-ip-address
Sekarang Anda terhubung ke instance Redis menggunakan
redis-cli
.Setelah selesai menguji koneksi ke instance Redis, Anda harus mempertimbangkan untuk menghapus VM Compute Engine yang Anda gunakan untuk terhubung ke instance Redis. Dengan melakukannya, Anda dapat menghindari timbulnya biaya ke akun Penagihan Cloud Anda.
Menghubungkan ke instance Redis yang menggunakan AUTH
Bagian ini menjelaskan cara terhubung ke instance Redis yang mengaktifkan fitur AUTH.
Jika Anda belum memiliki VM Compute Engine yang menggunakan jaringan resmi yang sama dengan instance Redis Anda, buat VM dan hubungkan ke VM tersebut dengan mengikuti Panduan memulai menggunakan VM Linux.
Instal
redis-cli
di VM Compute Engine dengan menjalankan perintah berikut dari terminal SSH Compute Engine:sudo apt-get install redis-tools
Mendapatkan string AUTH instance Anda
Jalankan perintah berikut untuk menggunakan
redis-cli
guna mengautentikasi dan terhubung ke instance Anda, dengan mengganti variables dengan nilai yang sesuai:redis-cli -h instance-ip-address -a auth-string
Atau:
redis-cli -h instance-ip-address AUTH auth-string
Jalankan perintah Redis
SET
danGET
untuk memverifikasi bahwa Anda telah membuat koneksi yang diautentikasi ke instance Anda.Setelah selesai menguji koneksi ke instance Redis, Anda harus mempertimbangkan untuk menghapus VM Compute Engine yang Anda gunakan untuk terhubung ke instance Redis. Dengan melakukannya, Anda dapat menghindari timbulnya biaya ke akun Penagihan Cloud Anda.
Menghubungkan ke instance Redis menggunakan endpoint baca
Jika instance Anda telah mengaktifkan replika baca, Anda dapat terhubung ke endpoint baca menggunakan petunjuk berikut:
Jika Anda belum memiliki VM Compute Engine yang menggunakan jaringan resmi yang sama dengan instance Redis Anda, buat VM dan hubungkan ke VM tersebut dengan mengikuti Panduan memulai menggunakan VM Linux.
Instal
telnet
menggunakanapt-get
:sudo apt-get install telnet
Untuk menemukan alamat IP endpoint baca instance Anda, lihat informasi replika baca untuk instance Anda.
Dari terminal, telnet ke alamat IP endpoint baca instance Redis, dengan mengganti variables dengan nilai yang sesuai.
telnet read-endpoint-ip 6379
Jika berhasil, perintah akan menampilkan hasil ini:
Trying read-endpoint-ip… Connected to read-endpoint-ip
Dalam sesi telnet, masukkan beberapa perintah Redis:
Enter:
PING
Hasil:
PONG
Menghubungkan ke instance Redis secara aman menggunakan Stunnel dan telnet
Bagian ini memberikan contoh cara terhubung ke instance Redis yang mengaktifkan enkripsi saat transit menggunakan Stunnel.
Jika Anda belum memiliki instance Redis yang mengaktifkan enkripsi saat transit, buat instance dengan mengikuti Membuat instance Redis dengan enkripsi saat transit.
Jika Anda belum memiliki VM Compute Engine yang menggunakan jaringan resmi yang sama dengan instance Redis dari langkah sebelumnya, buat VM dan hubungkan dengan mengikuti Panduan memulai menggunakan VM Linux.
Instal alat yang diperlukan untuk panduan ini dengan menjalankan perintah berikut:
sudo apt-get install stunnel4
sudo apt-get install telnet
Konfigurasi VM Compute Engine untuk digunakan dengan Stunnel:
Buat file baru untuk menempatkan Certificate Authority (CA) Anda dengan menjalankan perintah berikut:
sudo vim /tmp/server_ca.pem
Lihat Otoritas Sertifikat(CA) instance Redis Anda dengan menjalankan perintah berikut di terminal standar yang Anda gunakan untuk mengelola Google Cloud resource (bukan terminal Compute Engine):
gcloud redis instances describe instance-id --region=region
Mungkin ada hingga tiga CA.
Salin semua Otoritas Sertifikat yang terlihat, termasuk baris
-----BEGIN CERTIFICATE-----
dan baris-----END CERTIFICATE-----
, lalu tempel dan simpan ke fileserver_ca.pem
yang sebelumnya Anda buat.Buat file baru untuk menempatkan informasi konfigurasi Stunnel dengan menjalankan perintah berikut:
sudo vim /etc/stunnel/redis-client.conf
Tempelkan teks berikut dalam file, dengan mengganti redis-instance-ip dengan alamat IP instance Redis:
output=/tmp/stunnel.log CAfile=/tmp/server_ca.pem client=yes pid=/var/run/stunnel.pid verifyChain=yes sslVersion=TLSv1.2 [redis] accept=127.0.0.1:6378 connect=redis-instance-ip:6378
Mulai stunnel dengan menjalankan perintah berikut:
sudo stunnel /etc/stunnel/redis-client.conf
Pastikan stunnel sedang berjalan:
ps aux | grep stunnel
Mulai ulang Stunnel dengan menjalankan perintah berikut:
sudo systemctl restart stunnel4
Untuk terhubung ke instance Redis menggunakan Telnet, jalankan perintah berikut:
telnet localhost 6378
Dalam sesi Telnet, ping instance Redis:
Enter:
PING
Hasil:
PONG
Menghubungkan dari mesin lokal menggunakan penerusan port
Menghubungkan ke instance Redis dari komputer lokal Anda selama pengembangan dapat membantu. Untuk melakukannya, Anda harus membuat instance Compute Engine yang akan digunakan untuk penerusan port ke instance Redis.
Buat instance Compute Engine dengan menjalankan perintah berikut:
gcloud compute instances create COMPUTE_VM_NAME --machine-type=f1-micro --zone=ZONE
Dengan:
- COMPUTE_VM_NAME adalah nama yang Anda tetapkan untuk VM Compute Engine.
- ZONE adalah zona tempat Anda ingin menyediakan VM.
Perintah ini membuat VM Compute Engine dengan jenis mesin
f1-micro
agar hemat biaya. Anda dapat memilih jenis mesin lain jika diinginkan.Buka terminal baru di mesin lokal Anda.
Untuk membuat tunnel SSH yang meneruskan traffic port melalui VM Compute Engine, jalankan perintah berikut:
gcloud compute ssh COMPUTE_VM_NAME --zone=ZONE -- -N -L 6379:REDIS_INSTANCE_IP_ADDRESS:6379
Dengan:
- COMPUTE_VM_NAME adalah nama VM Compute Engine.
- ZONE adalah zona yang sama tempat VM Compute Engine berada.
- REDIS_INSTANCE_IP_ADDRESS adalah alamat IP instance Redis Anda.
Untuk menguji koneksi, buka jendela terminal baru dan jalankan perintah berikut:
redis-cli ping
Jika berfungsi dengan baik, hasilnya akan menampilkan:
PONG
Sekarang Anda terhubung ke instance Redis, dan Anda dapat mengirim perintah ke instance Redis menggunakan tunnel SSH yang terbuka ini. Jika Anda belum menginstal
redis-cli
, instal terlebih dahulu agar Anda dapat menjalankan perintah ini.Tunnel SSH tetap terbuka selama Anda mempertahankan koneksi tunnel SSH dan menjalankan jendela terminal.
Menghubungkan ke instance Redis dari cluster Google Kubernetes Engine
Anda dapat terhubung ke instance Redis dari cluster Google Kubernetes Engine yang menggunakan jaringan resmi yang sama dengan instance Redis Anda.
Menghubungkan dari pod yang menjalankan shell bash
- Buka halaman GKE di Google Cloud konsol.
GKE - Klik cluster GKE yang ingin Anda hubungkan. Jika Anda belum memiliki cluster, buat cluster dengan alias IP yang diaktifkan. Untuk mengetahui petunjuk tentang cara membuat cluster dengan IP alias yang diaktifkan, lihat Membuat cluster VPC native.
- Klik tombol Connect di sebelah kanan nama cluster Anda, lalu klik tombol Run in Cloud Shell di jendela yang muncul.
- Konfigurasi akses command line
kubectl
dengan menjalankan perintah berikut:gcloud container clusters get-credentials CLUSTER_NAME --zone=CLUSTER_ZONE --project=PROJECT_ID
CLUSTER_NAME
adalah nama cluster Anda.CLUSTER_ZONE
adalah zona tempat cluster Anda berada. Juga harus berupa zona tempat instance Redis Anda berada.PROJECT_ID
adalah project tempat cluster dan instance Redis Anda berada.
kubeconfig generated for CLUSTER_NAME
- Jika cluster Anda menggunakan versi 1.8 atau yang lebih tinggi dan mengaktifkan alias IP, lewati langkah ini. Jika cluster Anda adalah versi 1.7 atau yang lebih rendah, atau cluster versi 1.8 atau yang lebih tinggi tidak mengaktifkan alias IP, ikuti langkah-langkah solusi berikut sebelum mencoba terhubung ke instance Anda: Membuat cluster VPC native. Untuk mengetahui informasi selengkapnya tentang IP alias, termasuk cara membuat cluster dengan setelan ini diaktifkan, lihat
- Gunakan perintah berikut untuk terhubung ke shell bash:
kubectl run -i --tty busybox --image=busybox -- sh
- Telnet ke instance Redis Anda menggunakan alamat host dan nomor port:
telnet HOST-IP PORT
- Masukkan perintah Redis dasar untuk memverifikasi koneksi:
PING +PONG
- Untuk menutup koneksi telnet, tekan Control+C (atau Command+C di Mac). Untuk keluar dari shell bash di pod, masukkan return. Jika Anda sudah selesai dan tidak perlu lagi terhubung ke Redis, jalankan perintah berikut dari
direktori
/k8s-custom-iptables/
:./uninstall.sh
Menghubungkan ke instance Redis dari pod Google Kubernetes Engine
Sebelum memulai, Anda memerlukan cluster GKE. Jika Anda belum memiliki cluster, buat cluster dengan IP alias diaktifkan. Untuk mengetahui petunjuk tentang cara membuat cluster dengan IP alias yang diaktifkan, lihat Membuat cluster VPC native.
- Dari pojok kanan atas konsol, klik tombol Activate Cloud Shell
.
- Konfigurasi akses command line
kubectl
dengan menjalankan perintah berikut:gcloud container clusters get-credentials CLUSTER_NAME --zone CLUSTER_ZONE --project PROJECT_ID
CLUSTER_NAME
adalah nama cluster Anda.CLUSTER_ZONE
adalah zona tempat cluster Anda berada. Juga harus berupa zona tempat instance Redis Anda berada.PROJECT_ID
adalah project tempat cluster dan instance Redis Anda berada.
kubeconfig generated for CLUSTER_NAME
- Jika cluster Anda menggunakan versi 1.8 atau yang lebih tinggi dan mengaktifkan alias IP, lewati langkah ini. Jika cluster Anda adalah versi 1.7 atau yang lebih rendah, atau cluster versi 1.8 atau yang lebih tinggi tidak mengaktifkan alias IP, ikuti langkah-langkah solusi berikut sebelum mencoba terhubung ke instance Anda: Membuat cluster VPC native. Untuk mengetahui informasi selengkapnya tentang IP alias, termasuk cara membuat cluster dengan setelan ini diaktifkan, lihat
- Gunakan perintah berikut untuk memulai pod Redis yang menjalankan
redis-cli
:kubectl run -i --tty redisbox --image=gcr.io/google_containers/redis:v1 -- sh
- Jalankan perintah
redis-cli
, dengan menggantiHOST-IP
dengan alamat IP host instance Redis Anda:redis-cli -h HOST-IP info
- Secara opsional, jalankan perintah benchmark Redis, sekali lagi ganti
HOST-IP
dengan alamat IP host instance Redis Anda:redis-benchmark -c 100 -n 100000 -d 1024 -r 100000 -t PING,SET,GET,INCR,LPUSH,RPUSH,LPOP,RPOP,SADD,SPOP,MSET -h HOST-IP -q
- Untuk keluar dari pod Redis, masukkan
return
. Jika Anda sudah selesai dan tidak perlu lagi terhubung ke Redis, jalankan perintah berikut dari direktori/k8s-custom-iptables/
:./uninstall.sh
Langkah berikutnya
Hubungkan ke instance Redis Anda menggunakan aplikasi contoh yang berjalan di:
- Compute Engine
- GKE
- Cloud Run
- Lingkungan standar App Engine
- Lingkungan fleksibel App Engine
- Cloud Run Functions