Verbindung zu einer Memorystore for Valkey-Instanz herstellen

Auf dieser Seite wird erläutert, wie Sie eine Verbindung zu einer Memorystore for Valkey-Instanz herstellen.

Clientunterstützung

Beispiele und Anleitungen zu den zu verwendenden Verbindungsclients finden Sie unter Codebeispiele für Clientbibliotheken. .

Regionsübergreifender Zugriff

Sie können von einem Client aus, der sich in einer anderen Region als die Instanz befindet, auf eine Memorystore for Valkey-Instanz zugreifen.

Verbindung zu einer Instanz mit aktiviertem Clustermodus herstellen

In diesem Abschnitt wird erläutert, wie Sie eine Verbindung zu einer Memorystore for Valkey-Instanz mit aktiviertem Clustermodus herstellen.

Discovery-Endpunkt Ihrer Instanz ansehen

Jede Instanz mit aktiviertem Clustermodus hat einen Discovery-Endpunkt, mit dem sich Ihr Client verbindet. Dieser Endpunkt ist eine Kombination aus einer IP-Adresse und einer Portnummer.

Sie können den Discovery-Endpunkt einer Memorystore for Valkey-Instanz durch Verwendung entweder der Google Cloud Console oder der gcloud CLI ansehen.

gcloud

Führen Sie die describe gcloud CLI aus, wie unter Instanzinformationen ansehen beschrieben, um den Discovery-Endpunkt Ihrer Instanz aufzurufen.

Die Ausgabe sollte in etwa so aussehen:

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

Notieren Sie sich die Endpunktadresse und die Portnummer, die im Abschnitt endpoints: für den Eintrag connectionType: CONNECTION_TYPE_DISCOVERY aufgeführt sind. Diese beiden Werte zusammen sind der Discovery-Endpunkt Ihrer Instanz.

Verbindung von einer Compute Engine-VM mit valkey-cli herstellen

Sie können von jeder Compute Engine-VM aus eine Verbindung zur Memorystore for Valkey-Instanz herstellen, die das autorisierte Netzwerk der Memorystore-Instanz verwendet.

So stellen Sie eine Verbindung zur Instanz her:

  1. Wenn Sie noch keine Linux Compute Engine-VM haben, die das autorisierte Netzwerk für Ihre Memorystore for Valkey-Instanz verwendet, erstellen Sie eine VM und stellen Sie eine Verbindung zu ihr her: Folgen Sie dazu der Kurzanleitung zum Erstellen einer Linux-VM.

  2. Installieren Sie valkey-cli auf der Compute Engine-VM. Folgen Sie dazu der Anleitung unter Valkey installieren.

  3. Rufen Sie den Discovery-Endpunkt Ihrer Instanz auf und notieren Sie ihn.

  4. Stellen Sie mit dem folgenden Befehl eine Verbindung zum Discovery-Endpunkt Ihrer Instanz her:

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c

    Wobei:

    • DISCOVERY_ENDPOINT_ADDRESS und PORT_NUMBER sind die Werte, die Sie im vorherigen Schritt notiert haben.

  5. Führen Sie den Befehl CLUSTER SHARDS aus, um Ihre Knotentopologie aufzurufen. Notieren Sie sich eine der IP-Adressen und Portnummern des Knotens.

  6. Stellen Sie mit dem folgenden Befehl eine Verbindung zum gewünschten Knoten her:

    valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c

    Ersetzen Sie Folgendes:

    • NODE_IP_ADDRESS ist die IP-Adresse des Knotens, die Sie im vorherigen Schritt gefunden haben.
    • NODE_PORT ist die Portnummer des Knotens, die Sie im vorherigen Schritt gefunden haben.

  7. Geben Sie nach der Verbindung zum Knoten einige Valkey-Befehle ein:

    Geben Sie Folgendes ein:

    PING

    Ergebnis:

    PONG

    Eingeben

    SET HELLO WORLD

    Ergebnis:

    OK

    Geben Sie Folgendes ein:

    GET HELLO

    Ergebnis:

    "WORLD"

  8. Nachdem Sie Ihre Verbindung zum Valkey-Knoten getestet haben, sollten Sie die Compute Engine-VM löschen, mit der Sie eine Verbindung zur Valkey-Instanz hergestellt haben. Dadurch vermeiden Sie, dass Ihrem Cloud-Rechnungskonto Gebühren berechnet werden.

Verbindung zu einer Instanz mit aktivierter Verschlüsselung während der Übertragung herstellen

In diesem Abschnitt wird ein Beispiel zum Herstellen einer Verbindung mit einer Memorystore for Valkey-Instanz mit aktiviertem Clustermodus dargestellt, bei der die Verschlüsselung während der Übertragung aktiviert ist.

  1. Wenn Sie keine Compute Engine-VM haben, die dasselbe autorisierte Netzwerk wie die Valkey-Instanz aus dem vorherigen Schritt verwendet, erstellen Sie eine VM und stellen Sie eine Verbindung zu ihr her: Folgen Sie dazu der Kurzanleitung: Linux-VM verwenden.

    1. Installieren Sie valkey-cli Version 6.0 oder höher auf der Compute Engine-VM . Folgen Sie dazu der Anleitung unter Valkey installieren.

  2. Installieren Sie die Zertifikate der Zertifizierungsstelle (Certificate Authority, CA) Ihrer Instanz auf der Linux VM. Folgen Sie dazu der Anleitung unter CA-Zertifikate auf dem Client installieren.

  3. Rufen Sie den Discovery-Endpunkt Ihrer Instanz auf und notieren Sie ihn.

  4. Stellen Sie mit dem folgenden Befehl eine Verbindung zum Discovery-Endpunkt Ihrer Instanz her:

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

    Wobei:

    • DISCOVERY_ENDPOINT_ADDRESS und PORT_NUMBER sind die Werte, die Sie im vorherigen Schritt notiert haben.

  5. Führen Sie den Befehl CLUSTER SHARDS aus, um Ihre Knotentopologie aufzurufen. Notieren Sie sich eine der IP-Adressen und Portnummern des Knotens.

  6. Stellen Sie mit dem folgenden Befehl eine Verbindung zum gewünschten Knoten her:

    valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c --tls  --cacert /tmp/server_ca.pem

    Ersetzen Sie Folgendes:

    • NODE_IP_ADDRESS ist die IP-Adresse des Knotens, die Sie im vorherigen Schritt gefunden haben.
    • NODE_PORT ist die Portnummer des Knotens, die Sie im vorherigen Schritt gefunden haben.

  7. Geben Sie nach der Verbindung zum Knoten die folgenden Valkey-Befehle ein:

    Geben Sie Folgendes ein:

    PING

    Ergebnis:

    PONG

Verbindung zu einer Instanz mit deaktiviertem Clustermodus herstellen

In diesem Abschnitt wird erläutert, wie Sie eine Verbindung zu einer Memorystore for Valkey-Instanz mit deaktiviertem Clustermodus herstellen.

Primären Endpunkt und Reader-Endpunkt Ihrer Instanz ansehen

Folgen Sie dieser Anleitung, um den primären Endpunkt und den Reader-Endpunkt Ihrer Instanz aufzurufen:

gcloud

Führen Sie die describe gcloud CLI aus, wie unter Instanzinformationen ansehen beschrieben, um den primären Endpunkt und den Reader-Endpunkt Ihrer Instanz aufzurufen.

Die Ausgabe sollte in etwa so aussehen:

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

Primärer Endpunkt:Notieren Sie sich die Endpunktadresse und die Portnummer, die im Abschnitt endpoints: unter CONNECTION_TYPE_PRIMARY aufgeführt sind. Diese beiden Werte zusammen sind der primäre Endpunkt Ihrer Instanz.

Reader-Endpunkt:Notieren Sie sich die Endpunktadresse und die Portnummer, die im Abschnitt endpoints: unter CONNECTION_TYPE_READER aufgeführt sind. Diese beiden Werte zusammen sind der Reader-Endpunkt Ihrer Instanz.

Verbindung von einer Compute Engine-VM mit valkey-cli herstellen

Sie können von jeder Compute Engine-VM aus eine Verbindung zur Memorystore for Valkey-Instanz herstellen, die das autorisierte Netzwerk der Memorystore-Instanz verwendet.

So stellen Sie eine Verbindung zur Instanz her:

  1. Wenn Sie noch keine Linux Compute Engine-VM haben, die das autorisierte Netzwerk für Ihre Memorystore for Valkey-Instanz verwendet, erstellen Sie eine VM und stellen Sie eine Verbindung zu ihr her: Folgen Sie dazu der Kurzanleitung zum Erstellen einer Linux-VM.

  2. Installieren Sie valkey-cli auf der Compute Engine-VM. Folgen Sie dazu der Anleitung unter Valkey installieren.

  3. Rufen Sie den primären Endpunkt und den Reader-Endpunkt Ihrer Instanz auf und notieren Sie sie.

  4. Stellen Sie mit dem folgenden Befehl eine Verbindung zum primären Endpunkt Ihrer Instanz her:

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER

    Wobei:

    • PRIMARY_ENDPOINT_ADDRESS und PORT_NUMBER sind die Werte, die Sie im vorherigen Schritt notiert haben.

  5. Geben Sie nach der Verbindung zum primären Knoten die folgenden Valkey-Befehle ein:

    Geben Sie Folgendes ein:

    PING

    Ergebnis:

    PONG

    Eingeben

    SET HELLO WORLD

    Ergebnis:

    OK

    Geben Sie Folgendes ein:

    GET HELLO

    Ergebnis:

    "WORLD"

  6. Stellen Sie mit dem folgenden Befehl eine Verbindung zum Reader-Endpunkt Ihrer Instanz her:

    valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER

    Wobei:

    • READER_ENDPOINT_ADDRESS und PORT_NUMBER sind die Werte, die Sie im vorherigen Schritt notiert haben.

  7. Geben Sie nach der Verbindung zum primären Knoten die folgenden Valkey-Befehle ein:

    Geben Sie Folgendes ein:

    PING

    Ergebnis:

    PONG

    Geben Sie Folgendes ein:

    GET HELLO

    Ergebnis:

    "WORLD"

  8. Nachdem Sie Ihre Verbindung zum Valkey-Knoten getestet haben, sollten Sie die Compute Engine-VM löschen, mit der Sie eine Verbindung zur Valkey-Instanz hergestellt haben. Dadurch vermeiden Sie, dass Ihrem Cloud-Rechnungskonto Gebühren berechnet werden.

Verbindung zu einer Instanz mit aktivierter Verschlüsselung während der Übertragung herstellen

In diesem Abschnitt wird ein Beispiel zum Herstellen einer Verbindung mit einer Memorystore for Valkey-Instanz mit deaktiviertem Clustermodus dargestellt, bei der die Verschlüsselung während der Übertragung aktiviert ist.

  1. Wenn Sie keine Compute Engine-VM haben, die dasselbe autorisierte Netzwerk wie die Valkey-Instanz aus dem vorherigen Schritt verwendet, erstellen Sie eine VM und stellen Sie eine Verbindung zu ihr her: Folgen Sie dazu der Kurzanleitung: Linux-VM verwenden.

    1. Installieren Sie valkey-cli Version 6.0 oder höher auf der Compute Engine-VM . Folgen Sie dazu der Anleitung unter Valkey installieren.

  2. Prüfen Sie den Modus der Zertifizierungsstelle (Certificate Authority, CA), den Sie für Ihre Instanz verwenden.

  3. Rufen Sie den primären Endpunkt und den Reader-Endpunkt Ihrer Instanz auf und notieren Sie sie.

  4. Stellen Sie mit dem folgenden Befehl eine Verbindung zum primären Endpunkt Ihrer Instanz her:

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

    Wobei:

    • PRIMARY_ENDPOINT_ADDRESS und PORT_NUMBER sind die Werte, die Sie im vorherigen Schritt notiert haben.

  5. Stellen Sie mit dem folgenden Befehl eine Verbindung zum Reader-Endpunkt Ihrer Instanz her:

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

    Wobei:

    • READER_ENDPOINT_ADDRESS und PORT_NUMBER sind die Werte, die Sie im vorherigen Schritt notiert haben.

  6. Geben Sie nach der Verbindung zum Knoten einige Valkey-Befehle ein:

    Geben Sie Folgendes ein:

    PING

    Ergebnis:

    PONG