このページでは、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 にインストールします。クライアントに認証局をインストールするの手順に沿って、インスタンスの認証局を Linux VM にインストールします。
インスタンスの検出エンドポイントを表示してメモします。
次のコマンドを実行して、インスタンスの検出エンドポイントに接続します。
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c
ここで
- DISCOVERY_ENDPOINT_ADDRESS と PORT_NUMBER は、前のステップでメモした値です。
CLUSTER SHARDS
コマンドを実行して、ノードトポロジを表示します。ノードの IP アドレスとポート番号のいずれかをメモしておきます。次のコマンドを実行して、目的のノードに接続します。
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -a ACCESS_TOKEN -c
次のように置き換えます。
- NODE_IP_ADDRESS は、前のステップで確認したノードの IP アドレスです。
- NODE_PORT は、前のステップで確認したノードのポート番号です。
ノードに接続したら、Valkey コマンドを入力します。
次のように入力します。
PING
結果:
PONG
Enter
SET HELLO WORLD
結果:
OK
次のように入力します。
GET HELLO
結果:
"WORLD"
Valkey ノードへの接続をテストしたら、Valkey インスタンスへの接続に使用した Compute Engine VM を削除することを検討してください。そうすることで、Cloud 請求先アカウントへの課金を回避できます。
転送中の暗号化が有効になっているインスタンスに接続する
このセクションでは、転送中の暗号化が有効になっている Memorystore for Valkey インスタンスに接続する方法の例を示します。
前のステップの Valkey インスタンスと同じ承認済みネットワークを使用する Compute Engine VM がまだない場合は、これを作成してから、Linux VM を使用したクイックスタートに従って接続します。
- Valkey をインストールするの手順に沿って、
valkey-cli
バージョン 6.0 以降を Compute Engine VM にインストールします。
- Valkey をインストールするの手順に沿って、
クライアントに認証局をインストールするの手順に沿って、インスタンスの認証局を Linux VM にインストールします。
インスタンスの検出エンドポイントを表示してメモします。
次のコマンドを実行して、インスタンスの検出エンドポイントに接続します。
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls --cacert /tmp/server_ca.pem
ここで
- DISCOVERY_ENDPOINT_ADDRESS と PORT_NUMBER は、前のステップでメモした値です。
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