For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/public-cloud/databases/valkey-connect-cli.md.

Se connecter avec la CLI au service Public Cloud Databases pour Valkey

Voir en Markdown

Connectez-vous à votre service Public Cloud Databases pour Valkey à l'aide de l'interface en ligne de commande (CLI)

Objectif

Public Cloud Databases vous permet de vous concentrer sur la création et le déploiement de vos applications cloud, pendant qu'OVHcloud prend en charge l'infrastructure de base de données et son maintien en conditions opérationnelles.

Ce guide explique comment se connecter à une instance de service Valkey avec une interface en ligne de commande (CLI).

Prérequis

Concept

Un service Valkey peut être géré de plusieurs façons. L'une des plus simples, mais aussi des plus puissantes, consiste à utiliser une interface en ligne de commande (CLI), également appelée console ou terminal. Pour interagir correctement avec l'instance, nous devons d'abord installer ce que l'on appelle un client, afin de nous connecter au service Valkey et de le contrôler à distance. Il s'agit d'une interaction client-serveur.

En pratique

Installer valkey-cli sur votre client

Info

valkey-cli est le client officiel de Valkey. Il est fourni avec les paquets Valkey.

Vous devez d'abord installer un logiciel pour interagir avec votre instance à distance. Ce logiciel officiel peut être installé sur différents supports comme votre propre ordinateur, un VPS, une machine virtuelle... La seule règle est de pouvoir accéder au réseau public (Internet) et de disposer des privilèges suffisants pour l'installer.

Selon votre système d'exploitation :

  • macOS (Homebrew) : brew install valkey
  • Debian / Ubuntu : sudo apt install valkey-tools (Debian 13 ou version ultérieure, Debian 12 avec bookworm-backports, Ubuntu 24.04 ou version ultérieure ; indisponible sur Ubuntu 22.04)
  • Fedora / RHEL : sudo dnf install valkey
  • Alpine Linux : apk add valkey-cli
  • Docker : l'image officielle valkey/valkey contient valkey-cli, par exemple docker run -it --rm valkey/valkey valkey-cli --version.
  • Windows : valkey-cli n'est pas disponible nativement. Utilisez-le depuis WSL (avec l'une des commandes Linux ci-dessus) ou depuis Docker.

Pour les autres méthodes d'installation, consultez la documentation officielle d'installation de Valkey.

Vérifiez que le client est installé :

$ valkey-cli --version
valkey-cli 9.1.2

Le numéro de version dépend de votre paquet. Votre client doit prendre en charge TLS, ce qui est le cas des paquets listés ci-dessus. Les URI en valkeys:// nécessitent valkey-cli 8.0 ou version ultérieure. Avec une version antérieure (Ubuntu 24.04 installe la 7.2), remplacez valkeys:// par rediss://.

Info

redis-cli et les autres clients compatibles Redis peuvent également se connecter à votre service Valkey. redis-cli n'accepte pas le schéma valkeys:// : utilisez rediss://, par exemple redis-cli --tls -u rediss://<username>:<password>@<host>:<port> PING.

Nous sommes maintenant prêts à découvrir comment nous connecter à notre instance.

Connexion

Récupérez l'hôte, le port et l'URI de votre service dans l'onglet Dashboard, section Informations de connection, comme expliqué dans le guide Configurer les connexions entrantes.

Warning

TLS est obligatoire : les connexions sans TLS sont refusées. Utilisez toujours le schéma valkeys:// (ou l'option --tls). Le certificat du serveur est signé par une autorité de certification publique : vous n'avez pas besoin de télécharger de certificat CA ni d'ajouter d'option --cacert.

Dans votre terminal, saisissez :

valkey-cli --tls -u valkeys://<username>:<password>@<host>:<port> PING

N'oubliez pas de modifier le nom d'utilisateur, le mot de passe, l'hôte et le port.

Le résultat devrait ressembler à ceci :

$ valkey-cli --tls -u valkeys://<username>:<password>@<host>:<port> PING
Warning: Using a password with '-a' or '-u' option on the command line interface may not be safe.
PONG

Cela signifie que l'instance est active et répond à votre commande.

Pour être en mode interactif, exécutez la même commande sans commande Valkey à la fin :

valkey-cli --tls -u valkeys://<username>:<password>@<host>:<port>

Dans notre exemple, cela ressemblera à ceci :

$ valkey-cli --tls -u valkeys://<username>:<password>@<host>:<port>
Warning: Using a password with '-a' or '-u' option on the command line interface may not be safe.
<host>:<port>> PING
PONG
<host>:<port>> HELLO
 1) "server"
 2) "valkey"
 3) "version"
 4) "9.1.2"
 5) "proto"
 6) (integer) 2
 7) "id"
 8) (integer) 85
 9) "mode"
10) "standalone"
11) "role"
12) "master"
13) "modules"
...
<host>:<port>> SET cache:greeting "hello"
OK
<host>:<port>> GET cache:greeting
"hello"
<host>:<port>> DEL cache:greeting
(integer) 1

Félicitations ! Vous êtes maintenant pleinement en mesure d'interagir avec votre instance !

Tip

Utilisez PING ou HELLO pour tester une connexion. INFO est refusé aux utilisateurs dont les permissions ne l'incluent pas.

Éviter le mot de passe dans la ligne de commande

Avec l'option -u, le mot de passe reste dans l'historique de votre shell et apparaît dans la liste des processus, d'où l'avertissement affiché par valkey-cli. Pour l'éviter, utilisez l'une de ces méthodes :

  • Connectez-vous sans identifiants, puis authentifiez-vous dans la session interactive :

    $ valkey-cli --tls -h <host> -p <port>
<host>:<port>> AUTH <username> <password>
OK

  • Laissez valkey-cli vous demander le mot de passe, qui n'est pas affiché :

    $ valkey-cli --tls -h <host> -p <port> --user <username> --askpass
Please input password:
Warning

Ne mettez pas uniquement le nom d'utilisateur dans l'URI (valkeys://<username>@<host>:<port>) : valkey-cli interprète la valeur placée avant @ comme un mot de passe, et l'authentification échoue.

Utilisation de valkey-cli

Vous pouvez gérer votre instance à l'aide de l'interface en ligne de commande en mode interactif ou en définissant des paramètres en tant qu'arguments de valkey-cli.

Veuillez consulter la documentation officielle de valkey-cli et la liste des commandes Valkey.

En cas de problèmes de connexion ou d'exécution de commandes

Si vous ne vous authentifiez pas, toutes les commandes sont refusées avec une erreur NOAUTH :

$ valkey-cli --tls -h <host> -p <port> PING
(error) NOAUTH Authentication required.

Si le nom d'utilisateur ou le mot de passe est erroné, l'authentification échoue avec une erreur WRONGPASS :

WRONGPASS invalid username-password pair or user is disabled.

Vérifiez le nom d'utilisateur dans l'onglet Utilisateurs de votre service. Le mot de passe n'est affiché qu'une seule fois, à la création : si vous l'avez perdu, régénérez-le depuis l'onglet Utilisateurs.

Si l'utilisateur est authentifié mais que ses permissions (ACL) n'autorisent pas la clé, la commande ou le canal, vous obtenez une réponse NOPERM :

<host>:<port>> GET foo
(error) NOPERM No permissions to access a key

Dans ce cas, vérifiez les clés, catégories, commandes et canaux autorisés pour votre utilisateur, dans l'onglet Utilisateurs ou avec l'API. Pour en savoir plus, consultez la documentation officielle sur les ACL Valkey.

Aller plus loin

Capacités et limitations de Valkey

Configurer le vRack pour Public Cloud

Consultez le dépôt d'exemples Github pour découvrir comment vous connecter à votre base de données dans plusieurs langages.

Votre avis nous intéresse !

Nous serions ravis de répondre à vos questions et apprécions tout retour que vous pourriez nous faire.

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

Vous êtes sur Discord ? Rejoignez notre chaîne via https://discord.gg/ovhcloud et interagissez directement avec l’équipe qui développe notre service de bases de données !

Cette page vous a-t-elle aidé ?