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

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

クライアントのサポート

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

リージョン間アクセス

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

クラスタ モードが有効になっているインスタンスに接続する

このセクションでは、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: セクションに記載されているエンドポイントのアドレスとポート番号をメモします。これら 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. インスタンスの検出エンドポイントを表示して、メモします。

  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

    入力

    SET HELLO WORLD

    結果:

    OK

    次のように入力します。

    GET HELLO

    結果:

    "WORLD"

  8. 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_ADDRESS と PORT_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

クラスタモードが無効になっているインスタンスに接続する

このセクションでは、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 に記載されているエンドポイントのアドレスとポート番号をメモします。これら 2 つの値を組み合わせて使用すると、インスタンスのプライマリ エンドポイントになります。

リーダー エンドポイント: endpoints: セクションの CONNECTION_TYPE_READER に記載されているエンドポイントのアドレスとポート番号をメモします。この 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. インスタンスのプライマリ エンドポイントとリーダー エンドポイントを表示して、メモします。

  4. 次のコマンドを実行して、インスタンスのプライマリ エンドポイントに接続します。

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER

    ここで

    • PRIMARY_ENDPOINT_ADDRESS と PORT_NUMBER は、前のステップでメモした値です。

  5. プライマリ ノードに接続したら、次の Valkey コマンドを入力します。

    次のように入力します。

    PING

    結果:

    PONG

    入力

    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 請求先アカウントへの課金を回避できます。

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

このセクションでは、転送中の暗号化が有効になっている 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 PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem

    ここで

    • PRIMARY_ENDPOINT_ADDRESS と PORT_NUMBER は、前のステップでメモした値です。

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

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

    ここで

    • READER_ENDPOINT_ADDRESS と PORT_NUMBER は、前のステップでメモした値です。

  6. ノードに接続したら、次のようにいくつかの Valkey コマンドを入力します。

    次のように入力します。

    PING

    結果:

    PONG