IBM Cloud Cloudant 서비스를 위해 Liberty 구성

IBM® Bluemix® 유틸리티 명령행 통합 도구를 사용하면 IBM Cloud Cloudant® 서비스를 사용하도록 Liberty 서버를 구성할 수 있습니다.

시작하기 전에

IBM Cloud 서비스를 사용하도록 Liberty 서버를 구성하기 전에 계정을 작성해야 합니다. IBM Cloud 계정을 작성하려면 IBM Cloud에 등록을 참조하십시오.

이 태스크 정보

Cloudant 서비스를 사용하도록 Liberty 서버를 구성하십시오. 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 기능이 설치되고 Cloudant 인스턴스와 통신하기 위해 Ektorp 라이브러리가 대신 사용됩니다.
    1. 서비스에 액세스하기 위해 필요한 라이브러리의 라이센스 이용 약관에 동의하십시오.
    2. 구성을 가져온 후 애플리케이션에서 가져온 구성을 사용하기 위해 필요한 추가 단계를 완료하십시오(예: 라이브러리에 대한 클래스 로더 참조 추가). 예를 들어, 다운로드된 라이브러리를 사용하려면 애플리케이션에 대해 다음 클래스 로더 참조를 추가해야 합니다.
      <application id="myCloudantApp">
               <classloader commonLibraryRef="cloudantNoSQLDB-library"/>
      </application>
  6. 옵션: bluemixUtility listImports 명령을 실행하여 가져온 서비스 구성을 보십시오.
    The following IBM Bluemix service configurations have been imported:
    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

결과

이제 Cloudant 서비스를 Liberty 서버와 함께 사용할 수 있습니다.

주제의 유형을 표시하는 아이콘 태스크 주제

파일 이름: twlp_config_blmx_cloudant.html