IBM Cloud Docs
Connexion via l'interface de ligne de commande

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 stunnelqui enveloppe la connexion redis-cli dans un cryptage TLS.

Configuration de stunnel

  1. Installez stunnel. Utilisez votre gestionnaire de paquets pour Linux, Homebrew pour Mac, ou téléchargez le paquetage approprié pour votre plate-forme.

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

  3. 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
    
  4. Exécutez stunnel.

    Entrez la commande stunnel sur la ligne de commande. Elle s'exécute immédiatement en arrière-plan.

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

  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.