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 les fonctions de gestion des utilisateurs introduites dans Redis 6. 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.
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 . |
|
{ : caption=redis``cli connection information" caption-side="top"} |
0...
indique qu'il peut y avoir une ou plusieurs de ces entrées dans un tableau.
Installation de redli
redli
est un client de ligne de commande Redis open source. Il est autonome, imite les arguments de ligne de commande redis-cli et ajoute la prise en charge des connexions Redis TLS/SSL. 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.
Installation de redis-cli
redis-cli
est l'interface de ligne de commande officiellement prise en charge pour Redis. Malheureusement, elle ne prend pas en charge les connexions TLS.
Si vous choisissez d'utiliser redis-cli
, il y a quelques étapes de configuration supplémentaires. Cette interface est fournie dans le package Redis, par conséquent, vous devez installer Redis en local pour pouvoir l'utiliser. Sur
macOS,, installez brew et utilisez ensuite brew install redis
pour démarrer. Pour Linux, consultez le gestionnaire de paquets de votre distribution pour obtenir le
dernier paquetage Redis ou, si vous le souhaitez, téléchargez les sources et compilez-les vous-même.
Connexion avec redis-cli
redis-cli
ne prend pas en charge les connexions TLS. Si vous souhaitez utiliser le site redis-cli
avec une connexion cryptée, installez un utilitaire tel que stunnel
qui enveloppe la connexion redis-cli
dans un cryptage TLS.
Configuration de stunnel
-
Installez
stunnel
. Utilisez votre gestionnaire de paquets pour Linux, Homebrew pour Mac, ou téléchargez le paquetage approprié pour votre plate-forme. -
Récupérez les informations de connexion. Pour configurer une connexion,
stunnel
a besoin de l'hôte, du port et du certificat de votre déploiement Redis. L'hôte et le port sont disponibles dans la chaîne de connexion "composed" de l'interface de ligne de commande. Elles peuvent également être trouvées analysées dans la décomposition des chaînes de connexion qui est fournie pour connecter les applications et les pilotes externes.Le certificat se trouve dans le champ Base64 des informations de connexion de la lettre de créance du service. Copiez, décodez et sauvegardez le certificat dans un fichier.
-
Ajoutez vos informations de configuration au fichier
stunnel.conf
. La configuration comprend les informations suivantes :- Nom d'un service. (
[redis-cli]
) - Paramètre indiquant que cet utilitaire stunnel est un client TLS. (
client=yes
) - Une adresse IP et un numéro de port sur lesquels accepter les connexions (
accept=127.0.0.1:6830
) et établir les connexions. - Nom d'hôte et port auxquels établir la connexion. (
connect=
portal972-7.bmix-lon-yp-38898e17-ff6f-4340-9da8-2ba24c41e6d8.composeci-us-ibm-com.composedb.com:24370`) - Le chemin d'accès au certificat.
[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
- Nom d'un service. (
-
Exécutez
stunnel
.Entrez la commande
stunnel
sur la ligne de commande. Elle s'exécute immédiatement en arrière-plan. -
Dans une nouvelle fenêtre de terminal, exécutez
redis-cli
en pointant vers l'hôte local et le port, et authentifiez-vous avec les données d'identification du déploiement.redis-cli -p 6830 -a <PASSWORD>
Utilisation du certificat de propriété du service
- 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.
- Si besoin, décodez la chaîne Base64 en texte.
- Sauvegardez le certificat dans un fichier. (Vous pouvez utiliser le nom qui est fourni ou votre propre nom de fichier.)
- 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.