连接外部应用程序
IBM Cloud® Databases for etcd 已被弃用。 自 2025 年 4 月 1 日起,您将无法部署新的应用程序。 现有实例支持至 2025 年 10 月 15 日。 任何在该日期仍然存在的实例都将被删除。 有关更多信息,请参阅 IBM Cloud® Databases for etcd 的弃用。
每个 IBM Cloud® Databases for etcd 部署都有专门用于驱动程序和应用程序的连接字符串。 连接字符串显示在部署的“概述”中的 端点 内,还可以从 Cloud Databases CLI 插件 和 Cloud Databases API 中检索。
连接字符串可供部署上的任何用户使用。 虽然可以将 root 用户用于所有连接和应用程序,但最好是专门为要连接的应用程序生成用户。 有关更多信息,请参阅 创建用户和获取连接字符串。
使用连接信息
Databases for etcd 仅支持 etcd v3 API 和数据存储器。 已禁用对 v2 API 的访问。
应用程序与部署建立连接所需的信息位于连接字符串的 "etcd" 部分中。 该表包含供参考的细目。
字段名称 | 索引 | 描述 |
---|---|---|
Type |
连接类型-对于 etcd,它是 "uri" | |
Scheme |
URI 的方案-对于 etcd,它是 "https" | |
Path |
URI 的路径 | |
Authentication |
Username |
用于连接的用户名。 |
Authentication |
Password |
用户的密码-可能显示为 $PASSWORD |
Authentication |
Method |
如何进行认证;“直接”认证由驱动程序处理。 |
Hosts |
0... |
要连接到的主机名和端口 |
Composed |
0... |
组合方案,认证,主机和路径的 URI |
Certificate |
Name |
用于数据库部署的自签名证书的已分配名称 |
Certificate |
Base64 | 证书的 base64 编码版本。 |
0...
指示数组中可能有一个或多个这些条目。
使用驱动程序进行连接
当给定在连接信息的“组合”字段中找到 URI 格式的连接字符串时,etcd 驱动程序通常能够与部署建立连接。 例如
https://ibm_cloud_59699685_b95e_4afe_9d39_7464c228563c:$PASSWORD@ca537b4d-dcf2-467f-bd98-97535f11445b.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:32218
该表涵盖各种语言的几个 etcd 驱动程序。
语言 | 驱动程序 | 文档 |
---|---|---|
Node | etcd3 |
链接 |
Java | jetcd |
链接 |
Java | etcd-java |
链接 |
执行 | etcd/client |
链接 |
Python | python-etcd |
链接 |
在没有驱动程序的情况下进行连接
对于不支持 gRPC 的语言,etcd v3 提供了用于将 HTTP/JSON 请求转换为 gRPC 消息的 JSON gRPC 网关。 例如,您可以使用 cURL来检查集群运行状况。
curl https://35dae549-2275-4d3e-beed-d86f36022336.974550db55eb4ec0983f023940bf637f.databases.appdomain.cloud:32460/{version}/cluster/member/list --cacert c5f02736-d94c-11e8-a2e9-62ec2ed68f84 \
-X POST -d '{"name": "ibm_cloud_59699685_b95e_4afe_9d39_7464c228563c", "password": "$PASSWORD"}'
version
路径参数取决于在部署上运行的 etcd 次版本。 您可以在 部署的 概述 页面 上找到次版本。 如果您正在运行 etcd 3.2,请在端点中使用 v3alpha
。 如果您正在运行 etcd 3.3,请在端点中使用 v3beta
。
版本信息和示例命令位于 etcd 文档 中。 请参阅 etcd Swagger API 定义 以获取完整参考。
TLS 和自签名证书支持
到 Databases for etcd 的所有连接都已启用 TLS 1.2,因此您用于连接的方法需要能够支持加密。 您的部署还随附了自签名证书,用于在连接时验证服务器。
有关更多信息,请参阅 Cloud Databases 证书常见问题。
使用自签名证书
- 从 端点 或连接信息的 Base64 字段复制证书信息。
- 如果需要,将 Base64 字符串解码为文本。
- 将证书保存到文件中。 (您可以使用提供的名称或您自己的文件名)。
- 向驱动程序或客户机提供证书的路径。
自签名证书的 CLI 插件支持
您可以使用命令 ibmcloud cdb deployment-cacert "your-service-name"
通过 CLI 插件显示用于部署的解码证书。 它将 base64 解码为文本。 将命令的输出复制并保存到文件中,并提供该文件的驱动程序或客户机路径。