Connettiti a un'istanza Memorystore for Valkey

Questa pagina spiega come connettersi a un'istanza Memorystore for Valkey.

Assistenza clienti

Per esempi e indicazioni su quali client di connessione utilizzare, consulta Esempi di codice della libreria client. .

Accesso tra regioni

Puoi accedere a un'istanza Memorystore for Valkey da un client che si trova in una in una regione diversa da quella in cui si trova l'istanza.

Visualizza l'endpoint di rilevamento dell'istanza

Per visualizzare l'endpoint di rilevamento della tua istanza, segui queste istruzioni:

gcloud

Per visualizzare l'endpoint di rilevamento dell'istanza, esegui describe gcloud CLI come spiegato nella sezione Visualizzare le informazioni dell'istanza.

L'output dovrebbe essere simile al seguente:

--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

Prendi nota dell'indirizzo e del numero di porta dell'endpoint elencati nel Sezione discovery_endpoints:. Questi due valori utilizzati insieme sono i tuoi l'endpoint di rilevamento dell'istanza.

Connettiti da una VM Compute Engine utilizzando valkey-cli

Puoi connetterti all'istanza Memorystore for Valkey da qualsiasi VM di Compute Engine che utilizza la macchina virtuale rete autorizzata.

Per connetterti all'istanza:

  1. Se non hai ancora una VM Linux Compute Engine che utilizza rete autorizzata per la tua istanza Memorystore for Valkey, creane una connettiti seguendo la Guida rapida per creare una VM Linux.

  2. Installa valkey-cli sulla VM di Compute Engine tramite seguendo le istruzioni riportate in Installare Valkey.

  3. Visualizza l'endpoint di rilevamento dell'istanza e prendine nota.

  4. Connettiti all'endpoint di rilevamento della tua istanza eseguendo questo comando :

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c

    Dove:

    • DISCOVERY_ENDPOINT_ADDRESS e PORT_NUMBER sono i valori che hai annotato nel passaggio precedente.

  5. Esegui il comando CLUSTER SHARDS per visualizzare la topologia dei nodi. Prendi nota di uno degli indirizzi IP e dei numeri di porta del nodo.

  6. Connettiti al nodo desiderato eseguendo questo comando:

    valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c

    Sostituisci quanto segue:

    • NODE_IP_ADDRESS è l'indirizzo IP del nodo che hai trovato nel passaggio precedente.
    • NODE_PORT è il numero di porta del nodo che hai trovato nell'istruzione precedente passaggio.

  7. Dopo aver eseguito la connessione al nodo, inserisci alcuni comandi Valkey:

    Digita:

    PING

    Risultato:

    PONG

    Invio

    SET HELLO WORLD

    Risultato:

    OK

    Digita:

    GET HELLO

    Risultato:

    "WORLD"

  8. Dopo aver testato la connessione al nodo Valkey, devi valuta la possibilità di eliminare la VM di Compute Engine che hai utilizzato Istanza Valkey. In questo modo, eviterai di incorrere in addebiti sul tuo account di fatturazione Cloud.

Connettiti a un'istanza abilitata per la crittografia dei dati in transito

Questa sezione fornisce un esempio di come connettersi a Memorystore for Valkey un'istanza con la crittografia dei dati in transito abilitata.

  1. Se non hai già una VM di Compute Engine che utilizza la stessa rete autorizzata dell'istanza Valkey del passaggio precedente, creane una e connettiti seguendo la Guida rapida all'utilizzo di una VM Linux.

    1. Installa valkey-cli versione 6.0 o successiva sulla VM di Compute Engine seguendo le istruzioni riportate in Installa Valkey.

  2. Installa l'autorità di certificazione della tua istanza sulla VM Linux seguendo questo segui le istruzioni riportate in Installare le autorità di certificazione sul client.

  3. Visualizza l'endpoint di rilevamento dell'istanza e prendine nota.

  4. Connettiti all'endpoint di rilevamento della tua istanza eseguendo questo comando :

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

    Dove:

    • DISCOVERY_ENDPOINT_ADDRESS e PORT_NUMBER sono i valori che hai annotato nel passaggio precedente.

  5. Esegui il comando CLUSTER SHARDS per visualizzare la topologia dei nodi. Prendi nota di uno degli indirizzi IP e dei numeri di porta del nodo.

  6. Connettiti al nodo desiderato eseguendo questo comando:

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

    Sostituisci quanto segue:

    • NODE_IP_ADDRESS è l'indirizzo IP del nodo che hai trovato nel passaggio precedente.
    • NODE_PORT è il numero di porta del nodo che hai trovato nell'istruzione precedente passaggio.

  7. Dopo aver eseguito la connessione al nodo, inserisci alcuni comandi Valkey:

    Digita:

    PING

    Risultato:

    PONG