連線至 Memorystore for Valkey 執行個體

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

客戶支援

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

跨區域存取

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

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

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

查看執行個體的探索端點

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

您可以使用 Google Cloud 控制台或 gcloud CLI，查看 Memorystore for Valkey 執行個體的探索端點。

gcloud

如要查看執行個體的探索端點，請按照查看執行個體資訊一文的說明，執行 describegcloud 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 執行個體。

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

如果沒有使用 Memorystore for Valkey 執行個體授權網路的 Linux Compute Engine VM，請按照「快速入門導覽課程：建立 Linux VM」建立及連線至 VM。
按照「安裝 Valkey」一文中的操作說明，在 Compute Engine VM 上安裝 valkey-cli。
查看執行個體的探索端點，並記下該端點。
執行下列指令，連線至執行個體的探索端點：
```
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c
```
其中：
- DISCOVERY_ENDPOINT_ADDRESS 和 PORT_NUMBER 是您在上一步記下的值。
注意： -c 切換開關用於啟用 valkey-cli 叢集支援模式。如果未提供 -c 切換鍵，當您嘗試從與連線不同的分片存取金鑰時，會導致 MOVED 錯誤。在叢集支援模式中，用戶端會自動重新連線至錯誤回應中傳回的位址。
執行 CLUSTER SHARDS 指令，即可查看節點拓撲。記下其中一個節點的 IP 位址和通訊埠號碼。
執行下列指令，連線至所需節點：
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c
```
更改下列內容：
- NODE_IP_ADDRESS 是您在上一個步驟中找到的節點 IP 位址。
- NODE_PORT 是您在上一個步驟中找到的節點通訊埠編號。
連線至節點後，輸入一些 Valkey 指令：

輸入：
```
PING
```
結果：
```
PONG
```
Enter 鍵
```
SET HELLO WORLD
```
結果：
```
OK
```
輸入：
```
GET HELLO
```
結果：
```
"WORLD"
```
測試與 Valkey 節點的連線後，建議您刪除用於連線至 Valkey 執行個體的 Compute Engine VM。這麼做有助於避免 Cloud Billing 帳戶產生費用。

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

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

如果沒有與上一步驟 Valkey 執行個體使用相同授權網路的 Compute Engine VM，請按照「快速入門導覽課程：使用 Linux VM」建立及連線至 VM。
1. 按照「安裝 Valkey」一文中的操作說明，在 Compute Engine VM 上安裝 valkey-cli 6.0 以上版本。
按照「在用戶端上安裝憑證授權單位」一文中的操作說明，在 Linux VM 上安裝執行個體的憑證授權單位。
查看執行個體的探索端點，並記下該端點。
執行下列指令，連線至執行個體的探索端點：
```
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls  --cacert /tmp/server_ca.pem
```
其中：
- DISCOVERY_ENDPOINT_ADDRESS 和 PORT_NUMBER 是您在上一步記下的值。
注意： -c 切換開關用於啟用 valkey-cli 叢集支援模式。如果未提供 -c 切換鍵，當您嘗試從與連線不同的分片存取金鑰時，會導致 MOVED 錯誤。在叢集支援模式中，用戶端會自動重新連線至錯誤回應中傳回的位址。
執行 CLUSTER SHARDS 指令，即可查看節點拓撲。記下其中一個節點的 IP 位址和通訊埠號碼。
執行下列指令，連線至所需節點：
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c --tls  --cacert /tmp/server_ca.pem
```
更改下列內容：
- NODE_IP_ADDRESS 是您在上一個步驟中找到的節點 IP 位址。
- NODE_PORT 是您在上一個步驟中找到的節點通訊埠編號。
連線至節點後，請輸入下列 Valkey 指令：

輸入：
```
PING
```
結果：
```
PONG
```

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

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

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

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

gcloud

如要查看執行個體的主要和讀取器端點，請執行 describegcloud 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 執行個體。

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

如果沒有使用 Memorystore for Valkey 執行個體授權網路的 Linux Compute Engine VM，請按照「快速入門導覽課程：建立 Linux VM」建立及連線至 VM。
按照「安裝 Valkey」一文中的操作說明，在 Compute Engine VM 上安裝 valkey-cli。
查看並記下執行個體的主要和讀取端點。
執行下列指令，連線至執行個體的主要端點：
```
valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER
```
其中：
- PRIMARY_ENDPOINT_ADDRESS 和 PORT_NUMBER 是您在上一步記下的值。
連線至主要節點後，請輸入下列 Valkey 指令：

輸入：
```
PING
```
結果：
```
PONG
```
Enter 鍵
```
SET HELLO WORLD
```
結果：
```
OK
```
輸入：
```
GET HELLO
```
結果：
```
"WORLD"
```
執行下列指令，連線至執行個體的讀取器端點：
```
valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER
```
其中：
- READER_ENDPOINT_ADDRESS 和 PORT_NUMBER 是您在上一步記下的值。
連線至主要節點後，請輸入下列 Valkey Get 指令：

輸入：
```
PING
```
結果：
```
PONG
```
輸入：
```
GET HELLO
```
結果：
```
"WORLD"
```
測試與 Valkey 節點的連線後，請刪除用於連線至 Valkey 執行個體的 Compute Engine VM。以免 Cloud Billing 帳戶產生費用。

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

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

如果沒有與上一步驟 Valkey 執行個體使用相同授權網路的 Compute Engine VM，請按照「快速入門導覽課程：使用 Linux VM」建立及連線至 VM。
1. 按照「安裝 Valkey」一文中的操作說明，在 Compute Engine VM 上安裝 valkey-cli 6.0 以上版本。
按照「在用戶端上安裝憑證授權單位」一文中的操作說明，在 Linux VM 上安裝執行個體的憑證授權單位。
查看並記下執行個體的主要和讀取端點。
執行下列指令，連線至執行個體的主要端點：
```
valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem
```
其中：
- PRIMARY_ENDPOINT_ADDRESS 和 PORT_NUMBER 是您在上一步記下的值。
執行下列指令，連線至執行個體的讀取器端點：
```
valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem
```
其中：
- READER_ENDPOINT_ADDRESS 和 PORT_NUMBER 是您在上一步記下的值。
連線至節點後，輸入一些 Valkey 指令：

輸入：
```
PING
```
結果：
```
PONG
```

連線至 Memorystore for Valkey 執行個體 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

客戶支援

跨區域存取

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

查看執行個體的探索端點

gcloud

使用 valkey-cli 從 Compute Engine VM 連線

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

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

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

gcloud

使用 valkey-cli 從 Compute Engine VM 連線

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

連線至 Memorystore for Valkey 執行個體