Utilisez l'outil d'intégration de ligne de commande d'utilitaire IBM®
Bluemix pour configurer votre serveur Liberty afin qu'il utilise le service Bluemix
Cloudant.
Avant de commencer
Avant de configurer votre serveur
Liberty pour qu'il utilise les services
Bluemix, vous devez créer un compte. Voir
Sign up for IBM
Bluemix pour créer votre compte
Bluemix.
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.
De plus, votre application doit utiliser la bibliothèque Ektorp pour accéder au service Cloudant. Pour plus d'informations, voir Bienvenue dans Ektorp.
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 Bluemix qui peuvent être utilisés avec l'utilitaire de ligne de commande. Examinez l'exemple suivant :
Service: cloudantNoSQLDB
Description: Cloudant NoSQL DB provides access to a fully managed NoSQL JSON data layer that's always on.
This service is compatible with CouchDB, and accessible through a simple to use HTTP interface for mobile
and web application models.
Documentation: https://www.ng.bluemix.net/docs/#services/Cloudant/index.html#Cloudant
Plans: Shared, Enterprise SMB, Enterprise Standard
Remarque : Si vous avez déjà créé une instance, passez à l'étape 4. Vous pouvez également créer une instance à partir du tableau de bord Bluemix.
Exécutez la commande bluemixUtility createService [options]
serviceType
servicePlan
serviceName pour créer une instance des services Bluemix que vous souhaitez utiliser. Examinez l'exemple et la description de service répertorié ci-dessous :
$ bluemixUtility createService cloudantNoSQLDB Shared 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 Shared
- Exécutez la commande bluemixUtility import myCloudantService pour importer la configuration.
- 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 classloader suivante à votre application pour utiliser les bibliothèques Ektorp 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.
La fonction couchdb-1.0 est requise. Le nom JNDI par défaut pour la base de données Cloudant est couchdb/serviceName. Si votre application utilise un nom JNDI différent pour accéder à l'instance de base de données, utilisez l'option --vjndiName pour spécifier le nom JNDI. Examinez l'exemple suivant : $ bluemixUtility bind defaultServer myCloudantService --vjndiName=couchdb/connector
Résultats
Vous pouvez désormais utiliser les services
Cloudant avec votre serveur
Liberty.