配置 Liberty 以使用 IBM Cloud Cloudant 服务

使用 IBM® Bluemix® 实用程序命令行集成工具来将 Liberty 服务器配置为使用 IBM Cloud Cloudant® 服务。

开始之前

Liberty 服务器配置为使用 IBM Cloud 服务之前,必须创建帐户。请参阅注册 IBM Cloud 以创建 IBM Cloud 帐户。

关于此任务

Liberty 服务器配置为使用 Cloudant 服务。有关 Cloudant 的更多信息,请参阅 Cloudant NoSQL DB 入门

过程

  1. 使用 bluemixUtility login 命令登录。初次登录后,无需再次完成此步骤。
  2. 运行 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
  3. 注: 如果已创建实例,请跳至下一步。您还可从 IBM Cloud 仪表板创建实例。
    运行 bluemixUtility createService [options] serviceType servicePlan serviceName 命令以创建要使用的 IBM Cloud 服务的实例。 请参阅以下示例和所列示服务的描述:
    $ bluemixUtility createService cloudantNoSQLDB Lite myCloudantService
  4. 可选: 运行 bluemixUtility listServices 命令以查看您创建的所有服务实例的名称、类型和计划。 请参阅以下示例:
    myCloudantService cloudantNoSQLDB Lite
  5. 运行 bluemixUtility import myCloudantService --pversion=v2 命令以导入配置。
    要点: --pversion=v2 选项用于安装 cloudant-1.0 功能部件和下载 Java 的官方 Cloudant 库。有关 API 信息,请参阅官方 Cloudant Java 库 API 文档。如果忽略 --pversion=v2 选项,那么安装 couchdb-1.0 功能部件,改为使用 Ektorp 库与 Cloudant 实例通信。
    1. 接受访问服务所需的必要库的协议条款和条件。
    2. 成功导入配置后,完成任何附加步骤(例如向库添加类装入器引用),以在应用程序中使用已导入的配置。例如,必须将以下类装入器引用添加到应用程序,然后才能使用下载的库。
      <application id="myCloudantApp">
               <classloader commonLibraryRef="cloudantNoSQLDB-library"/>
      </application>
  6. 可选: 运行 bluemixUtility listImports 命令以查看您导入的服务配置。
    以下 IBM Bluemix 服务配置已导入:
    myCloudantService
  7. 运行 bluemixUtility bind [options] serverName serviceName 以将配置绑定到 Liberty 服务器。如果收到提示,请接受许可条款和条件。 请参阅以下示例和所列示服务的描述:
    bluemixUtility bind defaultServer myCloudantService
    检查 myCloudantService 所需的功能部件是否已安装。所有必需功能部件都已安装。myCloudantService 现已绑定到 defaultServer 服务器。
    如果使用 --pversion=v2 选项导入服务以使用官方 Cloudant Java 库,那么 Cloudant 数据库的缺省 JNDI 名称为 cloudant/serviceName。如果未指定选项,那么缺省 JNDI 名称为 couchdb/serviceName。如果应用程序使用其他 JNDI 名称引用数据库,请使用 --vjndiName 选项指定 JNDI 名称。
    bluemixUtility bind defaultServer myCloudantService --vjndiName=couchdb/connector

结果

您现在可以将 Cloudant 服务与 Liberty 服务器配合使用。

用于指示主题类型的图标 任务主题

文件名:twlp_config_blmx_cloudant.html