Installation der Amazon QLDB Java-Beispielanwendung - Amazon Quantum Ledger Database (Amazon QLDB)
VoraussetzungenInstallation

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Installation der Amazon QLDB Java-Beispielanwendung

In diesem Abschnitt wird beschrieben, wie Sie die bereitgestellte Amazon QLDB-Beispielanwendung für das step-by-step Java-Tutorial installieren und ausführen. Der Anwendungsfall für diese Beispielanwendung ist eine Datenbank der Straßenverkehrsbehörde, mit der die vollständigen Verlaufsinformationen über Fahrzeugzulassungen nachverfolgt werden.

Die DMV-Beispielanwendung für Java ist Open Source im GitHub Repository aws-samples/amazon-qldb-dmv-sample -java.

Voraussetzungen

Vergewissern Sie sich vor der Installation, dass der QLDB-Treiber für Java vollständig istVoraussetzungen. Diese umfasst die folgenden Funktionen:

  1. Registrieren beiAWS.

  2. Erstellen Sie einen Benutzer mit den entsprechenden QLDB-Berechtigungen. Um alle Schritte in diesem Tutorial abzuschließen, benötigen Sie über die QLDB-API vollen administrativen Zugriff auf Ihre Ledger-Ressource.

  3. Wenn Sie eine andere IDE als verwendenAWS Cloud9, installieren Sie Java und gewähren Sie programmatischen Zugriff für die Entwicklung.

Installation

In den folgenden Schritten wird beschrieben, wie Sie die Beispielanwendung mit einer lokalen Entwicklungsumgebung herunterladen und einrichten. Oder Sie können die Einrichtung der Beispielanwendung automatisieren, indem SieAWS Cloud9 als IDE eineAWS CloudFormation Vorlage zur Bereitstellung Ihrer Entwicklungsressourcen verwenden.

Diese Anweisungen beschreiben, wie Sie die QLDB Java-Beispielanwendung mithilfe Ihrer eigenen Ressourcen und Entwicklungsumgebung herunterladen und installieren.

So laden Sie die Beispielanwendung herunter und führen sie aus

  1. Geben Sie den folgenden Befehl ein GitHub.

    2.x
    git clone https://github.com/aws-samples/amazon-qldb-dmv-sample-java.git
    1.x
    git clone -b v1.2.0 https://github.com/aws-samples/amazon-qldb-dmv-sample-java.git

    Dieses Paket enthält die Gradle-Konfiguration und den vollständigen Code aus dem Java-Anleitung.

  2. Laden Sie die bereitgestellte Anwendung und führen Sie sie aus.

    • Wenn Sie Eclipse verwenden:

      1. Starten Sie Eclipse und wählen Sie im Menü Eclipse die Optionen File (Datei), Import (Importieren) und dann Existing Gradle Project (Bestehendes Gradle-Projekt).

      2. Durchsuchen Sie das Projekt-Stammverzeichnis und wählen Sie das Anwendungsverzeichnis, das die build.gradle-Datei enthält. Wählen Sie dann Finish (Fertig stellen), um die Standard-Gradle-Einstellungen für den Import zu verwenden.

      3. Sie können versuchen, das ListLedgers-Programm als Beispiel auszuführen. Öffnen Sie das Kontextmenü (rechte Maustaste) für die ListLedgers.java-Datei und wählen Sie Run as Java Application (Als Java-Anwendung ausführen) aus.

    • Wenn Sie IntelliJ verwenden:

      1. Starten Sie IntelliJ und wählen Sie im Menü IntelliJ File (Datei) und dann Open (Öffnen) aus.

      2. Durchsuchen Sie das Projekt-Stammverzeichnis und wählen Sie das Anwendungsverzeichnis, das die build.gradle-Datei enthält. Klicken Sie anschließend auf OK. Behalten Sie die Standardeinstellungen bei und klicken Sie erneut auf OK.

      3. Sie können versuchen, das ListLedgers-Programm als Beispiel auszuführen. Öffnen Sie das Kontextmenü (Rechtsklick) für dieListLedgers.java Datei und wählen Sie „AusführenListLedgers“.

  3. Fahren Sie mit Schritt 1: Erstellen eines neuen Ledger fort, um das Tutorial zu starten und ein Ledger zu erstellen.

In diesen Anweisungen wird beschrieben, wie Sie die Einrichtung der Amazon QLDB-Beispielanwendung für die Fahrzeugregistrierung für Java automatisieren, indem Sie AWS Cloud9sie als IDE verwenden. In diesem Handbuch verwenden Sie eine AWS CloudFormation-Vorlage, um Ihre Entwicklungsressourcen bereitzustellen.

Weitere Informationen zu AWS Cloud9 finden Sie im AWS Cloud9 Benutzerhandbuch. Weitere Informationen zu AWS CloudFormation finden Sie im AWS CloudFormation-Benutzerhandbuch.

Teil 1: Stellen Sie Ihre Ressourcen bereit

In diesem ersten Schritt verwenden Sie,AWS CloudFormation um die Ressourcen bereitzustellen, die für die Einrichtung Ihrer Entwicklungsumgebung mit der Amazon QLDB-Beispielanwendung erforderlich sind.

Um dieAWS CloudFormation Konsole zu öffnen und die QLDB-Beispielanwendungsvorlage zu laden

  1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die AWS CloudFormation-Konsole unter https://console.aws.amazon.com/cloudformation.

    Wechseln Sie zu einer Region, die QLDB unterstützt. Eine vollständige Liste finden Sie unter Amazon QLDB-Endpunkte und Kontingente in der Allgemeine AWS-Referenz. Der folgende ScreenshotAWS Management Console zeigt US East (Nord-Virginia)AWS-Region.

    AWS Management Consolewobei US East (Nord-Virginia)AWS-Region.

  2. Wählen Sie auf der AWS CloudFormation-Konsole Create stack (Stack erstellen) und dann With new resources (standard) (Mit neuen Ressourcen) aus.

  3. Wählen Sie auf der Seite Create stack (Stack erstellen) unter Specify template (Vorlage angeben) die Option Amazon S3 URL aus.

  4. Geben Sie die folgende URL ein und klicken Sie auf Next (Weiter).

    https://amazon-qldb-assets.s3.amazonaws.com/templates/QLDB-DMV-SampleApp.yml

  5. Geben Sie einen Stack name (Stack-Namen) ein (wie qldb-sample-app) und wählen Sie Next (Weiter) aus.

  6. Sie können Tags nach Bedarf hinzufügen und die Standard-Optionen beibehalten. Wählen Sie anschließend Next (Weiter).

  7. Überprüfen Sie Ihre Stack-Einstellungen und klicken Sie auf Create Stack (Stack erstellen). Die Ausführung dieses AWS CloudFormation-Skripts kann einige Minuten dauern.

    Dieses Skript stellt IhrerAWS Cloud9 Umgebung eine zugeordnete Amazon Elastic Compute Cloud (Amazon EC2) -Instance bereit, mit denen Sie die QLDB-Beispielanwendung in diesem Tutorial ausführen. Es klont auch das aws-samples/amazon-qldb-dmv-sample -java-Repository aus GitHub IhrerAWS Cloud9 Entwicklungsumgebung.

Teil 2: Einrichten Ihrer IDE

In diesem Schritt stellen Sie die Einrichtung Ihrer Cloud-Entwicklungsumgebung fertig. Sie laden ein bereitgestelltes Shell-Skript herunter und führen es aus, um Ihre AWS Cloud9-IDE mit den Abhängigkeiten der Beispielanwendung einzurichten.

So richten Sie Ihre AWS Cloud9-Umgebung ein

  1. Öffnen Sie dieAWS Cloud9 Konsole unter https://console.aws.amazon.com/cloud9/.

  2. Suchen Sie unter Your environments (Ihre Umgebungen) die Karte für die Umgebung mit der Bezeichnung QLDB DMV Sample Application und wählen Sie Open IDE (IDE öffnen) aus. Es kann einige Minuten dauern, bis Ihre Umgebung lädt, da die zugrunde liegende EC2-Instance gestartet wird.

    Ihre AWS Cloud9-Umgebung ist mit den Systemabhängigkeiten vorkonfiguriert, die Sie benötigen, um das Tutorial auszuführen. Bestätigen Sie im Navigationsbereich Environment (Umgebung) Ihrer Konsole, dass Sie einen Ordner mit der Bezeichnung QLDB DMV Sample Application sehen. Der folgende Screenshot derAWS Cloud9 Konsole zeigt den Umgebungsordnerbereich der QLDB DMV Sample Application.

    AWS Cloud9Konsole, die den Umgebungsordnerbereich der QLDB DMV Sample Application Environment anzeigt.

    Wenn Sie keinen Navigationsbereich sehen, blenden Sie die Registerkarte Environment (Umgebung) auf der linken Seite der Konsole ein/aus. Wenn im Bereich keine Ordner angezeigt werden, aktivieren Sie die Option Environment Root anzeigen über das Einstellungssymbol ( Settings icon ).

  3. Im unteren Bereich Ihrer Konsole sollten Sie ein bash-Terminal-Fenster sehen. Wenn Sie dies nicht sehen, wählen Sie New Terminal (Neues Terminal) aus dem Menü Window (Fenster) oben in der Konsole.

  4. Laden Sie als Nächstes ein Setup-Skript herunter und führen Sie es aus, um OpenJDK 8 zu installieren, und checken Sie — falls zutreffend — den entsprechenden Branch aus dem Git-Repository aus. Führen Sie in demAWS Cloud9 Terminal, das Sie im vorherigen Schritt erstellt haben:

    2.x
    aws s3 cp s3://amazon-qldb-assets/setup-scripts/dmv-setup-v2.sh .
    sh dmv-setup-v2.sh
    1.x
    aws s3 cp s3://amazon-qldb-assets/setup-scripts/dmv-setup.sh .
    sh dmv-setup.sh

    Nachdem der Vorgang abgeschlossen ist, sollten Sie die folgende Nachricht im Terminal sehen:

    ** DMV Sample App setup completed , enjoy!! **

  5. Nehmen Sie sich einen Moment Zeit,, den Beispiel-Anwendungscode in AWS Cloud9 zu besuchen, insbesondere im folgenden Verzeichnispfad: src/main/java/software/amazon/qldb/tutorial.

Teil 3: Führen Sie die QLDB DMV-Beispielanwendung aus

In diesem Schritt erfahren Sie, wie Sie die Amazon QLDB DMV-Beispielanwendungsaufgaben mit ausführenAWS Cloud9. Zum Ausführen des Beispielcodes gehen Sie zurück zu Ihrem AWS Cloud9-Terminal oder erstellen Sie ein neues Terminal-Fenster, wie Sie es in Teil 2: Einrichten Ihrer IDE gemacht haben.

So führen Sie die Beispielanwendung aus

  1. Führen Sie den folgenden Befehl in Ihrem Terminal aus, um zum Projekt-Stammverzeichnis zu wechseln:

    cd ~/environment/amazon-qldb-dmv-sample-java

    Stellen Sie sicher, dass Sie die Beispiele im folgenden Verzeichnispfad ausführen.

    /home/ec2-user/environment/amazon-qldb-dmv-sample-java/

  2. Der folgende Befehl zeigt die Gradle-Syntax zur Ausführung von einzelnen Aufgaben.

    ./gradlew run -Dtutorial=Task

    Führen Sie zum Beispiel den folgenden Befehl aus, um alle Ledger in IhrerAWS-Konto und der aktuellen Region aufzulisten.

    ./gradlew run -Dtutorial=ListLedgers

  3. Fahren Sie mit Schritt 1: Erstellen eines neuen Ledger fort, um das Tutorial zu starten und ein Ledger zu erstellen.

  4. (Optional) Wenn Sie das Tutorial abgeschlossen haben, bereinigen Sie Ihre AWS CloudFormation-Ressourcen, wenn Sie sie nicht mehr benötigen.

    1. Öffnen Sie dieAWS CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation und löschen Sie den Stack, den Sie in Teil 1: Bereitstellung Ihrer Ressourcen erstellt haben.

    2. Löschen Sie außerdem den AWS Cloud9-Stack, den die AWS CloudFormation-Vorlage für Sie erstellt hat.