Connexion via l'interface de ligne de commande

Accédez à votre base de données Redis directement à partir d'une interface de ligne de commande (CLI). L'interface de programmation permet d'interagir directement avec les structures de données créées dans la base de données et de les contrôler. Il est également utile pour administrer et surveiller l'espace de clés et les performances, installer et modifier des scripts, et pour d'autres activités de gestion.

Le client redli doit être mis à jour pour intégrer les fonctionnalités de gestion des utilisateurs introduites dans le document Redis. Si vous essayez de vous connecter sans mettre à jour le client, vous verrez apparaître une erreur du type : (error) WRONGPASS invalid username-password pair.

chaînes de connexion

Les chaînes de connexion sont affichées dans le panneau Endpoints de la page Overview de votre déploiement et peuvent également être récupérées à partir du plug-in CLI Cloud Databases et de l'API Cloud Databases.

Les informations dont les clients ont besoin pour se connecter à votre déploiement se trouvent dans la section "CLI" d'un justificatif d'identité créé sur la page Service credentials. Le tableau ci-après est fourni à titre de référence.

redis informations sur la connexion /cli
Nom de zone Index Description
Bin Le binaire recommandé pour créer une connexion ; dans ce cas, il s'agit de redli.
Composed Commande formatée pour établir une connexion à votre déploiement. La commande combine l'exécutable Bin, les paramètres de la variable Environment et utilise Arguments comme paramètres de ligne de commande.
Environment Liste de clés/valeurs que vous définissez en tant que variables d'environnement.
Arguments 0... Informations qui sont transmises en tant qu'arguments à la commande affichée dans la zone Bin.
Certificate Base64 Certificat propriétaire de service utilisé pour confirmer qu'une application se connecte au serveur approprié. Il est encodé en base64.
Certificate Nom Nom attribué au certificat propriétaire du service.
Type Type de package qui utilise ces informations de connexion ; en l'occurrence, cli.
  • 0... indique qu'il peut y avoir une ou plusieurs de ces entrées dans un tableau.

Installation de redis-cli

redis-cli est l'interface de ligne de commande officiellement prise en charge pour Redis. Si vous souhaitez utiliser redis-cli, vous devez effectuer quelques étapes de configuration supplémentaires.

redis-cli fait partie du paquetage Redis, il faut donc d'abord installer Redis localement. Sur macOS,, installez brew et utilisez ensuite brew install redis pour démarrer. Sur Linux, consultez le gestionnaire de paquets de votre distribution pour obtenir le dernier paquetage Redis ou, si vous préférez, téléchargez les sources et compilez-les vous-même.

Installation de redli

redli est un client de ligne de commande Redis open source. Il est autonome, imite les arguments de la ligne de commande redis-cli, et ajoute la prise en charge des connexions TLS/SSL Redis. Il reconnaît le protocole rediss: dans les URI et prend en charge une option --tls pour les connexions non URI. Il peut se connecter à Redis TLS/SSL sans nécessiter de tunnels. Téléchargez-le et installez-le à partir de la page des éditions.

Connexion avec redli

La commande ibmcloud cdb deployment-connections gère tout ce qui est impliqué dans le processus de création d'une connexion de client. Par exemple, pour vous connecter à un déploiement nommé "NewRedis", utilisez la commande suivante :

ibmcloud cdb deployment-connections NewRedis --start

ou

ibmcloud cdb cxn NewRedis -s

La commande demande le mot de passe admin et exécute ensuite le client de ligne de commande redli pour se connecter à la base de données.

Si vous n'avez pas installé le plug-in Cloud Databases, connectez-vous à vos bases de données Redis à l'aide de redli. Téléchargez et sauvegardez le certificat propriétaire du service à partir de votre déploiement. Ensuite, utilisez redli en lui donnant la chaîne de connexion "composée" et le chemin d'accès au certificat propriétaire du service.

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

Il existe d'autres options et paramètres de connexion pris en charge par redli. Pour plus d'informations, consultez sa documentation sur le site redli GitHub repo.

Utilisation du certificat de propriété du service

  1. Copiez les informations relatives au certificat à partir du panneau Endpoints ou du champ Base64 des informations de connexion de la lettre de créance de service.
  2. Si besoin, décodez la chaîne Base64 en texte.
  3. Sauvegardez le certificat dans un fichier. (Vous pouvez utiliser le nom qui est fourni ou votre propre nom de fichier.)
  4. Indiquez le chemin d'accès au certificat au pilote ou au client.

Prise en charge du plug-in CLI pour le certificat propriétaire du service

Vous pouvez afficher le certificat décodé pour votre déploiement avec le plug-in CLI à l'aide d'une commande comme :

ibmcloud cdb deployment-cacert <INSTANCE_NAME_OR_CRN>

Cette commande décode le site Base64 en texte. Copiez et sauvegardez le résultat de la commande dans un fichier et indiquez le chemin du fichier au client.