Configuración de Liberty para servicios de IBM Cloud Cloudant

Utilice la herramienta de integración de línea de mandatos de programa de utilidad de IBM® Cloud para configurar el servidor de Liberty para utilizar el servicio de IBM Cloud Cloudant.

Antes de empezar

Antes de configurar el servidor de Liberty para utilizar los servicios de IBM Cloud, debe crear una cuenta. Consulte Registro en IBM Cloud para crear una cuenta de IBM Cloud.

Acerca de esta tarea

Configure el servidor de Liberty para utilizar el servicio de Cloudant. Si desea más información sobre Cloudant, consulte Guía de inicio con Cloudant NoSQL DB.

Procedimiento

  1. Inicie la sesión utilizando el mandato bluemixUtility login. Tras el inicio de sesión inicial, no tiene que completar este paso de nuevo.
  2. Ejecute el mandato bluemixUtility marketplace para listar los detalles sobre todos los servicios de IBM Cloud que se pueden utilizar con el programa de utilidad de línea de mandatos. Consulte el ejemplo siguiente:
    Servicio: cloudantNoSQLDB 
    Descripción: Cloudant NoSQL DB es una capa de datos completamente gestionada diseñada para modernas aplicaciones web y móviles que utiliza un esquema JSON flexible. 
    Cloudant se basa en, y es compatible con, Apache CouchDB, y es accesible mediante una API HTTPS segura, que se escala a medida que la aplicación crece. 
    Cloudant dispone de los certificados ISO27001 y SOC2 Tipo 1, y todos los datos se almacenan por triplicado en nodos físicos distintos de un clúster a fin de obtener alta disponibilidad y recuperación tras desastre en un centro de datos.
    Documentación: https://console.ng.bluemix.net/docs/#services/Cloudant/index.html#Cloudant
    Planes: Standard, Lite
  3. Nota: Si ya ha creado una instancia, vaya al paso siguiente. También puede crear una instancia desde el panel de control de IBM Cloud.
    Ejecute el mandato bluemixUtility createService [opciones] tipoServicio planServicio nombreServicio para crear una instancia de los servicios de IBM Cloud que desea utilizar. Consulte el ejemplo y la descripción siguientes de un servicio listado:
    $ bluemixUtility createService cloudantNoSQLDB Lite myCloudantService
  4. Opcional: Ejecute el mandato bluemixUtility listServices para ver el Nombre, Tipo y Plan de todas las instancias de servicios que ha creado. Consulte el ejemplo siguiente:
    myCloudantService cloudantNoSQLDB Lite
  5. Ejecute el mandato bluemixUtility import myCloudantService --pversion=v2 para importar la configuración.
    Importante: La opción --pversion=v2 instala la característica cloudant-1.0 y descarga la biblioteca Cloudant oficial para Java. Para obtener información acerca de la API, consulte la documentación oficial de la API de la biblioteca Java de Cloudant. Si omite la opción --pversion=v2, en su lugar se instala la característica couchdb-1.0 y se utilizan las bibliotecas Ektorp para las comunicaciones con la instancia de Cloudant.
    1. Acepte los términos y condiciones de licencia de las bibliotecas que son necesarias para acceder al servicio.
    2. Después de que la configuración se haya importado satisfactoriamente, siga los pasos adicionales para utilizar la configuración importada en la aplicación, por ejemplo añadir una referencia classloader en la biblioteca. Por ejemplo, debe añadir la siguiente referencia de classloader a la aplicación para utilizar las bibliotecas descargadas.
      <application id="myCloudantApp">
               <classloader commonLibraryRef="cloudantNoSQLDB-library"/>
      </application>
  6. Opcional: Ejecute el mandato bluemixUtility listImports para ver las configuraciones de servicio que ha importado.
    Se han importado las siguientes configuraciones de servicio de IBM Bluemix:
    myCloudantService
  7. Ejecute bluemixUtility bind [opciones] nombreServidor nombreServicio para enlazar la configuración a un servidor Liberty. Acepte los términos y condiciones de licencia, si se le solicita. Consulte el ejemplo y la descripción siguientes de un servicio listado:
    bluemixUtility bind defaultServer myCloudantService
    
    Comprobando si las características necesarias para myCloudantService están instaladas.
    Todas las características necesarias están instaladas.
    El servicio myCloudantService está ahora enlazado al servidor defaultServer.
    Si ha importado el servicio con la opción --pversion=v2 para utilizar las bibliotecas Java Cloudant oficiales, el nombre JNDI predeterminado de la base de datos Cloudant es cloudant/nombreServicio. Si no ha especificado dicha opción, el nombre JNDI predeterminado es couchdb/nombreServicio. Si la aplicación hace referencia a la base de datos utilizando un nombre JNDI distinto, utilice la opción --vjndiName para especificar el nombre JNDI.
    bluemixUtility bind defaultServer myCloudantService --vjndiName=couchdb/connector

Resultados

Ahora puede utilizar los servicios de Cloudant con el servidor de Liberty.

Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_config_blmx_cloudant.html