連線至 Memorystore for Valkey 執行個體

本頁說明如何連線至 Memorystore for Valkey 執行個體。

客戶支援

如需連線用戶端的使用範例和指南,請參閱用戶端程式庫程式碼範例。 。

跨區域存取

您可以從與執行個體所在地區不同的用戶端存取 Memorystore for Valkey 執行個體。

連線至已啟用叢集模式的執行個體

本節說明如何連線至已啟用叢集模式的 Memorystore for Valkey 執行個體。

查看執行個體的探索端點

如要查看執行個體的探索端點,請按照下列說明操作:

gcloud

如要查看執行個體的探索端點,請按照查看執行個體資訊一文的說明,執行 describe gcloud CLI。

畫面會顯示如下的輸出內容:

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

記下 endpoints: 區段中 connectionType: CONNECTION_TYPE_DISCOVERY 項目列出的端點位址和通訊埠號碼。這兩個值加總起來就是執行個體的探索端點。

使用 valkey-cli 從 Compute Engine VM 連線

您可以使用 Memorystore 執行個體的授權網路,從任何 Compute Engine VM 連線至 Memorystore for Valkey 執行個體。

如要連線至執行個體,請按照下列步驟操作:

  1. 如果沒有使用 Memorystore for Valkey 執行個體授權網路的 Linux Compute Engine VM,請按照「快速入門導覽課程:建立 Linux VM」建立及連線至 VM。

  2. 按照「安裝 Valkey」一文中的操作說明,在 Compute Engine VM 上安裝 valkey-cli

  3. 查看執行個體的探索端點,並記下該端點。

  4. 執行下列指令,連線至執行個體的探索端點:

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c
    

    其中:

    • DISCOVERY_ENDPOINT_ADDRESSPORT_NUMBER 是您在上一步記下的值。
  5. 執行 CLUSTER SHARDS 指令,查看節點拓撲。記下其中一個節點的 IP 位址和通訊埠號碼。

  6. 執行下列指令,連線至所需節點:

    valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c
    

    更改下列內容:

    • NODE_IP_ADDRESS 是您在上一個步驟中找到的節點 IP 位址。
    • NODE_PORT 是您在上一個步驟中找到的節點連接埠號碼。
  7. 連線至節點後,輸入一些 Valkey 指令:

    輸入:

    PING
    

    結果:

    PONG
    

    Enter 鍵

    SET HELLO WORLD
    

    結果:

    OK
    

    輸入:

    GET HELLO
    

    結果:

    "WORLD"
    
  8. 測試與 Valkey 節點的連線後,建議您刪除用於連線至 Valkey 執行個體的 Compute Engine VM。這樣做有助於避免系統向您的 Cloud 帳單帳戶收取費用。

連線至已啟用傳輸中資料加密功能的執行個體

本節提供範例,說明如何連線至已啟用傳輸中加密的 Memorystore for Valkey 叢集模式執行個體。

  1. 如果沒有與上一步驟 Valkey 執行個體使用相同授權網路的 Compute Engine VM,請按照「快速入門導覽課程:使用 Linux VM」建立及連線至 VM。

    1. 按照「安裝 Valkey」一文中的操作說明,在 Compute Engine VM 上安裝 valkey-cli 6.0 以上版本。
  2. 按照「在用戶端上安裝憑證授權單位」一文中的操作說明,在 Linux VM 上安裝執行個體的憑證授權單位。

  3. 查看執行個體的探索端點,並記下該端點。

  4. 執行下列指令,連線至執行個體的探索端點:

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls  --cacert /tmp/server_ca.pem
    

    其中:

    • DISCOVERY_ENDPOINT_ADDRESSPORT_NUMBER 是您在上一步記下的值。
  5. 執行 CLUSTER SHARDS 指令,查看節點拓撲。記下其中一個節點的 IP 位址和通訊埠號碼。

  6. 執行下列指令,連線至所需節點:

    valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c --tls  --cacert /tmp/server_ca.pem
    

    更改下列內容:

    • NODE_IP_ADDRESS 是您在上一個步驟中找到的節點 IP 位址。
    • NODE_PORT 是您在上一個步驟中找到的節點連接埠號碼。
  7. 連線至節點後,請輸入下列 Valkey 指令:

    輸入:

    PING
    

    結果:

    PONG
    

連線至叢集模式已停用的執行個體

本節說明如何連線至停用叢集模式的 Memorystore for Valkey 執行個體。

查看執行個體的主要和讀取端點

如要查看執行個體的主要和讀取端點,請按照下列操作說明進行:

gcloud

如要查看執行個體的主要和讀取器端點,請執行 describe gcloud CLI,如「查看執行個體資訊」一文所述。

畫面會顯示如下的輸出內容:

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

主要端點:記下「endpoints:」部分中「CONNECTION_TYPE_PRIMARY」下方列出的端點位址和連接埠號碼。這兩個值會一起使用,做為執行個體的主要端點。

讀取器端點:記下「endpoints:」部分「CONNECTION_TYPE_READER」下方列出的端點位址和連接埠號碼。這兩個值加起來就是執行個體的讀取器端點。

使用 valkey-cli 從 Compute Engine VM 連線

您可以使用 Memorystore 執行個體的授權網路,從任何 Compute Engine VM 連線至 Memorystore for Valkey 執行個體。

如要連線至執行個體,請按照下列步驟操作:

  1. 如果沒有使用 Memorystore for Valkey 執行個體授權網路的 Linux Compute Engine VM,請按照「快速入門導覽課程:建立 Linux VM」建立及連線至 VM。

  2. 按照「安裝 Valkey」一文中的操作說明,在 Compute Engine VM 上安裝 valkey-cli

  3. 查看並記下執行個體的主要和讀取端點

  4. 執行下列指令,連線至執行個體的主要端點:

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER
    

    其中:

    • PRIMARY_ENDPOINT_ADDRESSPORT_NUMBER 是您在上一步記下的值。
  5. 連線至主要節點後,請輸入下列 Valkey 指令:

    輸入:

    PING
    

    結果:

    PONG
    

    Enter 鍵

    SET HELLO WORLD
    

    結果:

    OK
    

    輸入:

    GET HELLO
    

    結果:

    "WORLD"
    
  6. 執行下列指令,連線至執行個體的讀取器端點:

    valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER
    

    其中:

    • READER_ENDPOINT_ADDRESSPORT_NUMBER 是您在上一步記下的值。
  7. 連線至主要節點後,請輸入下列 Valkey Get 指令:

    輸入:

    PING
    

    結果:

    PONG
    

    輸入:

    GET HELLO
    

    結果:

    "WORLD"
    
  8. 測試與 Valkey 節點的連線後,請刪除用於連線至 Valkey 執行個體的 Compute Engine VM。以免系統向您的 Cloud 帳單帳戶收取費用。

連線至已啟用傳輸中資料加密功能的執行個體

本節提供範例,說明如何連線至已啟用傳輸中加密的 Memorystore for Valkey 叢集模式停用執行個體。

  1. 如果沒有與上一步驟 Valkey 執行個體使用相同授權網路的 Compute Engine VM,請按照「快速入門導覽課程:使用 Linux VM」建立及連線至 VM。

    1. 按照「安裝 Valkey」一文中的操作說明,在 Compute Engine VM 上安裝 valkey-cli 6.0 以上版本。
  2. 按照「在用戶端上安裝憑證授權單位」一文中的操作說明,在 Linux VM 上安裝執行個體的憑證授權單位。

  3. 查看並記下執行個體的主要和讀取端點

  4. 執行下列指令,連線至執行個體的主要端點:

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem
    

    其中:

    • PRIMARY_ENDPOINT_ADDRESSPORT_NUMBER 是您在上一步記下的值。
  5. 執行下列指令,連線至執行個體的讀取器端點:

    valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem
    

    其中:

    • READER_ENDPOINT_ADDRESSPORT_NUMBER 是您在上一步記下的值。
  6. 連線至節點後,輸入一些 Valkey 指令:

    輸入:

    PING
    

    結果:

    PONG