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.

Menghubungkan ke instance yang Mengaktifkan Mode Cluster

Bagian ini menjelaskan cara terhubung ke instance Memorystore for Redis yang Mengaktifkan Mode Cluster Valkey.

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 Cluster Mode Enabled 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 perintah Valkey berikut:

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

Menghubungkan ke instance dengan Mode Cluster Dinonaktifkan

Bagian ini menjelaskan cara terhubung ke instance Memorystore for Redis dengan Mode Cluster Valkey Dinonaktifkan.

Melihat endpoint utama dan pembaca instance Anda

Untuk melihat endpoint endpoint utama dan pembaca instance Anda, gunakan petunjuk berikut:

gcloud

Untuk melihat endpoint endpoint utama dan pembaca instance, jalankan describe gcloud CLI, seperti yang dijelaskan dalam melihat informasi instance.

Outputnya akan mirip dengan berikut ini:

authorizationMode: AUTH_DISABLED
createTime: '2024-08-06T22:02:55.224704101Z'
deletionProtectionEnabled: false
engineVersion: VALKEY_7_2
name: projects/myproject/locations/us-central1/instances/my-instance
nodeConfig:
  sizeGb: 6.5
nodeType: STANDARD_SMALL
persistenceConfig:
  mode: DISABLED
endpoints:
- connections:
  - pscAutoConnection:
      connectionType: CONNECTION_TYPE_PRIMARY
      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.124
      network: projects/my-project/global/networks/default
      port: 6379
      projectId: my-project
      pscConnectionId: '38876592440606778'
      serviceAttachment: projects/448055306617/regions/us-central1/serviceAttachments/gcp-memorystore-auto-b3c43536-4a77-40-psc-sa
  - pscAutoConnection:
      connectionType: CONNECTION_TYPE_READER
      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.125
      network: projects/my-project/global/networks/default
      port: 6379
      projectId: my-project
      pscConnectionId: '38876592440606779'
      serviceAttachment: projects/448055306617/regions/us-central1/serviceAttachments/gcp-memorystore-auto-b3c43536-4a77-40-psc-sa-2
replicaCount: 2
shardCount: 1
mode: CLUSTER_DISABLED
state: ACTIVE
transitEncryptionMode: TRANSIT_ENCRYPTION_DISABLED
uid: 869f2d09-d20b-46d8-94ba-be83c48ceb54
updateTime: '2024-08-06T22:18:59.389980051Z'
zoneDistributionConfig:
  mode: MULTI_ZONE

Endpoint utama: Catat alamat endpoint dan nomor port yang tercantum di bagian CONNECTION_TYPE_PRIMARY di bagian endpoints:. Kedua nilai yang digunakan bersama ini adalah endpoint utama instance Anda.

Endpoint pembaca: Catat alamat endpoint dan nomor port yang tercantum di bagian CONNECTION_TYPE_READER di bagian endpoints:. Kedua nilai yang digunakan bersama ini adalah endpoint pembaca 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 utama dan pembaca instance Anda dan catat.
Hubungkan ke endpoint utama instance Anda dengan menjalankan perintah berikut:
```
valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER
```
Dengan keterangan:
- PRIMARY_ENDPOINT_ADDRESS dan PORT_NUMBER adalah nilai yang Anda catat di langkah sebelumnya.
Setelah Anda terhubung ke node utama, masukkan perintah Valkey berikut:

Enter:
```
PING
```
Hasil:
```
PONG
```
Enter
```
SET HELLO WORLD
```
Hasil:
```
OK
```
Enter:
```
GET HELLO
```
Hasil:
```
"WORLD"
```
Hubungkan ke endpoint pembaca instance Anda dengan menjalankan perintah berikut:
```
valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER
```
Dengan keterangan:
- READER_ENDPOINT_ADDRESS dan PORT_NUMBER adalah nilai yang Anda catat di langkah sebelumnya.
Setelah Anda terhubung ke node utama, masukkan perintah Valkey Get berikut:

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

Menghubungkan ke instance yang mengaktifkan enkripsi dalam pengiriman

Bagian ini memberikan contoh cara terhubung ke instance Memorystore for Valkey Cluster Mode Disabled 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 utama dan pembaca instance Anda dan catat.
Hubungkan ke endpoint utama instance Anda dengan menjalankan perintah berikut:
```
valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem
```
Dengan keterangan:
- PRIMARY_ENDPOINT_ADDRESS dan PORT_NUMBER adalah nilai yang Anda catat di langkah sebelumnya.
Hubungkan ke endpoint pembaca instance Anda dengan menjalankan perintah berikut:
```
valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem
```
Dengan keterangan:
- READER_ENDPOINT_ADDRESS dan PORT_NUMBER adalah nilai yang Anda catat di langkah sebelumnya.
Setelah terhubung ke node, masukkan beberapa perintah Valkey:

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