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 em Redis. 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.

redis informações de conexão /cli
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.
  • 0... indica que pode haver uma ou mais dessas entradas em uma matriz.

Instalando redis-cli

A redis-cli é a interface da linha de comandos suportada oficial para o Redis. Se você quiser usar redis-cli, há algumas etapas adicionais de configuração a serem concluídas.

redis-cli vem como parte do pacote Redis, portanto, primeiro instale o Redis localmente. 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.

Instalando redli

O redli é um cliente da linha de comando de software livre do Redis. Ele é autônomo, imita os argumentos da linha de comando redis-cli e adiciona suporte a conexões TLS/SSL 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.

Usando o certificado de propriedade do serviço

  1. Copie as informações do certificado do painel Pontos de extremidade 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.