連線至 Memorystore for Valkey 執行個體

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

客戶支援

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

允許防火牆上的通訊埠

如果未在防火牆允許正確的通訊埠，執行個體可能會發生連線錯誤，因為防火牆可能會封鎖 Memorystore for Valkey 使用的通訊埠。

您必須允許 TCP 通訊埠 6379，以及 TCP 通訊埠 11000 到 13047，才能使用執行個體的所有 Private Service Connect 端點。詳情請參閱「排解問題」。

跨區域存取

您可以從與執行個體所在區域不同的區域，存取 Memorystore for Valkey 執行個體。

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

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

查看執行個體的探索端點

每個已啟用叢集模式的執行個體都有探索端點，供用戶端連線。 這個端點是由 IP 位址和通訊埠號碼組成。

您可以使用 Google Cloud 控制台或 gcloud CLI，查看 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

記下 connectionType: CONNECTION_TYPE_DISCOVERY 項目 endpoints: 區段中列出的端點位址和通訊埠號碼。這兩個值會一起使用，做為執行個體的探索端點。

使用 valkey-cli 從 Compute Engine VM 連線

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

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

  1. Linux Compute Engine VM 必須使用 Memorystore for Valkey 執行個體的授權網路，如果不存在這樣的 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_ADDRESS 和 PORT_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 Billing 帳戶產生費用。

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

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

  1. Compute Engine VM 必須與上一個步驟中的 Valkey 執行個體使用相同的授權網路，如果不存在這樣的 VM，請按照快速入門導覽課程：使用 Linux VM 來建立及連線至 VM。

    1. 按照「安裝 Valkey」的說明，在 Compute Engine VM 上安裝 valkey-cli 6.0 以上版本。

  2. 按照「在用戶端上安裝 CA 憑證」一文中的操作說明，在 Linux VM 上安裝執行個體的憑證授權單位 (CA) 憑證。

  3. 查看執行個體的探索端點，並記下端點的 IP 位址和通訊埠編號。

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

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

    更改下列內容：

    • DISCOVERY_ENDPOINT_ADDRESS：您在上一步記下的探索端點 IP 位址
    • PORT_NUMBER：您在上一個步驟中記下的通訊埠編號

    如要啟用 valkey-cli 支援模式，請使用 -c 切換鈕。如未提供這個切換鈕，當您嘗試從與連線 shard 不同的 shard 存取金鑰時，執行個體會傳回 MOVED 錯誤。不過，如果您使用切換器，用戶端會自動重新連線至錯誤回應中提供的地址。

    如果您在執行個體上啟用 Identity and Access Management (IAM) 驗證或基本權杖式驗證，就必須提供驗證憑證和傳輸層安全標準 (TLS) 旗標。例如：

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls --cacert /tmp/server_ca.pem --user USERNAME -a TOKEN

    更改下列內容：

    • USERNAME：執行個體的使用者名稱
    • TOKEN：驗證權杖

    如要進一步瞭解如何產生或管理驗證憑證，請參閱「管理 IAM 驗證」和「透過基本的權杖型驗證機制確保執行個體的存取安全」。

  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：您在上一個步驟中記下的節點通訊埠編號。

    如果叢集使用 IAM 或基本權杖型驗證，請務必加入 --user 和 -a 旗標，就像在探索端點步驟中一樣。

  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_ADDRESS 和 PORT_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_ADDRESS 和 PORT_NUMBER 是您在上一步記下的值。

  7. 連線至主要節點後，請輸入下列 Valkey Get 指令：

    輸入：

    PING

    結果：

    PONG

    輸入：

    GET HELLO

    結果：

    "WORLD"

  8. 測試與 Valkey 節點的連線後，請刪除用於連線至 Valkey 執行個體的 Compute Engine VM。以免 Cloud Billing 帳戶產生費用。

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

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

  1. Compute Engine VM 必須與上一個步驟中的 Valkey 執行個體使用相同的授權網路，如果不存在這樣的 VM，請按照快速入門導覽課程：使用 Linux VM 來建立及連線至 VM。

    1. 按照「安裝 Valkey」的操作說明，在 Compute Engine VM 上安裝 valkey-cli 6.0 以上版本。

  2. 檢查您為執行個體使用的憑證授權單位 (CA) 模式。

    • 如果 CA 模式為「每個執行個體」，請按照「在用戶端上安裝 CA 憑證」一文中的操作說明，安裝執行個體的 CA 憑證。

    • 如果 CA 模式為「shared」，請按照「在用戶端安裝 CA 憑證套裝組合」一節的操作說明，安裝執行個體的 CA 憑證套裝組合。

    • 如果 CA 模式為客戶管理，應用程式即可連線至執行個體，無須下載及安裝額外的 CA 憑證。因此可以略過這個步驟。

  3. 查看執行個體的主要和讀取器端點，並記下各端點的 IP 位址和通訊埠編號。

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

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

    更改下列內容：

    • PRIMARY_ENDPOINT_ADDRESS：您在上一個步驟中記下的主要端點 IP 位址
    • PORT_NUMBER：您在上一個步驟中記下的這個端點通訊埠號碼

  5. 執行下列指令，連線至執行個體的讀取器端點：

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

    更改下列內容：

    • READER_ENDPOINT_ADDRESS：您記下的讀取器端點 IP 位址
    • PORT_NUMBER：您記下的這個端點通訊埠編號

    如果您在執行個體上啟用 IAM 驗證或基本權杖型驗證，就必須為主要和讀取器端點提供驗證憑證和 TLS 旗標。

    例如：

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls --cacert /tmp/server_ca.pem --user USERNAME -a TOKEN

    和

    valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls --cacert /tmp/server_ca.pem --user USERNAME -a TOKEN

    更改下列內容：

    • USERNAME：執行個體的使用者名稱
    • TOKEN：驗證權杖

    如要進一步瞭解如何產生或管理驗證憑證，請參閱「管理 IAM 驗證」和「透過基本的權杖型驗證機制確保執行個體的存取安全」。

  6. 連線至節點後，輸入一些 Valkey 指令：

    輸入：

    PING

    結果：

    PONG