Connettiti a un'istanza Redis

Questa pagina descrive come connetterti all'istanza Redis utilizzando Telnet e redis-cli. Inoltre, questa pagina fornisce istruzioni su come eseguire la connessione quando si utilizzano funzionalità come le repliche di lettura, AUTH e la crittografia in transito. Infine, questa pagina fornisce istruzioni per la connessione da un ambiente Google Kubernetes Engine.

Per un elenco degli ambienti Google Cloud supportati da Memorystore per Redis, consulta Ambienti supportati. Alcuni ambienti serverless supportati da Memorystore richiedono un connettore di accesso VPC serverless. Per ulteriori dettagli, consulta il Requisito del connettore di accesso VPC serverless.

Connessione a un'istanza Redis da una VM Compute Engine utilizzando telnet

Puoi connetterti all'istanza Redis da qualsiasi VM Compute Engine che utilizza la rete autorizzata dell'istanza Redis con un indirizzo IP RFC 1918 supportato.

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

  2. Installa telnet utilizzando apt-get:

    sudo apt-get install telnet
    
  3. Nel terminale, inserisci il comando telnet seguito dall'indirizzo IP dell'istanza Redis, sostituendo variables con i valori appropriati.

    telnet instance-ip-address 6379
    

    In caso di esito positivo, il comando restituirà questo risultato:

    Trying instance-ip-address…
    Connected to instance-ip-address
    
  4. Nella sessione di Telnet, inserisci alcuni comandi Redis:

    Digita:

    PING
    

    Risultato:

    PONG
    

    Invio

    SET HELLO WORLD
    

    Risultato:

    +OK
    

    Digita:

    GET HELLO
    

    Risultato:

    $5
    WORLD
    

Connessione a un'istanza Redis da una VM Compute Engine utilizzando redis-cli

Puoi connetterti all'istanza Redis da qualsiasi VM Compute Engine che utilizza la rete autorizzata dell'istanza Redis con un indirizzo IP RFC 1918 supportato.

  1. Se non hai già una VM di Compute Engine che utilizza la rete autorizzata per la tua istanza Redis, creane una e connettiti seguendo la procedura descritta in Creare un'istanza VM in una sottorete specifica.

  2. Installa redis-cli sulla VM Compute Engine eseguendo il seguente comando dal terminale SSH di Compute Engine:

    sudo apt-get install redis-tools
    
  3. Esegui il seguente comando nel terminal di Compute Engine, sostituendo variables con i valori appropriati.

    redis-cli -h redis-instance-ip-address
    

    Ora sei connesso all'istanza Redis utilizzando redis-cli.

  4. Una volta completato il test della connessione all'istanza Redis, ti consigliamo di eliminare la VM Compute Engine utilizzata per connetterti all'istanza Redis. In questo modo, eviterai di incorrere in addebiti sul tuo account di fatturazione Cloud.

Connessione a un'istanza Redis che utilizza AUTH

Questa sezione descrive come connettersi a un'istanza Redis in cui è attivata la funzionalità AUTH.

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

  2. Installa redis-cli sulla VM Compute Engine eseguendo il seguente comando dal terminale SSH di Compute Engine:

    sudo apt-get install redis-tools
    
  3. Ottieni la stringa AUTH dell'istanza

  4. Esegui il seguente comando per utilizzare redis-cli per autenticarti e connetterti alla tua istanza, sostituendo variables con i valori appropriati:

    redis-cli -h instance-ip-address -a auth-string
    

    In alternativa:

    redis-cli -h instance-ip-address
    AUTH auth-string
    
  5. Esegui un comando SET e GET di Redis per verificare di aver stabilito una connessione autenticata all'istanza.

  6. Una volta completato il test della connessione all'istanza Redis, ti consigliamo di eliminare la VM Compute Engine utilizzata per connetterti all'istanza Redis. In questo modo, eviterai di incorrere in addebiti sul tuo account di fatturazione Cloud.

Connessione a un'istanza Redis utilizzando l'endpoint di lettura

Se nella tua istanza sono attivate le repliche di lettura, puoi connetterti all'endpoint di lettura seguendo le istruzioni riportate di seguito:

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

  2. Installa telnet utilizzando apt-get:

    sudo apt-get install telnet
    
  3. Trova l'indirizzo IP dell'endpoint di lettura dell'istanza visualizzando le informazioni sulla replica di lettura per l'istanza.

  4. Nel terminale, inserisci il comando telnet seguito dall'indirizzo IP dell'endpoint di lettura dell'istanza Redis, sostituendo variables con i valori appropriati.

    telnet read-endpoint-ip 6379
    

    In caso di esito positivo, il comando restituirà questo risultato:

    Trying read-endpoint-ip…
    Connected to read-endpoint-ip
    
  5. Nella sessione di Telnet, inserisci alcuni comandi Redis:

    Digita:

    PING
    

    Risultato:

    PONG
    

Connessione sicura a un'istanza Redis utilizzando Stunnel e telnet

Questa sezione fornisce un esempio di come connettersi a un'istanza Redis in cui è attivata la crittografia dei dati in transito utilizzando Stunnel.

  1. Se non hai già un'istanza Redis con la crittografia in transito attivata, creane una seguendo la procedura descritta in Creare un'istanza Redis con crittografia in transito.

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

    1. Installa gli strumenti necessari per questa guida eseguendo i seguenti comandi:

      sudo apt-get install stunnel4
      
      sudo apt-get install telnet
      
  3. Configura la VM Compute Engine per l'utilizzo con Stunnel:

    1. Crea un nuovo file in cui inserire la tua autorità di certificazione (CA) eseguendo il seguente comando:

      sudo vim /tmp/server_ca.pem
      
    2. Visualizza le autorità di certificazione dell'istanza Redis eseguendo il seguente comando nel terminale standard che utilizzi per gestire le risorse Google Cloud (non il terminale Compute Engine):

      gcloud redis instances describe instance-id --region=region
      

      Possono essere presenti fino a tre CA.

    3. Copia tutte le autorità di certificazione visibili, incluse le righe -----BEGIN CERTIFICATE----- e -----END CERTIFICATE-----, incollale e salvale nel file server_ca.pem creato in precedenza.

    4. Crea un nuovo file in cui inserire le informazioni di configurazione di Stunnel eseguendo il seguente comando:

      sudo vim /etc/stunnel/redis-client.conf
      

      Incolla il seguente testo nel file, sostituendo redis-instance-ip con l'indirizzo IP dell'istanza Redis:

      output=/tmp/stunnel.log
      CAfile=/tmp/server_ca.pem
      client=yes
      pid=/var/run/stunnel.pid
      verifyChain=yes
      sslVersion=TLSv1.2
      [redis]
      accept=127.0.0.1:6378
      connect=redis-instance-ip:6378
      

      Avvia stunnel eseguendo il seguente comando:

      sudo stunnel /etc/stunnel/redis-client.conf
      

      Verifica che stunnel sia in esecuzione:

      ps aux | grep stunnel
      

    5. Riavviare Stunnel eseguendo i seguenti comandi:

      sudo systemctl restart stunnel4
      
  4. Per connetterti all'istanza Redis utilizzando Telnet, esegui il seguente comando:

    telnet localhost 6378
    
  5. Nella sessione Telnet, esegui un ping all'istanza Redis:

    Digita:

    PING
    

    Risultato:

    PONG
    

Connessione da una macchina locale con il port forwarding

Può essere utile connetterti all'istanza Redis dalla tua macchina locale durante lo sviluppo. Per farlo, devi creare un'istanza Compute Engine da utilizzare per il port forwarding all'istanza Redis.

  1. Crea un'istanza Compute Engine eseguendo il seguente comando:

    gcloud compute instances create COMPUTE_VM_NAME --machine-type=f1-micro --zone=ZONE
    

    Dove:

    • COMPUTE_VM_NAME è il nome che assegni alla VM Compute Engine.
    • ZONE è la zona in cui vuoi eseguire il provisioning della VM.

    Questo comando crea una VM Compute Engine con il f1-microtipo di macchina per l'economicità. Se vuoi, puoi scegliere altri tipi di macchine.

  2. Apri un nuovo terminale sulla tua macchina locale.

  3. Per creare un tunnel SSH che inoltra il traffico tramite la VM Compute Engine, esegui il seguente comando:

    gcloud compute ssh COMPUTE_VM_NAME --zone=ZONE -- -N -L 6379:REDIS_INSTANCE_IP_ADDRESS:6379
    

    Dove:

    • COMPUTE_VM_NAME è il nome della VM Compute Engine.
    • ZONE è la stessa zona in cui si trova la VM Compute Engine.
    • REDIS_INSTANCE_IP_ADDRESS è l'indirizzo IP della tua istanza Redis.
  4. Per testare la connessione, apri una nuova finestra del terminale ed esegui il seguente comando:

    redis-cli ping
    

    Se funziona correttamente, il risultato dovrebbe restituire:

    PONG
    

    Ora sei connesso all'istanza Redis e puoi inviare comandi all'istanza Redis utilizzando questo tunnel SSH aperto. Se non hai ancora installatoredis-cli, installalo per poter eseguire questo comando.

  5. Il tunnel SSH rimane aperto finché mantieni attiva la finestra del terminale con la connessione del tunnel SSH.

Connessione a un'istanza Redis da un cluster Google Kubernetes Engine

Puoi connetterti all'istanza Redis dai cluster Google Kubernetes Engine che utilizzano la stessa rete autorizzata dell'istanza Redis.

Connessione da un pod che esegue una shell bash

  1. Vai alla pagina GKE nella console Google Cloud.
    GKE
  2. Fai clic sul cluster GKE da cui vuoi connetterti. Se non hai già un cluster, creane uno con gli alias IP abilitati. Per istruzioni su come creare un cluster con gli alias IP abilitati, consulta la sezione Creare un cluster nativo di VPC.
  3. Fai clic sul pulsante Connetti a destra del nome del cluster, quindi fai clic sul pulsante Esegui in Cloud Shell nella finestra visualizzata.
  4. Configura l'accesso alla riga di comando kubectl eseguendo il seguente comando:
    gcloud container clusters get-credentials CLUSTER_NAME --zone=CLUSTER_ZONE --project=PROJECT_ID
    • CLUSTER_NAME è il nome del cluster.
    • CLUSTER_ZONE è la zona in cui si trova il cluster. Deve essere anche la zona in cui si trova l'istanza Redis.
    • PROJECT_ID è il progetto in cui si trovano il cluster e le istanze Redis.
    Dovresti visualizzare il messaggio di operazione riuscita: kubeconfig generated for CLUSTER_NAME
  5. Se il tuo cluster è della versione 1.8 o successiva e ha gli alias IP abilitati, salta questo passaggio. Se il tuo cluster è versione 1.7 o precedente o se il tuo cluster versione 1.8 o successiva non ha gli alias IP abilitati, segui questa procedura di risoluzione dei problemi prima di provare a connetterti all'istanza: Per ulteriori informazioni sugli alias IP, inclusa la creazione di un cluster con questa impostazione abilitata, consulta Creare un cluster nativo di VPC.
  6. Utilizza il seguente comando per connetterti a una shell bash:
    kubectl run -i --tty busybox --image=busybox -- sh
  7. Esegui Telnet all'istanza Redis utilizzando l'indirizzo host e il numero di porta:
    telnet HOST-IP PORT
  8. Inserisci un comando Redis di base per verificare la connessione:
    PING
    +PONG
  9. Per chiudere la connessione telnet, premi Ctrl+C (o Comando+C su Mac). Per uscire dalla shell bash nel pod, inserisci return. Se hai finito e non hai più bisogno di connetterti a Redis, esegui il seguente comando dalla directory /k8s-custom-iptables/:
    ./uninstall.sh

Connessione a un'istanza Redis da un pod Google Kubernetes Engine

Prima di iniziare, devi disporre di un cluster GKE. Se non hai già un cluster, creane uno con gli alias IP abilitati. Per istruzioni su come creare un cluster con gli alias IP abilitati, consulta Creare un cluster nativo di VPC.

  1. Nell'angolo in alto a destra della console, fai clic sul pulsante Attiva Cloud Shell Attiva Cloud Shell.
  2. Configura l'accesso alla riga di comando kubectl eseguendo il seguente comando:
    gcloud container clusters get-credentials CLUSTER_NAME --zone CLUSTER_ZONE --project PROJECT_ID
    • CLUSTER_NAME è il nome del cluster.
    • CLUSTER_ZONE è la zona in cui si trova il cluster. Deve essere anche la zona in cui si trova l'istanza Redis.
    • PROJECT_ID è il progetto in cui si trovano il cluster e le istanze Redis.
    Dovresti visualizzare il messaggio di operazione riuscita: kubeconfig generated for CLUSTER_NAME
  3. Se il tuo cluster è della versione 1.8 o successiva e ha gli alias IP abilitati, salta questo passaggio. Se il tuo cluster è versione 1.7 o precedente o se il tuo cluster versione 1.8 o successiva non ha gli alias IP abilitati, segui questa procedura di risoluzione dei problemi prima di provare a connetterti all'istanza: Per ulteriori informazioni sugli alias IP, inclusa la creazione di un cluster con questa impostazione abilitata, consulta Creare un cluster nativo di VPC.
  4. Utilizza il seguente comando per avviare un pod Redis che esegue redis-cli:
    kubectl run -i --tty redisbox --image=gcr.io/google_containers/redis:v1 -- sh
  5. Esegui un comando redis-cli, sostituendo HOST-IP con l'indirizzo IP dell'host dell'istanza Redis:
    redis-cli -h HOST-IP info
  6. Se vuoi, esegui un comando di benchmark Redis, sostituendo ancora una volta HOST-IP con l'indirizzo IP dell'host dell'istanza Redis:
    redis-benchmark -c 100 -n 100000 -d 1024 -r 100000 -t PING,SET,GET,INCR,LPUSH,RPUSH,LPOP,RPOP,SADD,SPOP,MSET -h HOST-IP -q
  7. Per uscire dal pod Redis, inserisci return. Se hai finito e non hai più bisogno di connetterti a Redis, esegui il seguente comando dalla directory /k8s-custom-iptables/:
    ./uninstall.sh

Passaggi successivi

Connettiti all'istanza Redis utilizzando un'applicazione di esempio che funziona su: