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 インスタンスに接続できます。

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

  1. Memorystore for Valkey インスタンスの承認済みネットワークを使用する Linux Compute Engine VM がまだない場合は、Linux VM の作成に関するクイックスタートの手順に沿って作成し、接続します。

  2. Valkey をインストールするの手順に沿って、valkey-cli を Compute Engine VM にインストールします。

  3. クライアントに認証局をインストールするの手順に沿って、インスタンスの認証局を Linux VM にインストールします。

  4. インスタンスの検出エンドポイントを表示してメモします。

  5. 次のコマンドを実行して、インスタンスの検出エンドポイントに接続します。

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c
    

    ここで

    • DISCOVERY_ENDPOINT_ADDRESSPORT_NUMBER は、前のステップでメモした値です。
  6. CLUSTER SHARDS コマンドを実行して、ノードトポロジを表示します。ノードの IP アドレスとポート番号のいずれかをメモしておきます。

  7. 次のコマンドを実行して、目的のノードに接続します。

    valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -a ACCESS_TOKEN -c
    

    次のように置き換えます。

    • NODE_IP_ADDRESS は、前のステップで確認したノードの IP アドレスです。
    • NODE_PORT は、前のステップで確認したノードのポート番号です。
  8. ノードに接続したら、Valkey コマンドを入力します。

    次のように入力します。

    PING
    

    結果:

    PONG
    

    Enter

    SET HELLO WORLD
    

    結果:

    OK
    

    次のように入力します。

    GET HELLO
    

    結果:

    "WORLD"
    
  9. Valkey ノードへの接続をテストしたら、Valkey インスタンスへの接続に使用した Compute Engine VM を削除することを検討してください。そうすることで、Cloud 請求先アカウントへの課金を回避できます。

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

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

  1. 前のステップの Valkey インスタンスと同じ承認済みネットワークを使用する Compute Engine VM がまだない場合は、これを作成してから、Linux VM を使用したクイックスタートに従って接続します。

    1. Valkey をインストールするの手順に沿って、valkey-cli バージョン 6.0 以降を Compute Engine VM にインストールします。
  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