IBM Cloud Docs
Connexion avec etcdctl

Connexion avec etcdctl

IBM Cloud® Databases for etcd est obsolète. À partir du 1er avril 2025, vous ne pourrez plus déployer de nouvelles applications. Les instances existantes sont prises en charge jusqu'au 15 octobre 2025. Toutes les instances qui existent encore à cette date seront supprimées. Pour plus d'informations, voir Deprecation of IBM Cloud® Databases for etcd.

Vous pouvez accéder à votre base de données etcd directement à partir d'un client de ligne de commande, ce qui vous permet d'interagir directement avec les structures de données qui sont créées dans la base de données. Ceci est également utile pour administrer et surveiller l'espace de clés et les performances, effectuer des transactions etcd, gérer des baux et pour d'autres activités de gestion.

Databases for etcd prend en charge uniquement l'API et le magasin de données etcd v3. L'accès à l'API v2 est désactivé.

Installation

Le fichier binaire etcdctl est disponible dans la distribution etcd, qui peut être téléchargée à partir du référentiel coreos/etcd.

Connexion en cours

Les chaînes de connexion s'affichent dans le panneau Noeuds finaux de la Présentation de votre déploiement et peuvent également être extraites à partir du plug-in d'interface de ligne de commande des bases de données et de l'API.

page des points de terminaison de la CLI
page des points de terminaison de la CLI
" page des points de terminaison de la CLI

N'importe quel utilisateur de votre déploiement peut se connecter à l'aide de etcdctl, mais l'utilisateur root dispose de plus de droits sur le cluster.

Les informations dont etcdctl a besoin pour établir une connexion avec votre déploiement se trouvent dans la section "cli" de vos chaînes de connexion. Le tableau ci-après est fourni à titre de référence.

informations de connexion etcdctl/cli
Nom de zone Index Description
Bin Le binaire recommandé pour créer une connexion ; dans ce cas, il s'agit de etcdctl.
Composed Commande formatée pour établir une connexion à votre déploiement. La commande combine l'exécutable Bin, les paramètres variables Environment et utilise la fonction
Environment Liste de clés ou de 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 autosigné utilisé pour confirmer qu'une application se connecte au serveur approprié. Il est encodé en base64.
Certificate Nom Nom attribué au certificat autosigné.
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.

etcdctlexemple

ETCDCTL_API=3 etcdctl --endpoints=http://afe6f1d5-60d5-447e-a96a-66f555ecc277.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:32207 --user=ibm_cloud_4417:32f81b04e1b756f34bda351d59c973 member list -w table
  • ETCDCTL_API=3 - Définit la variable d'environnement de version d'API pour la commande etcdctl. Le fichier binaire etcdctl utilise la version 2 par défaut, ce qui n'est pas pris en charge sur votre déploiement. Lorsque cette variable d'environnement est définie, la valeur par défaut est remplacée. Si vous utilisez uniquement etcdctl pour communiquer avec les déploiements etcd v3, vous souhaiterez peut-être définir cette variable de façon plus permanente dans votre environnement shell.
  • etcdctl - Commande proprement dite.
  • --endpoints=... - Le paramètre qui spécifie les nœuds finaux auxquels la commande etcdctl se connecte. Il est composé d'URL de protocole HTTPS et inclut un numéro de port.
  • --user=... Paramètre pour le nom d'utilisateur et le mot de passe, séparés par un signe deux-points, à utiliser comme données d'identification pour se connecter au déploiement etcd.
  • member list - Commande etcdctl permettant de répertorier les membres de base de données du déploiement etcd. Si aucun autre paramètre n'est spécifié, le résultat est généré sous la forme d'une liste de valeurs séparées par des virgules.
  • -w table - Modificateur pour la sortie de la commande member list, qui reformate cette sortie sous la forme d'un tableau avec des en-têtes.

D'autres exemples de commande peuvent être consultés dans la documentation etcd.

Démarrage de etcdctl à partir de l'interface de ligne de commande IBM Cloud

Si etcdctl et le plug-in d'interface de ligne de commande Cloud Databases sont tous les deux installés, la commande ibmcloud cdb deployment-connections peut gérer la création de la connexion. Par exemple, pour vous connecter à un déploiement nommé "example-etcd" avec un utilisateur "example-user", utilisez la commande suivante :

ibmcloud cdb deployment-connections -u example-user example-etcd --start

La commande vous invite à entrer le mot de passe de l'utilisateur, puis elle exécute le client de ligne de commande etcdctl pour établir une connexion à la base de données.