使用 IBM®
Bluemix® 实用程序命令行集成工具来将 Liberty 服务器配置为使用 Bluemix Cloudant® 服务。
开始之前
将
Liberty 服务器配置为使用
Bluemix 服务之前,必须创建帐户。请参阅
注册 IBM Bluemix 以创建
Bluemix 帐户。
关于此任务
将 Liberty 服务器配置为使用 Cloudant 服务。有关 Cloudant 的更多信息,请参阅 Cloudant NoSQL DB 入门。
此外,您的应用程序必须使用 Ektorp 库来访问 Cloudant 服务。请参阅欢迎使用 Ektorp 以获取更多信息。
过程
- 使用 bluemixUtility login 命令登录。初次登录后,无需再次完成此步骤。
- 运行 bluemixUtility marketplace 命令,以列出有关可以与命令行实用程序配合使用的所有 Bluemix 服务的详细信息。请参阅以下示例:
服务:cloudantNoSQLDB
描述:Cloudant NoSQL DB 提供对始终开启的完全受管 NoSQL JSON 数据层的访问。
此服务与 CouchDB 兼容,并可通过适用于移动和 Web 应用程序模型的
简单易用的 HTTP 接口访问。
文档:https://www.ng.bluemix.net/docs/#services/Cloudant/index.html#Cloudant
计划:Shared、Enterprise SMB、Enterprise Standard
注: 如果您已创建实例,请跳至步骤 4。也可以从 Bluemix 仪表板创建实例。
运行 bluemixUtility createService [options] serviceType servicePlan serviceName 命令以创建要使用的 Bluemix 服务的实例。 请参阅以下示例和所列示服务的描述:
$ bluemixUtility createService cloudantNoSQLDB Shared myCloudantService
- 可选: 运行 bluemixUtility listServices 命令以查看您创建的所有服务实例的名称、类型和计划。 请参阅以下示例:
myCloudantService cloudantNoSQLDB Shared
- 运行 bluemixUtility import myCloudantService 命令以导入配置。
- 接受访问服务所需的必要库的协议条款和条件。
- 成功导入配置后,完成任何附加步骤(例如向库添加类装入器引用),以在应用程序中使用已导入的配置。例如,必须将以下类装入器引用添加到应用程序,然后才能使用所下载的 Ektorp 库。
<application id="myCloudantApp">
<classloader commonLibraryRef="cloudantNoSQLDB-library"/>
</application>
- 可选: 运行 bluemixUtility listImports 命令以查看您导入的服务配置。
以下 IBM Bluemix 服务配置已导入:
myCloudantService
- 运行 bluemixUtility bind [options] serverName serviceName 以将配置绑定到 Liberty 服务器。如果收到提示,请接受许可条款和条件。 请参阅以下示例和所列示服务的描述:
$ bluemixUtility bind defaultServer myCloudantService
检查 myCloudantService 所需的功能部件是否已安装。所有必需功能部件都已安装。myCloudantService 现已绑定到 defaultServer 服务器。
couchdb-1.0 功能部件为必需。Cloudant 数据库的缺省 JNDI 名称为 couchdb/serviceName。如果应用程序使用其他 JNDI 名称来访问数据库实例,请使用 --vjndiName 选项来指定该 JNDI 名称。请参阅以下示例: $ bluemixUtility bind defaultServer myCloudantService --vjndiName=couchdb/connector
结果
您现在可以将
Cloudant 服务与
Liberty 服务器配合使用。