Utilisez l'outil d'intégration de ligne de commande d'utilitaire IBM® Cloud pour configurer votre serveur Liberty afin qu'il utilise le service IBM Cloud
Cloudant.
Avant de commencer
Avant de configurer votre serveur
Liberty pour qu'il utilise les services
IBM Cloud, vous devez créer un compte. Voir le site d'
inscription à IBM Cloud
pour créer votre compte
IBM Cloud.
Pourquoi et quand exécuter cette tâche
Configurez votre serveur Liberty pour qu'il utilise le service Cloudant. Pour
en savoir plus sur Cloudant, voir
Initiation à Cloudant NoSQL DB.
Procédure
- Connectez-vous à l'aide de la commande bluemixUtility login. Après votre connexion initiale, vous n'avez pas besoin d'effectuer à nouveau cette étape.
- Exécutez la commande bluemixUtility marketplace pour répertorier les détails sur tous les services IBM Cloud qui peuvent être utilisés avec l'utilitaire de ligne de commande. Examinez l'exemple suivant :
Service: cloudantNoSQLDB
Description : Cloudant NoSQL DB est une couche de données entièrement gérée, conçue pour des applications Web et mobile, qui tire parti d'un schéma JSON souple.
Cloudant repose et est compatible avec Apache CouchDB, est accessible via une API HTTPS sécurisée, et évolue avec l'expansion de votre application.
Cloudant est certifié conforme aux normes ISO27001 et SOC2 Type 1, et toutes les données sont stockées en triple sur des noeuds physiques distincts
dans un cluster d'un centre de données pour reprise à haut niveau de disponibilité après incident.
Documentation : https://console.ng.bluemix.net/docs/#services/Cloudant/index.html#Cloudant
Plans : Standard, Lite
Remarque : Si vous avez déjà créé une instance, passez à l'étape suivante. Vous pouvez également créer une instance
depuis le tableau de bord IBM Cloud.
Exécutez la commande bluemixUtility createService [options]
serviceType
servicePlan
serviceName pour créer une instance des services IBM Cloud que vous souhaitez utiliser. Examinez l'exemple et la description de service répertorié ci-dessous :
$ bluemixUtility createService cloudantNoSQLDB Lite myCloudantService
- Facultatif : Exécutez la commande bluemixUtility listServices pour afficher le nom, le type et le plan de toutes les instances de service que vous avez créées. Examinez l'exemple suivant :
myCloudantService cloudantNoSQLDB Lite
- Exécutez la commande bluemixUtility import myCloudantService --pversion=v2 pour importer la configuration.
Important : L'option
--pversion=v2 installe la fonction
cloudant-1.0 et télécharge la bibliothèque officielle de
Cloudant for Java. Pour les informations d'API, consultez
la
documentation officielle de la bibliothèque Java pour Cloudant. Si vous omettez l'option
--pversion=v2, la fonction
couchdb-1.0 est installée et les bibliothèques Ektorp sont utilisées à la place pour communiquer avec l'instance
Cloudant.
- Acceptez les dispositions de contrat de licence relatives aux bibliothèques nécessaires pour accéder au service.
- Une fois la configuration importée, effectuez des étapes supplémentaires afin d'utiliser la configuration importée dans l'application, telles que l'ajout d'une référence de chargeur de classe à la bibliothèque.
Par exemple, vous devez ajouter la référence de chargeur de classe suivante à votre
application pour qu'elle utilise les bibliothèques téléchargées.
<application id="myCloudantApp">
<classloader commonLibraryRef="cloudantNoSQLDB-library"/>
</application>
- Facultatif : Exécutez la commande bluemixUtility listImports pour afficher les configurations de service que vous avez importées.
Les configurations de service IBM Bluemix suivantes ont été importées :
myCloudantService
- Exécutez la commande bluemixUtility bind [options]
serverName
serviceName pour connecter la configuration à un serveur Liberty. Acceptez les dispositions de contrat de licence, si le système vous y invite. Examinez l'exemple et la description de service répertorié ci-dessous :
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.
Si vous avez importé le service avec l'option --pversion=v2 afin d'utiliser les bibliothèques
Cloudant Java officielles, le nom
JNDI par défaut pour la base de données Cloudant
est cloudant/nom_service. Si vous n'avez pas spécifié cette option, le nom
JNDI par défaut est couchdb/nom_service. Si votre
application référence la base de données sous un nom JNDI différent, utilisez l'option
--vjndiName pour spécifier son nom JNDI. bluemixUtility bind defaultServer myCloudantService --vjndiName=couchdb/connector
Résultats
Vous pouvez désormais utiliser les services
Cloudant avec votre serveur
Liberty.