Conectando por meio da interface da linha de comandos (CLI)
Acesse o seu banco de dados Redis diretamente de uma interface da linha de comandos (CLI). A CLI permite a interação direta e o monitoramento das estruturas de dados que são criadas no banco de dados. Também é útil para administrar e monitorar o keyspace e o desempenho, instalar e modificar scripts, além de outras atividades de gerenciamento.
O cliente redli
precisa ser atualizado para os recursos de gerenciamento de usuários introduzidos no Redis 6.. Se você tentar se conectar sem
atualizar o cliente, verá um erro como: (error) WRONGPASS invalid username-password pair
.
sequências de conexões
As cadeias de conexão são exibidas no painel Endpoints da página Overview (Visão geral) da sua implantação e também podem ser recuperadas no plug-in Cloud Databases CLI e na API Cloud Databases.
As informações de que os clientes precisam para se conectar à sua implantação estão na seção "CLI" de uma credencial criada na página Credenciais de serviço. A tabela contém um detalhamento para referência.
Nome do campo | Index | Descrição |
---|---|---|
Bin |
O binário recomendado para a criação de uma conexão; nesse caso, redli . |
|
Composed |
Um comando formatado para estabelecer uma conexão com a sua implementação. O comando combina o executável Bin , as configurações da variável Environment e usa Arguments como parâmetros da linha de
comandos. |
|
Environment |
Uma lista de chaves/valores configurados como variáveis de ambiente. | |
Arguments |
0... | As informações transmitidas como argumentos para o comando mostrado no campo Bin. |
Certificate |
Base64 | Um certificado proprietário de serviço usado para confirmar que um aplicativo está se conectando ao servidor apropriado. Ele é codificado em base64. |
Certificate |
Nome | O nome alocado para o certificado de propriedade do serviço. |
Type |
O tipo de pacote que usa essas informações de conexão; neste caso, cli . |
|
{: caption=redis``cli connection information" caption-side="top"} |
0...
indica que pode haver uma ou mais dessas entradas em uma matriz.
Instalando redli
O redli
é um cliente da linha de comando de software livre do Redis. Ele é independente, imita os argumentos da linha de comandos de redis-cli e inclui suporte para as conexões TLS/SSL do Redis. Ele reconhece o protocolo rediss:
em URIs e suporta uma sinalização --tls
para conexões não URI. Ele pode se conectar ao Redis assegurado por TLS/SSL sem a necessidade de túneis. Faça download e instale-o a partir da página de releases.
Conectando-se com redli
O comando ibmcloud cdb deployment-connections
manipula tudo o que está envolvido na criação da conexão do cliente. Por exemplo, para se conectar a uma implementação denominada "NewRedis", use o comando a seguir.
ibmcloud cdb deployment-connections NewRedis --start
ou
ibmcloud cdb cxn NewRedis -s
O comando solicita a senha admin
e, em seguida, executa o cliente de linha de comando redli
para se conectar ao banco de dados.
Se você não tiver instalado o plug-in de bancos de dados em nuvem, conecte-se aos bancos de dados do Redis com o comando redli
. Faça o download e salve o certificado de propriedade do serviço de sua implantação. Em seguida, use
redli
, fornecendo a ele a string de conexão "composta" e o caminho para o certificado proprietário do serviço.
redli --uri rediss://admin:$PASSWORD@e6b2c3f8-54a6-439e-8d8a-aa6c4a78df49.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:32371/0 --certfile /path/to/redis-cert.pem
Há outras opções e parâmetros de conexão suportados pelo redli
. Para obter mais informações, consulte a documentação no repositório redli
GitHub.
Instalando redis-cli
A redis-cli
é a interface da linha de comandos suportada oficial para o Redis. Infelizmente, ela não suporta conexões TLS.
Se você optar por usar redis-cli
, há algumas etapas adicionais de configuração. Ela é fornecida como parte do pacote do Redis, portanto, o Redis precisa estar instalado localmente para usá-la. Em macOS,, instale o brew e use brew install redis
para começar a funcionar. Em Linux, consulte o gerenciador de pacotes de sua distribuição para obter o pacote Redis mais recente ou, se preferir, faça o download do código-fonte e compile-o você mesmo.
Conectando-se com redis-cli
A redis-cli
não suporta conexões ativadas pelo TLS. Se quiser usar o redis-cli
com uma conexão criptografada, configure um utilitário como o stunnel
que
envolve a conexão redis-cli
em criptografia TLS.
Configurando stunnel
-
Instale o
stunnel
. Use seu gerenciador de pacotes para Linux, Homebrew para Mac ou baixe o pacote apropriado para sua plataforma. -
Capture informações de conexão. Para configurar uma conexão, o
stunnel
precisa do host, da porta e do certificado de sua implementação do Redis. O host e a porta estão disponíveis na sequência de conexões "editada" da CLI. Elas também podem ser encontradas analisadas no Connection Strings Breakdown, que é fornecido para conectar aplicativos e drivers externos.O certificado está no campo Base64 das informações de conexão da credencial de serviço. Copie, decodifique e salve o certificado em um arquivo.
-
Inclua suas informações de configuração no arquivo
stunnel.conf
. A configuração inclui as informações a seguir.- Um nome para um serviço. (
[redis-cli]
) - Uma configuração que diz que este stunnel é um cliente TLS. (
client=yes
) - Um endereço IP e uma porta para aceitar conexões em (
accept=127.0.0.1:6830
) e conectar. - O nome do host e a porta para conexão. (
connect=
portal972-7.bmix-lon-yp-38898e17-ff6f-4340-9da8-2ba24c41e6d8.composeci-us-ibm-com.composedb.com:24370`) - O caminho para o certificado.
[redis-cli] client=yes accept=127.0.0.1:6830 connect=sl-us-south-1-portal.7.dblayer.com:23870 verify=2 checkHost=sl-us-south-1-portal.7.dblayer.com CAfile=/path/to/redis/cert.crt
- Um nome para um serviço. (
-
Execute o
stunnel
.Digite o comando
stunnel
na linha de comandos. Ele é executado imediatamente em segundo plano. -
Em uma nova janela do terminal, execute
redis-cli
apontando para o host e a porta locais e autentique-se com as credenciais da implementação.redis-cli -p 6830 -a <PASSWORD>
Usando o certificado de propriedade do serviço
- Copie as informações do certificado do painel Endpoints ou do campo Base64 das informações de conexão da credencial de serviço.
- Se necessário, decodifique a sequência Base64 em texto.
- Salve o certificado em um arquivo. (É possível usar o nome fornecido ou o seu próprio nome do arquivo).
- Forneça o caminho do certificado para o driver ou o cliente.
Suporte ao plug-in da CLI para o certificado proprietário do serviço
Você pode exibir o certificado decodificado para sua implantação com o plug-in da CLI com um comando como:
ibmcloud cdb deployment-cacert <INSTANCE_NAME_OR_CRN>
Esse comando decodifica o endereço Base64 em texto. Copie e salve a saída do comando em um arquivo e forneça o caminho do arquivo para o cliente.