Connessione tramite la CLI (command - line interface)

Accedi al tuo database Redis direttamente da una CLI (command - line interface). La CLI consente l'interazione diretta e il monitoraggio delle strutture dati create nel database. È utile anche per amministrare e monitorare il keyspace e le prestazioni, l'installazione e la modifica degli script e altre attività di gestione.

Il client redli deve essere aggiornato per le funzionalità di gestione degli utenti introdotte in Redis. Se tenti di connetterti senza aggiornare il client, visualizzi un errore come: (error) WRONGPASS invalid username-password pair.

Stringhe di connessione

Le stringhe di connessione sono visualizzate nel pannello 'Punti finali della pagina 'Panoramica dell'installazione client e possono essere recuperate anche da 'plug-in CLI Cloud Databases e 'Cloud Databases API.

Le informazioni di cui i client hanno bisogno per connettersi all'installazione client si trovano nella sezione "CLI" di una credenziale creata nella pagina Credenziali del servizio. La tabella contiene una ripartizione per riferimento.

redis informazioni sulla connessione /cli
Nome campo Indice Descrizione
Bin Il binario consigliato per creare una connessione; in questo caso è redli.
Composed Un comando formattato per stabilire una connessione alla tua distribuzione. Il comando combina l'eseguibile Bin, le impostazioni delle variabili Environment e utilizza Arguments come parametri della riga di comando.
Environment Un elenco di chiavi/valori impostati come variabili d'ambiente.
Arguments 0... Le informazioni che vengono passate come argomenti al comando, visualizzate nel campo Bin.
Certificate Base64 Un certificato proprietario del servizio che viene utilizzato per confermare che un'applicazione si sta connettendo al server appropriato. Ha una codifica base64.
Certificate Nome Il nome assegnato per il certificato proprietario del servizio.
Type Il tipo di pacchetto che utilizza queste informazioni di connessione; in questo caso cli.
  • 0... indica che in un array potrebbero essere presenti una o più di queste voci.

Installazione redis-cli

redis-cli è l'interfaccia a riga di comando ufficiale supportata da Redis. Se si desidera utilizzare redis-cli, è necessario completare alcuni passaggi di configurazione aggiuntivi.

redis-cli viene fornito come parte del pacchetto Redis, quindi installate prima Redis in locale. Su macOS, installate brew e poi usate brew install redis per iniziare a funzionare. Su Linux, fare riferimento al gestore dei pacchetti della propria distribuzione per trovare il pacchetto Redis più recente o, se si preferisce, scaricare il sorgente e compilarlo da soli.

Installazione redli

redli è un client di riga di comando open source Redis. È autonomo, imita gli argomenti della riga di comando redis-cli e aggiunge il supporto per le connessioni TLS/SSL Redis. Riconosce il protocollo rediss: negli URI e supporta un indicatore --tls per connessioni non URI. Può connettersi a Redis protetto da TLS/SSL senza bisogno di tunnel. Scaricarlo e installarlo dalla pagina delle release.

Connessione con redli

Il comando ibmcloud cdb deployment-connections gestisce tutto ciò che è coinvolto nella creazione della connessione client. Ad esempio, per connettersi a un'installazione client denominata "NewRedis", utilizzare il seguente comando.

ibmcloud cdb deployment-connections NewRedis --start

oppure

ibmcloud cdb cxn NewRedis -s

Il comando richiede la parola d'ordine admin ed esegue il client della riga comandi redli per connettersi al database.

Se non è stato installato il plug-in dei database cloud, collegarsi ai database Redis con il comando redli. Scaricare e salvare il certificato proprietario del servizio dalla propria installazione. Quindi, utilizzare redli dandogli la stringa di connessione "composta" e il percorso del certificato proprietario del servizio.

redli --uri rediss://admin:$PASSWORD@e6b2c3f8-54a6-439e-8d8a-aa6c4a78df49.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:32371/0 --certfile /path/to/redis-cert.pem

Ci sono altre opzioni di connessione e parametri supportati da redli. Per ulteriori informazioni, vedi la sua documentazione nel repository redli GitHub.

Utilizzo del certificato proprietario del servizio

  1. Copiare le informazioni del certificato dal pannello Endpoints o dal campo Base64 delle informazioni di connessione della credenziale del servizio.
  2. Se necessario, decodificare la stringa Base64 in testo.
  3. Salvare il certificato in un file. (È possibile utilizzare il nome fornito o il proprio nome di file).
  4. Fornire il percorso del certificato al driver o al client.

Supporto del plug-in CLI per il certificato proprietario del servizio

È possibile visualizzare il certificato decodificato per l'installazione con il plug-in CLI con un comando come:

ibmcloud cdb deployment-cacert <INSTANCE_NAME_OR_CRN>

Questo comando decodifica la Base64 in testo. Copiare e salvare l'output del comando in un file e fornire il percorso del file al client.