Menghubungkan ke instance Memorystore for Valkey

Halaman ini menjelaskan cara terhubung ke instance Memorystore for Valkey.

Dukungan klien

Untuk 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 Cluster Mode Enabled

Bagian ini menjelaskan cara terhubung ke instance yang mengaktifkan Mode Cluster Memorystore untuk Valkey.

Melihat endpoint penemuan instance Anda

Untuk melihat endpoint penemuan instance Anda, gunakan petunjuk berikut:

gcloud

Untuk melihat endpoint penemuan instance Anda, 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
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_DISCOVERY
       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
       port: 6379
       projectId: my-project
       pscConnectionId: '38876592440606778'
       serviceAttachment: projects/129109085717/regions/us-east1/serviceAttachments/gcp-memorystore-auto-58e78f71-fdb7-48-psc-sa
    - pscAutoConnection:
       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
       port: 6379
       projectId: my-project
       pscConnectionId: '38876592440606779'
       serviceAttachment: projects/129109085717/regions/us-east1/serviceAttachments/gcp-memorystore-auto-58e78f71-fdb7-48-psc-sa-2
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 endpoints: untuk entri connectionType: CONNECTION_TYPE_DISCOVERY. Kedua nilai ini yang digunakan bersama-sama 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 mana pun yang menggunakan jaringan resmi instance Memorystore.

Untuk terhubung ke instance:

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

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

  3. Lihat endpoint penemuan instance Anda dan catat.

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

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c

    Dengan:

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

  5. Jalankan perintah CLUSTER SHARDS untuk melihat topologi node Anda. Catat salah satu alamat IP dan nomor port node.

  6. 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.

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

    Enter:

    PING

    Hasil:

    PONG

    Enter

    SET HELLO WORLD

    Hasil:

    OK

    Enter:

    GET HELLO

    Hasil:

    "WORLD"

  8. Setelah selesai menguji koneksi ke node Valkey, Anda harus mempertimbangkan untuk menghapus VM Compute Engine yang Anda gunakan untuk terhubung ke instance Valkey. Tindakan ini membantu Anda menghindari biaya yang ditagihkan ke akun Penagihan Cloud Anda.

Menghubungkan ke instance yang mendukung enkripsi saat transit

Bagian ini memberikan contoh cara terhubung ke instance Memorystore for Valkey dengan Mode Cluster Diaktifkan yang mengaktifkan enkripsi saat transit.

  1. Jika Anda belum memiliki VM Compute Engine yang menggunakan jaringan resmi yang sama dengan instance Valkey dari langkah sebelumnya, buat VM dan hubungkan 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.

  2. Instal otoritas sertifikat instance Anda di VM Linux dengan mengikuti petunjuk di Menginstal otoritas sertifikat di klien Anda.

  3. Lihat endpoint penemuan instance Anda dan catat.

  4. 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:

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

  5. Jalankan perintah CLUSTER SHARDS untuk melihat topologi node Anda. Catat salah satu alamat IP dan nomor port node.

  6. 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.

  7. Setelah Anda 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 Valkey dengan Mode Cluster Nonaktif.

Melihat endpoint utama dan pembaca instance Anda

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

gcloud

Untuk melihat endpoint utama dan endpoint 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 dalam bagian endpoints:. Kedua nilai ini yang digunakan bersama-sama adalah endpoint utama instance Anda.

Endpoint pembaca: Catat alamat endpoint dan nomor port yang tercantum di bagian CONNECTION_TYPE_READER dalam bagian endpoints:. Kedua nilai ini yang digunakan bersama-sama 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 mana pun yang menggunakan jaringan resmi instance Memorystore.

Untuk terhubung ke instance:

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

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

  3. Lihat endpoint utama dan pembaca instance Anda dan catat.

  4. Hubungkan ke endpoint utama instance Anda dengan menjalankan perintah berikut:

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER

    Dengan:

    • PRIMARY_ENDPOINT_ADDRESS dan PORT_NUMBER adalah nilai yang Anda catat di langkah sebelumnya.

  5. 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"

  6. Hubungkan ke endpoint pembaca instance Anda dengan menjalankan perintah berikut:

    valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER

    Dengan:

    • READER_ENDPOINT_ADDRESS dan PORT_NUMBER adalah nilai yang Anda catat di langkah sebelumnya.

  7. Setelah terhubung ke node utama, masukkan perintah Get Valkey berikut:

    Enter:

    PING

    Hasil:

    PONG

    Enter:

    GET HELLO

    Hasil:

    "WORLD"

  8. Setelah menguji koneksi ke node Valkey, Anda harus menghapus VM Compute Engine yang digunakan untuk terhubung ke instance Valkey. Hal ini membantu Anda menghindari biaya yang dikenakan ke akun Penagihan Cloud Anda.

Menghubungkan ke instance yang mendukung enkripsi saat transit

Bagian ini memberikan contoh cara terhubung ke instance Memorystore for Valkey dengan Mode Cluster Nonaktif yang mengaktifkan enkripsi saat transit.

  1. Jika Anda belum memiliki VM Compute Engine yang menggunakan jaringan resmi yang sama dengan instance Valkey dari langkah sebelumnya, buat VM dan hubungkan 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.

  2. Instal otoritas sertifikat instance Anda di VM Linux dengan mengikuti petunjuk di Menginstal otoritas sertifikat di klien Anda.

  3. Lihat endpoint utama dan pembaca instance Anda dan catat.

  4. 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:

    • PRIMARY_ENDPOINT_ADDRESS dan PORT_NUMBER adalah nilai yang Anda catat di langkah sebelumnya.

  5. 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:

    • READER_ENDPOINT_ADDRESS dan PORT_NUMBER adalah nilai yang Anda catat di langkah sebelumnya.

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

    Enter:

    PING

    Hasil:

    PONG