Verwenden Sie das Integrationstool des IBM® Cloud-Befehlszeilendienstprogramms, um Ihren
Liberty-Server für die Verwendung mit dem IBM Cloud
Cloudant-Service zu konfigurieren.
Vorbereitende Schritte
Vor der Konfiguration Ihres
Liberty-Servers für die Verwendung von
IBM Cloud-Services müssen Sie einen Account erstellen.
Informationen zum Erstellen Ihres
IBM Cloud-Kontos finden Sie unter
Sign up for IBM Cloud.
Informationen zu diesem Vorgang
Konfigurieren Sie Ihren Liberty-Server so, dass
er den Cloudant-Service verwendet. Weitere Informationen
zu Cloudant finden Sie unter
Einführung in Cloudant NoSQL DB.
Vorgehensweise
- Melden Sie sich mit dem Befehl bluemixUtility login an. Nach der ersten Anmeldung müssen Sie diesen Schritt nicht wieder ausführen.
- Führen Sie den Befehl bluemixUtility marketplace aus, um Details zu allen IBM Cloud-Services aufzulisten, die mit dem Befehlszeilendienstprogramm verwendet werden können.
Sehen Sie sich hierzu das folgende Beispiel an:
Service: cloudantNoSQLDB
Description: Cloudant NoSQL DB is a fully managed data layer designed for modern web and mobile applications that leverages a flexible JSON schema.
Cloudant is built upon and compatible with Apache CouchDB and accessible through a secure HTTPS API, which scales as your application grows.
Cloudant is ISO27001 and SOC2 Type 1 certified, and all data is stored in triplicate across separate physical nodes in a cluster for HA/DR within a data center.
Documentation: https://console.ng.bluemix.net/docs/#services/Cloudant/index.html#Cloudant
Plans: Standard, Lite
Anmerkung: Wenn Sie bereits eine Instanz erstellt haben, fahren Sie mit dem nächsten Schritt fort. Sie können auch über das IBM Cloud-Dashboard eine Instanz erstellen.
Führen Sie den Befehl bluemixUtility createService [Optionen]
Servicetyp
Serviceplan
Servicename aus, um eine Instanz der IBM Cloud-Services zu erstellen, die Sie verwenden möchten. Sehen Sie sich das folgende Beispiel und die folgende Beschreibung für einen Service an:
$ bluemixUtility createService cloudantNoSQLDB Lite myCloudantService
- Optional: Führen Sie den Befehl bluemixUtility listServices aus, um
den Namen, Typ und Plan aller Serviceinstanzen anzuzeigen, die Sie erstellt haben. Sehen Sie sich hierzu das folgende Beispiel an:
myCloudantService cloudantNoSQLDB Lite
- Führen Sie den Befehl bluemixUtility import myCloudantService --pversion=v2 aus, um die Konfiguration zu importieren.
Wichtig: Die Option
--pversion=v2 installiert das Feature
cloudant-1.0 und lädt die offizielle
Cloudant-Bibliothek für Java herunter. Informationen zur API finden Sie in der
offiziellen API-Dokumentation zur Cloudant-Java-Bibliothek. Wenn Sie die Option
--pversion=v2 weglassen, wird das Feature
couchdb-1.0 installiert und die Ektorp-Bibliotheken werden stattdessen verwendet, um mit der
Cloudant-Instanz zu kommunizieren.
- Akzeptieren Sie die Lizenzbedingungen der erforderlichen Bibliotheken, die für den Zugriff auf den Service benötigt werden.
- Nach dem erfolgreichen Import der Konfiguration führen Sie alle zusätzlichen Schritte für die Verwendung der importierten Konfiguration in Ihrer Anwendung aus. Fügen Sie der Bibliothek beispielsweise eine
Klassenladeprogrammreferenz hinzu.
Sie müssen Ihrer Anwendung beispielsweise die folgende Klassenladeprogrammreferenz hinzufügen, um die heruntergeladenen Bibliotheken zu verwenden.
<application id="myCloudantApp">
<classloader commonLibraryRef="cloudantNoSQLDB-library"/>
</application>
- Optional: Führen Sie den Befehl bluemixUtility listImports aus, um die importierten Servicekonfigurationen anzuzeigen.
The following IBM Bluemix service configurations have been imported:
myCloudantService
- Führen Sie den Befehl bluemixUtility bind [Optionen]
Servername
Servicename aus, um die Konfiguration an einen Liberty-Server zu binden.
Akzeptieren Sie die Lizenzbedingungen, wenn Sie dazu aufgefordert werden. Sehen Sie sich das folgende Beispiel und die folgende Beschreibung für einen Service an:
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.
Wenn Sie den Service mit der Option --pversion=v2 importiert haben, um die offiziellen
Cloudant-Java-Bibliotheken zu verwenden, ist der JNDI-Standardname für die
Cloudant-Datenbank cloudant/Servicename. Wenn Sie diese Option nicht angegeben haben, ist der JNDI-Standardname couchdb/Servicename. Wenn Ihre Anwendung die Datenbank mit einem anderen JNDI-Namen referenziert, verwenden Sie zur Angabe des JNDI-Namens die Option --vjndiName. bluemixUtility bind defaultServer myCloudantService --vjndiName=couchdb/connector
Ergebnisse
Sie können
Cloudant-Services jetzt mit Ihrem
Liberty-Server verwenden.