Menghubungkan ke instance Memorystore for Valkey

Halaman ini menjelaskan cara terhubung ke instance Memorystore for Valkey.

Dukungan klien

Untuk contoh dan panduan tentang menghubungkan klien 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 dari tempat instance berada.

Melihat endpoint penemuan instance Anda

Untuk melihat endpoint penemuan instance, gunakan petunjuk berikut:

gcloud

Untuk melihat endpoint penemuan instance Anda, jalankan describe gcloud CLI seperti yang dijelaskan di bagian melihat detail 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 ini digunakan bersama-sama adalah endpoint discovery instance.

Menghubungkan dari VM Compute Engine menggunakan valkey-cli

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

Untuk terhubung ke instance:

  1. Jika Anda belum memiliki VM Compute Engine Linux yang menggunakan jaringan yang diizinkan untuk instance Memorystore for Valkey Anda, buat satu hubungkan dengan mengikuti Panduan memulai untuk membuat VM Linux.

  2. Instal valkey-cli di VM Compute Engine dengan dengan mengikuti petunjuk di Menginstal Valkey.

  3. Instal certificate authority instance Anda pada VM Linux dengan mengikuti baca petunjuk di Menginstal certificate authority pada klien Anda.

  4. Melihat endpoint penemuan instance dan catatlah.

  5. Hubungkan ke endpoint penemuan instance Anda dengan menjalankan perintah berikut berikut:

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c

    Dengan keterangan:

    • DISCOVERY_ENDPOINT_ADDRESS dan PORT_NUMBER adalah nilai-nilai yang Anda catat pada langkah sebelumnya.

  6. Jalankan perintah CLUSTER SHARDS untuk melihat topologi node Anda. Buat catatan salah satu alamat IP {i>node<i} dan nomor porta.

  7. Hubungkan ke node yang Anda inginkan dengan menjalankan perintah berikut:

    valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -a ACCESS_TOKEN -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 informasi sebelumnya langkah waktu ini.

  8. Setelah terhubung ke node, masukkan beberapa perintah Valkey:

    Enter:

    PING

    Hasil:

    PONG

    Enter

    SET HELLO WORLD

    Hasil:

    OK

    Enter:

    GET HELLO

    Hasil:

    "WORLD"

  9. Setelah selesai menguji koneksi ke node Valkey, Anda harus pertimbangkan untuk menghapus VM Compute Engine yang Anda gunakan untuk terhubung ke di instance Valkey. Melakukan hal tersebut membantu Anda menghindari timbulnya biaya pada Akun Penagihan Cloud Anda.

Menghubungkan ke instance yang mengaktifkan enkripsi dalam pengiriman

Bagian ini memberikan contoh cara terhubung ke Memorystore for Valkey instance yang mengaktifkan enkripsi in-transit.

  1. Jika Anda belum memiliki VM Compute Engine yang menggunakan jaringan yang diizinkan sebagai instance Valkey dari langkah sebelumnya, buat instance dan hubungkan dengan mengikuti Panduan memulai menggunakan Linux VM.

    1. Instal valkey-cli versi 6.0 atau yang lebih baru di VM Compute Engine dengan mengikuti petunjuk di Menginstal Valkey.

  2. Instal certificate authority instance Anda pada VM Linux dengan mengikuti baca petunjuk di Menginstal certificate authority pada klien Anda.

  3. Melihat endpoint penemuan instance dan catatlah.

  4. Hubungkan ke endpoint penemuan instance Anda dengan menjalankan perintah berikut 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-nilai yang Anda catat pada langkah sebelumnya.

  5. Jalankan perintah CLUSTER SHARDS untuk melihat topologi node Anda. Buat catatan salah satu alamat IP {i>node<i} dan nomor porta.

  6. Hubungkan ke node yang Anda inginkan 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 informasi sebelumnya langkah waktu ini.

  7. Setelah terhubung ke node, masukkan beberapa perintah Valkey:

    Enter:

    PING

    Hasil:

    PONG