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
- Inicie la sesión utilizando el mandato bluemixUtility login. Tras el inicio de sesión
inicial, no tiene que completar este paso de nuevo.
- 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
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
- 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
- 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.
- Acepte los términos y condiciones de licencia de las bibliotecas que son necesarias para acceder al
servicio.
- 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>
- 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
- 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.