Installation der Amazon QLDB Java-Beispielanwendung - Amazon Quantum Ledger-Datenbank (AmazonQLDB)
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

Wichtig

Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter Migrieren eines Amazon QLDB Ledgers zu Amazon Aurora SQL Postgre.

In diesem Abschnitt wird beschrieben, wie Sie die bereitgestellte QLDB Amazon-Beispielanwendung für das step-by-step Java-Tutorial installieren und ausführen. Der Anwendungsfall für diese Beispielanwendung ist eine Datenbank des Kraftfahrzeugministeriums (DMV), in der alle historischen Informationen über Fahrzeugzulassungen erfasst werden.

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

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie den Treiber für Java fertiggestellt haben. QLDB Voraussetzungen Diese umfasst die folgenden Funktionen:

  1. Melden Sie sich an für AWS.

  2. Erstellen Sie einen Benutzer mit den entsprechenden QLDB Berechtigungen. Um alle Schritte in diesem Tutorial ausführen zu können, benötigen Sie vollen Administratorzugriff auf Ihre Ledger-Ressource über die QLDBAPI.

  3. Wenn Sie ein IDE anderes als verwenden AWS 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 automatisierenIDE, indem Sie AWS Cloud9 als Ihre AWS CloudFormation Vorlage eine Vorlage zur Bereitstellung Ihrer Entwicklungsressourcen verwenden.

In diesen Anweisungen wird beschrieben, 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, um die Beispielanwendung aus zu klonen 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-Lernprogramm.

  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 die ListLedgers.java Datei und wählen Sie Ausführen '' ListLedgers.

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

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

Weitere Informationen dazu 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 stellen Sie die Ressourcen AWS CloudFormation bereit, die für die Einrichtung Ihrer Entwicklungsumgebung mit der QLDB Amazon-Beispielanwendung erforderlich sind.

Um die AWS CloudFormation Konsole zu öffnen und die Vorlage für die QLDB Beispielanwendung zu laden

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

    Wechseln Sie zu einer Region, die unterstütztQLDB. Eine vollständige Liste finden Sie unter QLDBAmazon-Endpunkte und Kontingente in der Allgemeine AWS-Referenz. Der folgende Screenshot AWS Management Console zeigt die Region USA Ost (Nord-Virginia) als ausgewählt AWS-Region.

    AWS Management Console zeigt USA Ost (Nord-Virginia) als ausgewählt AWS-Region.

  2. Wählen Sie in der AWS CloudFormation Konsole „Stack erstellen“ und anschließend „Mit neuen Ressourcen (Standard)“ aus.

  3. Wählen Sie auf der Seite Stack erstellen unter Vorlage angeben die Option Amazon S3 ausURL.

  4. Geben Sie Folgendes URL ein und wählen Sie 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 Weiter.

  7. Überprüfen Sie Ihre Stack-Einstellungen und klicken Sie auf Create Stack (Stack erstellen). Es kann einige Minuten dauern, bis das AWS CloudFormation Skript fertig ist.

    Dieses Skript stellt Ihrer AWS Cloud9 Umgebung eine zugehörige Amazon Elastic Compute Cloud (AmazonEC2) -Instance zur Verfügung, mit der Sie die QLDB Beispielanwendung in diesem Tutorial ausführen. Es klont auch das aws-samples/ amazon-qldb-dmv-sample -java-Repository aus Ihrer Entwicklungsumgebung. GitHub AWS Cloud9

Teil 2: Richten Sie Ihre ein 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 die Abhängigkeiten Ihrer AWS Cloud9 IDE Beispielanwendung einzurichten.

Um Ihre AWS Cloud9 Umgebung einzurichten

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

  2. Suchen Sie unter Ihre Umgebungen die Karte für die Umgebung mit dem Namen QLDBDMVBeispielanwendung und wählen Sie Öffnen ausIDE. Das Laden Ihrer Umgebung kann eine Minute dauern, wenn die zugrunde liegende EC2 Instance gestartet wird.

    Ihre AWS Cloud9 Umgebung ist mit den Systemabhängigkeiten vorkonfiguriert, die Sie für die Ausführung des Tutorials benötigen. Bestätigen Sie im Navigationsbereich Environment (Umgebung) Ihrer Konsole, dass Sie einen Ordner mit der Bezeichnung QLDB DMV Sample Application sehen. Der folgende Screenshot der AWS Cloud9 Konsole zeigt den Umgebungsordnerbereich der QLDB DMV Beispielanwendung.

    AWS Cloud9 Konsole mit dem Ordnerbereich QLDB DMV für die Beispielanwendungsumgebung.

    Wenn Sie keinen Navigationsbereich sehen, blenden Sie die Registerkarte Environment (Umgebung) auf der linken Seite der Konsole ein/aus. Wenn Sie in dem Bereich keine Ordner sehen, aktivieren Sie mit dem Einstellungssymbol ( Settings icon ) die Option „Umgebungsstamm anzeigen“.

  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 Open JDK 8 zu installieren. Falls zutreffend, checken Sie den entsprechenden Branch aus dem Git-Repository aus. Führen Sie in dem AWS Cloud9 Terminal, das Sie im vorherigen Schritt erstellt haben, die folgenden beiden Befehle nacheinander aus:

    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, um den Code der Beispielanwendung zu durchsuchen AWS Cloud9, 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 Aufgaben der QLDB DMV Amazon-Beispielanwendung mithilfe von ausführen AWS Cloud9. Um den Beispielcode auszuführen, kehren Sie zu Ihrem AWS Cloud9 Terminal zurück oder erstellen Sie ein neues Terminalfenster, wie Sie es in Teil 2: Einrichten Ihres getan habenIDE.

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 beispielsweise den folgenden Befehl aus, um alle Ledger in Ihrer AWS-Konto und der aktuellen Region aufzulisten.

    ./gradlew run -Dtutorial=ListLedgers

  3. Fahren Sie mit Schritt 1: Erstellen Sie ein neues Hauptbuch 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 die AWS CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation und löschen Sie den Stack, den Sie in Teil 1: Bereitstellen Ihrer Ressourcen erstellt haben.

    2. Löschen Sie auch den AWS Cloud9 Stack, den die AWS CloudFormation Vorlage für Sie erstellt hat.