与 etcdctl 连接
IBM Cloud® Databases for etcd 已被弃用。 自 2025 年 4 月 1 日起，您将无法部署新的应用程序。 现有实例支持至 2025 年 10 月 15 日。 任何在该日期仍然存在的实例都将被删除。 有关详细信息，请参阅 IBM Cloud® Databases for etcd 的弃用。
您可以通过命令行客户端直接访问 etcd 数据库，这样就可以与数据库中创建的数据结构直接交互。 它还可用于管理和监控密钥空间和性能、进行 etcd 交易、管理租赁和其他管理活动。
Databases for etcd 仅支持 etcd v3 API 和数据存储。 对 v2 API 的访问已禁用。
安装
etcdctl 二进制文件在 etcd 发行版中提供，可从 the coreos/etcd 源下载。
连接
连接字符串显示在部署的 概述 的 终点 面板中，也可以从 云数据库 CLI 插件 和 应用程序接口 中获取。
部署中的任何用户都可以使用 etcdctl 进行连接，但 root 用户 在群集上拥有更多权限。
etcdctl 与部署建立连接所需的信息位于 连接字符串 的 "cli "部分。 表中的细目可供参考。
| 字段名称 | 索引 | 描述 |
|---|---|---|
Bin |
建议用于创建连接的二进制；本例中为 etcdctl。 |
|
Composed |
格式化命令，用于建立与部署的连接。 该命令结合 Bin 可执行文件、Environment 变量设置，并使用 |
|
Environment |
你设置为环境变量的键或值的列表。 | |
Arguments |
0... | Bin 字段中显示的作为参数传递给命令的信息。 |
Certificate |
Base64 | 自签名证书，用于确认应用程序连接到相应的服务器。 它采用base64编码。 |
Certificate |
名称 | 自签名证书的分配名称。 |
Type |
使用此连接信息的软件包类型；在本例中为 cli。 |
0...表示数组中可能有一个或多个这样的条目。
etcdctl 示例
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- 为etcdctl命令设置 API 版本环境变量。etcdctl的二进制文件默认使用版本 2，您的部署不支持该版本。 设置该环境变量将覆盖默认值。 如果您只使用etcdctl与 etcd v3 部署对话，您可能需要在 shell 环境中更持久地设置此变量。etcdctl- 命令本身。--endpoints=...- 指定etcdctl命令连接的端点的参数。 它由 HTTPS 协议 URL 组成，包括端口号。--user=...- 用户名和密码的参数，以冒号分隔，用作登录 etcd 部署的凭证。member list- etcdctl 命令，用于列出 etcd 部署的数据库成员。 在没有其他参数的情况下，结果将以逗号分隔的值列表形式生成。-w table-member list输出的修改器，可将其重新格式化为带标题的表格。
更多命令示例请参见 etcd 文档。
从IBM CloudCLI启动 etcdctl
如果同时安装了 etcdctl 和 Cloud Databases CLI 插件，则 ibmcloud cdb deployment-connections 命令可以处理创建连接。 例如，要使用 "example-user "连接到名为 "example-etcd"的部署，请使用以下命令。
ibmcloud cdb deployment-connections -u example-user example-etcd --start
该命令会提示用户输入密码，然后运行 etcdctl 命令行客户端连接数据库。