Conexión a través de la interfaz de línea de mandatos (CLI)

Acceda a la base de datos Redis directamente desde una interfaz de línea de mandatos (CLI). La CLI permite la interacción directa y la supervisión de las estructuras de datos que se crean dentro de la base de datos. También es útil para administrar y supervisar el espacio de claves y el rendimiento, para instalar y modificar scripts y para otras actividades de gestión.

Es necesario actualizar el cliente redli para las funciones de gestión de usuarios introducidas en Redis. Si intenta conectarse a sin actualizar el cliente, verá un error como: (error) WRONGPASS invalid username-password pair.

Series de conexión

Las cadenas de conexión se muestran en el panel Endpoints de la página Overview de la implantación y también se pueden recuperar desde el complemento CLI Cloud Databases y la API Cloud Databases.

La información que necesitan los clientes para conectarse a su despliegue se encuentra en la sección "CLI" de una credencial creada en la página Credenciales de servicio. La tabla contiene un desglose para referencia.

redis /cli información de conexión
Nombre de campo Índice Descripción
Bin El binario recomendado para crear una conexión; en este caso es redli.
Composed Un mandato con formato para establecer una conexión con el despliegue. El mandato combina el ejecutable Bin, los valores de variable Environment y utiliza Arguments como parámetros de línea de mandatos.
Environment Una lista de claves/valores que ha establecido como variables de entorno.
Arguments 0... La información que se pasa como argumentos al mandato que se muestra en el campo Bin.
Certificate Base64 Certificado propietario de un servicio que se utiliza para confirmar que una aplicación se está conectando al servidor adecuado. Está codificado en base64.
Certificate Nombre El nombre asignado para el certificado propietario del servicio.
Type El tipo de paquete que utiliza esta información de conexión; en este caso cli.
  • 0... indica que puede haber una o varias de estas entradas en una matriz.

Instalación del redis-cli

redis-cli es la interfaz de línea de mandatos soportada oficial para Redis. Si desea utilizar redis-cli, deberá realizar algunos pasos de configuración adicionales.

redis-cli viene como parte del paquete Redis, así que primero instale Redis localmente. En macOS, instala brew y luego usa brew install redis para ponerte en marcha. En Linux, consulte el gestor de paquetes de su distribución para obtener el último paquete Redis o, si lo prefiere, descargue el código fuente y compílelo usted mismo.

Instalación del redli

redli es un cliente de línea de mandatos de Redis de código abierto. Es independiente, imita los argumentos de comando redis-cli y añade soporte para conexiones TLS/SSL Redis. Reconoce el protocolo rediss: en los URI y admite el distintivo --tls para conexiones que no son URI. Puede conectarse a Redis protegido mediante TLS/SSL sin necesidad de túneles. Descárguelo e instálelo desde la página de releases.

Conexión con redli

El mandato ibmcloud cdb deployment-connections maneja todo lo necesario para crear una conexión de cliente. Por ejemplo, para conectarse a un despliegue denominado "NewRedis", utilice el mandato siguiente.

ibmcloud cdb deployment-connections NewRedis --start

o

ibmcloud cdb cxn NewRedis -s

El comando solicita la contraseña de admin y, a continuación, ejecuta el cliente comando redli para conectarse a la base de datos.

Si no ha instalado el plugin de Cloud Databases, puede conectarse a las bases de datos de Redis con el mandato redli. Descargue y guarde el certificado propietario del servicio de su implantación. A continuación, utilice redli dándole la cadena de conexión "compuesta" y la ruta al certificado propietario del servicio.

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

Hay otras opciones de conexión y parámetros que redli admite. Para más información, consulte su documentación en el repositorio redli GitHub.

Utilización del certificado propietario del servicio

  1. Copie la información del certificado del panel Endpoints o del campo Base64 de la información de conexión de la credencial de servicio.
  2. Si es necesario, decodifique la serie Base64 en texto.
  3. Guarde el certificado en un archivo. (Puede utilizar el Nombre que se proporciona o un nombre de archivo de su elección).
  4. Proporcione al controlador o al cliente la vía de acceso al certificado.

Compatibilidad del complemento CLI con el certificado propietario del servicio

Puede mostrar el certificado descodificado para su despliegue con el complemento CLI con un comando como:

ibmcloud cdb deployment-cacert <INSTANCE_NAME_OR_CRN>

Este comando descodifica el Base64 en texto. Copie y guarde la salida del mandato en un archivo y proporcione la vía de acceso del archivo al cliente.