配置 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 服務的詳細資料。請參閱下列範例:
    服務:cloudantNoSQLDB
    說明:Cloudant NoSQL DB 是一個受到全面管理的資料層,並且設計用於採用靈活 JSON 綱目的現代 Web 和行動式應用程式。
    Cloudant 的建置基礎是 Apache CouchDB 並與之相容,可透過安全的 HTTPS API 來存取,會隨著您應用程式的成長來調整。
    Cloudant 已通過 ISO27001 和 SOC2 Type 1 認證,所有資料都以三份形式,儲存在資料中心內之 HA/DR 叢集的各個實體節點之間。
    說明文件:https://console.ng.bluemix.net/docs/#services/Cloudant/index.html#Cloudant
    計劃: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
    Checking if features required for the myCloudantService are installed.
    All required features are installed.
    The myCloudantService is now bound to defaultServer server.
    如果您使用 --pversion=v2 選項來匯入服務,以使用官方 Cloudant Java 程式庫,則 Cloudant 資料庫的預設 JNDI 名稱是 cloudant/serviceName。如果您沒有指定該選項,預設 JNDI 名稱是 couchdb/serviceName。如果您的應用程式使用不同的 JNDI 名稱來參照資料庫,請使用 --vjndiName 選項來指定 JNDI 名稱。
    bluemixUtility bind defaultServer myCloudantService --vjndiName=couchdb/connector

結果

現在,您可以搭配 Liberty 伺服器來使用 Cloudant 服務。

指示主題類型的圖示 作業主題

檔名:twlp_config_blmx_cloudant.html