IBM Cloud Docs
连接外部应用程序

连接外部应用程序

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" 部分中。 该表包含供参考的细目。

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 驱动程序。

常见的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 证书常见问题

使用自签名证书

  1. 端点 或连接信息的 Base64 字段复制证书信息。
  2. 如果需要,将 Base64 字符串解码为文本。
  3. 将证书保存到文件中。 (您可以使用提供的名称或您自己的文件名)。
  4. 向驱动程序或客户机提供证书的路径。

自签名证书的 CLI 插件支持

您可以使用命令 ibmcloud cdb deployment-cacert "your-service-name" 通过 CLI 插件显示用于部署的解码证书。 它将 base64 解码为文本。 将命令的输出复制并保存到文件中,并提供该文件的驱动程序或客户机路径。