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

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

クライアントのサポート

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

リージョン間アクセス

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

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

このセクションでは、Memorystore for Valkey クラスタモードが有効なインスタンスに接続する方法について説明します。

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

クラスタモードが有効な各インスタンスには、検出エンドポイントがあり、クライアントはそれに接続します。 このエンドポイントは、IP アドレスとポート番号の組み合わせです。

Memorystore for Valkey インスタンスの検出エンドポイントを表示するには、 コンソールまたは gcloud CLI を使用します。 Google Cloud

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

  2. クライアントに CA 証明書をインストールするの手順に沿って、インスタンスの認証局（CA）証明書を 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 をインストールするの手順に沿って、 バージョン 6.0 以降を Compute Engine VM にインストールします。valkey-cli

  2. インスタンスで使用している認証局（CA）モードを確認します。

    • CA モードが インスタンス単位 の場合は、 クライアントに CA 証明書をインストールするの手順に沿って、インスタンスの CA 証明書をインストールします。

    • CA モードが 共有の場合は、 クライアントに CA 証明書バンドルをインストールするの手順に沿って、インスタンスの CA 証明書バンドルをインストールします 。CA 証明書バンドルをクライアントにインストールする

    • CA モードが 顧客管理 の場合、 追加の CA 証明書をダウンロードしてインストールしなくても、 アプリケーションをインスタンスに接続できます。そのため、このステップはスキップできます。

  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