Questa pagina spiega come connettersi a un'istanza Memorystore for Valkey.
Assistenza clienti
Per esempi e indicazioni sui client di connessione da 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 un'area geografica diversa da quella in cui si trova l'istanza.
Connettersi a un'istanza con la modalità cluster abilitata
Questa sezione spiega come connettersi a un'istanza Memorystore for Valkey con modalità cluster abilitata.
Visualizza l'endpoint di rilevamento della tua istanza
Per visualizzare l'endpoint di rilevamento della tua istanza, segui queste istruzioni:
gcloud
Per visualizzare l'endpoint di rilevamento della tua istanza, esegui l'interfaccia alla gcloud CLI describe
come spiegato in Visualizzare le informazioni sull'istanza.
L'output dovrebbe essere simile al seguente:
--location=us-central1 \
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
Prendi nota dell'indirizzo dell'endpoint e del numero di porta elencati nella sezione endpoints:
per la voce connectionType: CONNECTION_TYPE_DISCOVERY
. Questi due valori utilizzati insieme costituiscono 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 Compute Engine che utilizza la rete autorizzata dell'istanza Memorystore.
Per connetterti all'istanza:
Se non hai già una VM Linux Compute Engine che utilizza la rete autorizzata per l'istanza Memorystore for Valkey, creane una e connettiti seguendo la Guida rapida per creare una VM Linux.
Installa
valkey-cli
sulla VM di Compute Engine seguendo le istruzioni riportate in Installare Valkey.Visualizza l'endpoint di rilevamento della tua istanza e prendine nota.
Connettiti all'endpoint di rilevamento dell'istanza eseguendo il seguente 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.
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.Connettiti al nodo che preferisci 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 nel passaggio precedente.
Una volta connesso al nodo, inserisci alcuni comandi Valkey:
Digita:
PING
Risultato:
PONG
Invio
SET HELLO WORLD
Risultato:
OK
Digita:
GET HELLO
Risultato:
"WORLD"
Una volta terminato il test della connessione al nodo Valkey, ti consigliamo di eliminare la VM Compute Engine che hai utilizzato per connetterti all'istanza Valkey. In questo modo, eviterai di incorrere in addebiti sul tuo account di fatturazione Cloudg.
Connettiti a un'istanza con crittografia in transito abilitata
Questa sezione fornisce un esempio di come connettersi a un'istanza Memorystore for Valkey con modalità cluster abilitata che ha la crittografia in transito abilitata.
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.
- Installa
valkey-cli
versione 6.0 o successive sulla VM di Compute Engine seguendo le istruzioni riportate in Installare Valkey.
- Installa
Installa l'autorità di certificazione della tua istanza sulla VM Linux seguendo le istruzioni riportate in Installare le autorità di certificazione sul client.
Visualizza l'endpoint di rilevamento della tua istanza e prendine nota.
Connettiti all'endpoint di rilevamento dell'istanza eseguendo il seguente 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.
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.Connettiti al nodo che preferisci 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 nel passaggio precedente.
Dopo aver eseguito la connessione al nodo, inserisci i seguenti comandi Valkey:
Digita:
PING
Risultato:
PONG
Connettiti a un'istanza con la modalità cluster disattivata
Questa sezione spiega come connettersi a un'istanza Memorystore for Valkey con modalità cluster disattivata.
Visualizza l'endpoint principale e di lettura della tua istanza
Per visualizzare l'endpoint primario e di lettura della tua istanza, segui queste istruzioni:
gcloud
Per visualizzare l'endpoint principale e di lettura della tua istanza, esegui describe
gcloud CLI, come spiegato in Visualizzare le informazioni sull'istanza.
L'output dovrebbe essere simile al seguente:
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
Endpoint principale:prendi nota dell'indirizzo dell'endpoint e del numero di porta elencati in CONNECTION_TYPE_PRIMARY
nella sezione
endpoints:
. Questi due valori utilizzati insieme costituiscono l'endpoint principale dell'istanza.
Endpoint del lettore:prendi nota dell'indirizzo dell'endpoint e del numero di porta elencati in CONNECTION_TYPE_READER
nella sezione
endpoints:
. Questi due valori utilizzati insieme costituiscono l'endpoint del lettore della tua istanza.
Connettiti da una VM Compute Engine utilizzando valkey-cli
Puoi connetterti all'istanza Memorystore for Valkey da qualsiasi VM Compute Engine che utilizza la rete autorizzata dell'istanza Memorystore.
Per connetterti all'istanza:
Se non hai già una VM Linux Compute Engine che utilizza la rete autorizzata per l'istanza Memorystore for Valkey, creane una e connettiti seguendo la Guida rapida per creare una VM Linux.
Installa
valkey-cli
sulla VM di Compute Engine seguendo le istruzioni riportate in Installare Valkey.Visualizza l'endpoint principale e di lettura della tua istanza e prendine nota.
Connettiti all'endpoint principale della tua istanza eseguendo il seguente comando:
valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER
Dove:
- PRIMARY_ENDPOINT_ADDRESS e PORT_NUMBER sono i valori che hai annotato nel passaggio precedente.
Dopo aver eseguito la connessione al nodo primario, inserisci i seguenti comandi Valkey:
Digita:
PING
Risultato:
PONG
Invio
SET HELLO WORLD
Risultato:
OK
Digita:
GET HELLO
Risultato:
"WORLD"
Connettiti all'endpoint del lettore della tua istanza eseguendo il seguente comando:
valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER
Dove:
- READER_ENDPOINT_ADDRESS e PORT_NUMBER sono i valori che hai annotato nel passaggio precedente.
Dopo aver eseguito la connessione al nodo primario, inserisci i seguenti comandi Valkey Get:
Digita:
PING
Risultato:
PONG
Digita:
GET HELLO
Risultato:
"WORLD"
Dopo aver testato la connessione al nodo Valkey, devi eliminare la VM Compute Engine che hai utilizzato per connetterti all'istanza Valkey. In questo modo, eviti di incorrere in addebiti sul tuo account di fatturazione Cloudg.
Connettiti a un'istanza con crittografia in transito abilitata
Questa sezione fornisce un esempio di come connettersi a un'istanza di Memorystore for Valkey con modalità cluster disabilitata e crittografia in transito abilitata.
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.
- Installa
valkey-cli
versione 6.0 o successive sulla VM di Compute Engine seguendo le istruzioni riportate in Installare Valkey.
- Installa
Installa l'autorità di certificazione della tua istanza sulla VM Linux seguendo le istruzioni riportate in Installare le autorità di certificazione sul client.
Visualizza l'endpoint principale e di lettura della tua istanza e prendine nota.
Connettiti all'endpoint principale della tua istanza eseguendo il seguente comando:
valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls --cacert /tmp/server_ca.pem
Dove:
- PRIMARY_ENDPOINT_ADDRESS e PORT_NUMBER sono i valori che hai annotato nel passaggio precedente.
Connettiti all'endpoint del lettore della tua istanza eseguendo il seguente comando:
valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER --tls --cacert /tmp/server_ca.pem
Dove:
- READER_ENDPOINT_ADDRESS e PORT_NUMBER sono i valori che hai annotato nel passaggio precedente.
Una volta connesso al nodo, inserisci alcuni comandi Valkey:
Digita:
PING
Risultato:
PONG