IBM Cloud Docs
Conectando por meio da interface da linha de comandos (CLI)

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 stunnelque envolve a conexão redis-cli em criptografia TLS.

Configurando stunnel

  1. Instale o stunnel. Use seu gerenciador de pacotes para Linux, Homebrew para Mac ou baixe o pacote apropriado para sua plataforma.

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

  3. 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
    
  4. Execute o stunnel.

    Digite o comando stunnel na linha de comandos. Ele é executado imediatamente em segundo plano.

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

  1. Copie as informações do certificado do painel Endpoints ou do campo Base64 das informações de conexão da credencial de serviço.
  2. Se necessário, decodifique a sequência Base64 em texto.
  3. Salve o certificado em um arquivo. (É possível usar o nome fornecido ou o seu próprio nome do arquivo).
  4. 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.