Halaman ini diterjemahkan oleh Cloud Translation API.

Menghubungkan ke instance Memorystore for Valkey

Halaman ini menjelaskan cara terhubung ke instance Memorystore for Valkey.

Dukungan klien

Untuk mengetahui contoh dan panduan tentang klien penghubung yang akan digunakan, lihat Contoh kode library klien. .

Akses lintas region

Anda dapat mengakses instance Memorystore for Valkey dari klien yang berada di region yang berbeda dengan tempat instance berada.

Melihat endpoint penemuan instance Anda

Untuk melihat endpoint penemuan instance Anda, gunakan petunjuk berikut:

gcloud

Untuk melihat endpoint penemuan instance, jalankan gcloud CLI describe seperti yang dijelaskan dalam melihat informasi instance.

Outputnya akan mirip dengan berikut ini:

--location=us-central1 \
authorizationMode: AUTH_DISABLED
createTime: '2024-08-06T22:02:55.224704101Z'
deletionProtectionEnabled: false
discoveryEndpoints:
- address: 10.128.0.58
  network: projects/my-project/global/networks/default
  port: 6379
engineVersion: VALKEY_7_2
name: projects/myproject/locations/us-central1/instances/my-instance
nodeConfig:
  sizeGb: 6.5
nodeType: STANDARD_SMALL
persistenceConfig:
  mode: DISABLED
pscAutoConnections:
- forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-ec00907a-3ee3-4740-8092-ae832428f8e4
  ipAddress: 10.128.0.58
  network: projects/my-project/global/networks/default
  projectId: my-project
  pscConnectionId: '38876592440606778'
- forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-5ce5518f-1c59-4b46-aa74-799fad70d7b1
  ipAddress: 10.128.0.59
  network: projects/my-project/global/networks/default
  projectId: my-project
  pscConnectionId: '38876592440606779'
replicaCount: 2
shardCount: 5
state: ACTIVE
transitEncryptionMode: TRANSIT_ENCRYPTION_DISABLED
uid: 869f2d09-d20b-46d8-94ba-be83c48ceb54
updateTime: '2024-08-06T22:18:59.389980051Z'
zoneDistributionConfig:
  mode: MULTI_ZONE

Catat alamat endpoint dan nomor port yang tercantum di bagian discovery_endpoints:. Kedua nilai yang digunakan bersama ini adalah endpoint penemuan instance Anda.

Menghubungkan dari VM Compute Engine menggunakan valkey-cli

Anda dapat terhubung ke instance Memorystore for Valkey dari VM Compute Engine apa pun yang menggunakan jaringan resmi instance Memorystore.

Untuk terhubung ke instance:

Jika Anda belum memiliki VM Compute Engine Linux yang menggunakan jaringan resmi untuk instance Memorystore for Redis, buat VM dan hubungkan ke VM tersebut dengan mengikuti Panduan memulai untuk membuat VM Linux.
Instal valkey-cli di VM Compute Engine dengan mengikuti petunjuk di Menginstal Valkey.
Lihat endpoint penemuan instance Anda dan catat.
Hubungkan ke endpoint penemuan instance Anda dengan menjalankan perintah berikut:
```
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c
```
Dengan keterangan:
- DISCOVERY_ENDPOINT_ADDRESS dan PORT_NUMBER adalah nilai yang Anda catat di langkah sebelumnya.
Catatan: Tombol -c digunakan untuk mengaktifkan mode dukungan cluster valkey-cli. Jika tombol -c tidak disediakan, saat Anda mencoba mengakses kunci dari shard yang berbeda dengan shard yang terhubung, hal ini akan menyebabkan error MOVED. Dalam mode dukungan cluster, klien akan otomatis terhubung kembali ke alamat yang ditampilkan dalam respons error.
Jalankan perintah CLUSTER SHARDS untuk melihat topologi node Anda. Catat salah satu alamat IP dan nomor port node.
Hubungkan ke node yang diinginkan dengan menjalankan perintah berikut:
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c
```
Ganti kode berikut:
- NODE_IP_ADDRESS adalah alamat IP node yang Anda temukan di langkah sebelumnya.
- NODE_PORT adalah nomor port node yang Anda temukan di langkah sebelumnya.
Setelah terhubung ke node, masukkan beberapa perintah Valkey:

Enter:
```
PING
```
Hasil:
```
PONG
```
Enter
```
SET HELLO WORLD
```
Hasil:
```
OK
```
Enter:
```
GET HELLO
```
Hasil:
```
"WORLD"
```
Setelah selesai menguji koneksi ke node Valkey, sebaiknya Anda menghapus VM Compute Engine yang digunakan untuk terhubung ke instance Valkey. Tindakan ini membantu Anda menghindari tagihan ke akun Penagihan Cloud Anda.

Menghubungkan ke instance yang mengaktifkan enkripsi dalam pengiriman

Bagian ini memberikan contoh cara terhubung ke instance Memorystore for Valkey yang mengaktifkan enkripsi dalam pengiriman.

Jika Anda belum memiliki VM Compute Engine yang menggunakan jaringan resmi yang sama dengan instance Valkey dari langkah sebelumnya, buat VM dan hubungkan ke VM tersebut dengan mengikuti Panduan memulai menggunakan VM Linux.
1. Instal valkey-cli versi 6.0 atau yang lebih baru di VM Compute Engine dengan mengikuti petunjuk di Menginstal Valkey.
Instal otoritas sertifikat instance Anda di VM Linux dengan mengikuti petunjuk di Menginstal otoritas sertifikat di klien Anda.
Lihat endpoint penemuan instance Anda dan catat.
Hubungkan ke endpoint penemuan instance Anda dengan menjalankan perintah berikut:
```
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls  --cacert /tmp/server_ca.pem
```
Dengan keterangan:
- DISCOVERY_ENDPOINT_ADDRESS dan PORT_NUMBER adalah nilai yang Anda catat di langkah sebelumnya.
Catatan: Tombol -c digunakan untuk mengaktifkan mode dukungan cluster valkey-cli. Jika tombol -c tidak disediakan, saat Anda mencoba mengakses kunci dari shard yang berbeda dengan shard yang terhubung, hal ini akan menyebabkan error MOVED. Dalam mode dukungan cluster, klien akan otomatis terhubung kembali ke alamat yang ditampilkan dalam respons error.
Jalankan perintah CLUSTER SHARDS untuk melihat topologi node Anda. Catat salah satu alamat IP dan nomor port node.
Hubungkan ke node yang diinginkan dengan menjalankan perintah berikut:
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c --tls  --cacert /tmp/server_ca.pem
```
Ganti kode berikut:
- NODE_IP_ADDRESS adalah alamat IP node yang Anda temukan di langkah sebelumnya.
- NODE_PORT adalah nomor port node yang Anda temukan di langkah sebelumnya.
Setelah terhubung ke node, masukkan beberapa perintah Valkey:

Enter:
```
PING
```
Hasil:
```
PONG
```