配置 Liberty 以使用 IBM Cloud Cloudant 服务
使用 IBM® Bluemix® 实用程序命令行集成工具来将 Liberty 服务器配置为使用 IBM Cloud Cloudant® 服务。
关于此任务
将 Liberty 服务器配置为使用 Cloudant 服务。有关 Cloudant 的更多信息,请参阅 Cloudant NoSQL DB 入门。
过程
- 使用 bluemixUtility login 命令登录。初次登录后,无需再次完成此步骤。
- 运行 bluemixUtility marketplace 命令,以列出有关可以与命令行实用程序配合使用的所有 IBM Cloud 服务的详细信息。请参阅以下示例:
Service: cloudantNoSQLDB Description: Cloudant NoSQL DB is a fully managed data layer designed for modern web and mobile applications that leverages a flexible JSON schema. Cloudant is built upon and compatible with Apache CouchDB and accessible through a secure HTTPS API, which scales as your application grows. Cloudant is ISO27001 and SOC2 Type 1 certified, and all data is stored in triplicate across separate physical nodes in a cluster for HA/DR within a data center. Documentation: https://console.ng.bluemix.net/docs/#services/Cloudant/index.html#Cloudant Plans: Standard, Lite
- 注: 如果已创建实例,请跳至下一步。您还可从 IBM Cloud 仪表板创建实例。运行 bluemixUtility createService [options] serviceType servicePlan serviceName 命令以创建要使用的 IBM Cloud 服务的实例。 请参阅以下示例和所列示服务的描述:
$ bluemixUtility createService cloudantNoSQLDB Lite myCloudantService
- 可选: 运行 bluemixUtility listServices 命令以查看您创建的所有服务实例的名称、类型和计划。 请参阅以下示例:
myCloudantService cloudantNoSQLDB Lite
- 运行 bluemixUtility import myCloudantService --pversion=v2 命令以导入配置。 要点: --pversion=v2 选项用于安装 cloudant-1.0 功能部件和下载 Java 的官方 Cloudant 库。有关 API 信息,请参阅官方 Cloudant Java 库 API 文档。如果忽略 --pversion=v2 选项,那么安装 couchdb-1.0 功能部件,改为使用 Ektorp 库与 Cloudant 实例通信。
- 接受访问服务所需的必要库的协议条款和条件。
- 成功导入配置后,完成任何附加步骤(例如向库添加类装入器引用),以在应用程序中使用已导入的配置。例如,必须将以下类装入器引用添加到应用程序,然后才能使用下载的库。
<application id="myCloudantApp"> <classloader commonLibraryRef="cloudantNoSQLDB-library"/> </application>
- 可选: 运行 bluemixUtility listImports 命令以查看您导入的服务配置。
以下 IBM Bluemix 服务配置已导入: myCloudantService
- 运行 bluemixUtility bind [options] serverName serviceName 以将配置绑定到 Liberty 服务器。如果收到提示,请接受许可条款和条件。 请参阅以下示例和所列示服务的描述:
如果使用 --pversion=v2 选项导入服务以使用官方 Cloudant Java 库,那么 Cloudant 数据库的缺省 JNDI 名称为 cloudant/serviceName。如果未指定选项,那么缺省 JNDI 名称为 couchdb/serviceName。如果应用程序使用其他 JNDI 名称引用数据库,请使用 --vjndiName 选项指定 JNDI 名称。bluemixUtility bind defaultServer myCloudantService 检查 myCloudantService 所需的功能部件是否已安装。所有必需功能部件都已安装。myCloudantService 现已绑定到 defaultServer 服务器。
bluemixUtility bind defaultServer myCloudantService --vjndiName=couchdb/connector
结果

文件名:twlp_config_blmx_cloudant.html