Memorystore for Valkey インスタンスに接続する

このページでは、Memorystore for Valkey インスタンスに接続する方法について説明します。

クライアントのサポート

使用する接続クライアントの例とガイダンスについては、クライアントライブラリのコードサンプルをご覧ください。

リージョン間アクセス

Memorystore for Valkey インスタンスには、インスタンスとは異なるリージョンにあるクライアントからアクセスできます。

インスタンスの検出エンドポイントを表示する

インスタンスの検出エンドポイントを表示するには、次の手順を使用します。

gcloud

インスタンスの検出エンドポイントを表示するには、インスタンス情報を表示するで説明されているように、describe gcloud CLI を実行します。

出力例を以下に示します。

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

discovery_endpoints: セクションに記載されているエンドポイントのアドレスとポート番号をメモします。これらの 2 つの値を組み合わせたものが、インスタンスの検出エンドポイントです。

valkey-cli を使用して Compute Engine VM から接続する

Memorystore インスタンスの承認済みネットワークを使用する任意の Compute Engine VM から Memorystore for Valkey インスタンスに接続できます。

インスタンスに接続するには:

Memorystore for Valkey インスタンスの承認済みネットワークを使用する Linux Compute Engine VM がまだない場合は、Linux VM の作成に関するクイックスタートの手順に沿って作成し、接続します。
Valkey をインストールするの手順に沿って、valkey-cli を Compute Engine VM にインストールします。
インスタンスの検出エンドポイントを表示してメモします。
次のコマンドを実行して、インスタンスの検出エンドポイントに接続します。
```
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
```
次のように入力します。
```
SET HELLO WORLD
```
結果:
```
OK
```
次のように入力します。
```
GET HELLO
```
結果:
```
"WORLD"
```
Valkey ノードへの接続をテストしたら、Valkey インスタンスへの接続に使用した Compute Engine VM を削除することを検討してください。そうすることで、Cloud 請求先アカウントへの課金を回避できます。

転送中の暗号化が有効になっているインスタンスに接続する

このセクションでは、転送中の暗号化が有効になっている Memorystore for Valkey インスタンスに接続する方法の例を示します。

前のステップの Valkey インスタンスと同じ承認済みネットワークを使用する Compute Engine VM がまだない場合は、これを作成してから、Linux VM を使用したクイックスタートに従って接続します。
1. Valkey をインストールするの手順に沿って、valkey-cli バージョン 6.0 以降を Compute Engine VM にインストールします。
クライアントに認証局をインストールするの手順に沿って、インスタンスの認証局を 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
```