Configuration de Liberty pour les services IBM Cloud Cloudant

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

  1. Connectez-vous à l'aide de la commande bluemixUtility login. Après votre connexion initiale, vous n'avez pas besoin d'effectuer à nouveau cette étape.
  2. 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
  3. 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
  4. 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
  5. 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.
    1. Acceptez les dispositions de contrat de licence relatives aux bibliothèques nécessaires pour accéder au service.
    2. 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>
  6. 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
  7. 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.

Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_config_blmx_cloudant.html