Installazione dell'applicazione di esempio Amazon QLDB Java - Database Amazon Quantum Ledger (Amazon) QLDB

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Installazione dell'applicazione di esempio Amazon QLDB Java

Importante

Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto il 31/07/2025. Per ulteriori dettagli, consulta Migrare un Amazon QLDB Ledger ad Amazon Aurora Postgre. SQL

Questa sezione descrive come installare ed eseguire l'applicazione di QLDB esempio Amazon fornita per il tutorial step-by-step Java. Il caso d'uso di questa applicazione di esempio è un database del dipartimento dei veicoli a motore (DMV) che tiene traccia delle informazioni storiche complete sulle immatricolazioni dei veicoli.

L'applicazione DMV di esempio per Java è open source nel GitHub repository amazon-qldb-dmv-sampleaws-samples/ -java.

Prerequisiti

Prima di iniziare, assicurati di aver completato il driver per Java. QLDB Prerequisiti Questo include gli output seguenti:

  1. Registrati per AWS.

  2. Crea un utente con le QLDB autorizzazioni appropriate. Per completare tutti i passaggi di questo tutorial, è necessario l'accesso amministrativo completo alla risorsa di registro tramite. QLDB API

  3. Se utilizzi una versione IDE diversa da AWS Cloud9, installa Java e concedi l'accesso programmatico per lo sviluppo.

Installazione

I passaggi seguenti descrivono come scaricare e configurare l'applicazione di esempio con un ambiente di sviluppo locale. In alternativa, è possibile automatizzare la configurazione dell'applicazione di esempio utilizzando AWS Cloud9 come AWS CloudFormation modello un modello per fornire le risorse di sviluppo. IDE

Queste istruzioni descrivono come scaricare e installare l'applicazione di esempio QLDB Java utilizzando risorse e ambiente di sviluppo propri.

Per scaricare ed eseguire l'applicazione di esempio
  1. Immettete il seguente comando da cui clonare l'applicazione di GitHub esempio.

    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

    Questo pacchetto include la configurazione Gradle e il codice completo di. Tutorial su Java

  2. Carica ed esegui l'applicazione fornita.

    • Se stai usando Eclipse:

      1. Avvia Eclipse e, nel menu Eclipse, scegli File, Importa, quindi Progetto Gradle esistente.

      2. Nella directory principale del progetto, sfoglia e seleziona la directory dell'applicazione che contiene il file. build.gradle Quindi, scegliete Fine per utilizzare le impostazioni Gradle predefinite per l'importazione.

      3. Puoi provare a eseguire il ListLedgers programma come esempio. Apri il menu contestuale (fai clic con il pulsante destro del mouse) per il ListLedgers.java file e scegli Esegui come applicazione Java.

    • Se utilizzi IntelliJ:

      1. Avviare IntelliJ e nel menu IntelliJ scegliere File, quindi Apri.

      2. Nella directory principale del progetto, sfogliate e selezionate la directory dell'applicazione che contiene il build.gradle file. Quindi, scegliete OK. Mantenete le impostazioni predefinite e scegliete nuovamente OK.

      3. Puoi provare a eseguire il ListLedgers programma come esempio. Apri il menu contestuale (fai clic con il pulsante destro del mouse) per il ListLedgers.java file e scegli Esegui 'ListLedgers'.

  3. Procedi con Fase 1: Creare un nuovo registro l'avvio del tutorial e la creazione di un libro mastro.

Queste istruzioni descrivono come automatizzare la configurazione dell'applicazione di esempio di registrazione dei QLDB veicoli Amazon per Java, AWS Cloud9utilizzandola come IDE In questa guida, utilizzi un AWS CloudFormationmodello per fornire le tue risorse di sviluppo.

Per ulteriori informazioni in merito AWS Cloud9, consulta la Guida AWS Cloud9 per l'utente. Per ulteriori informazioni su AWS CloudFormation, consulta la Guida per l'utente di AWS CloudFormation.

Parte 1: Fornisci le tue risorse

In questo primo passaggio, devi AWS CloudFormation fornire le risorse necessarie per configurare il tuo ambiente di sviluppo con l'applicazione di QLDB esempio Amazon.

Per aprire la AWS CloudFormation console e caricare il modello QLDB di applicazione di esempio
  1. Accedere AWS Management Console e aprire la AWS CloudFormation console all'indirizzo https://console.aws.amazon.com/cloudformation.

    Passa a una regione che supportaQLDB. Per un elenco completo, consulta gli QLDBendpoint e le quote di Amazon nel. Riferimenti generali di AWS La seguente schermata AWS Management Console mostra gli Stati Uniti orientali (Virginia settentrionale) come selezionati. Regione AWS

    AWS Management Console mostrando Stati Uniti orientali (Virginia settentrionale) come selezionato. Regione AWS
  2. Sulla AWS CloudFormation console, scegli Crea stack, quindi scegli Con nuove risorse (standard).

  3. Nella pagina Crea stack, sotto Specificare modello, scegli Amazon URL S3.

  4. Inserisci quanto segue e scegli URL Avanti.

    https://amazon-qldb-assets.s3.amazonaws.com/templates/QLDB-DMV-SampleApp.yml
  5. Immettete un nome per lo stack (ad esempioqldb-sample-app) e scegliete Avanti.

  6. Puoi aggiungere qualsiasi tag appropriato e mantenere le opzioni predefinite. Quindi scegli Successivo.

  7. Controlla le impostazioni dello stack e scegli Crea pila. Il AWS CloudFormation completamento dello script potrebbe richiedere alcuni minuti.

    Questo script effettua il provisioning del tuo AWS Cloud9 ambiente con un'istanza Amazon Elastic Compute Cloud (AmazonEC2) associata che usi per eseguire l'applicazione di QLDB esempio in questo tutorial. Inoltre, clona il repository aws-samples/ amazon-qldb-dmv-sample -java dal tuo ambiente di sviluppo. GitHub AWS Cloud9

Parte 2: configura il tuo IDE

In questo passaggio, finisci la configurazione del tuo ambiente di sviluppo cloud. Scarichi ed esegui uno script di shell fornito per configurare le AWS Cloud9 IDE dipendenze dell'applicazione di esempio.

Per configurare il tuo ambiente AWS Cloud9
  1. Apri la AWS Cloud9 console all'indirizzo https://console.aws.amazon.com/cloud9/.

  2. In I tuoi ambienti, individua la scheda per l'ambiente denominato QLDBDMVSample Application e scegli Apri IDE. Il caricamento dell'ambiente potrebbe richiedere un minuto all'avvio dell'EC2istanza sottostante.

    L' AWS Cloud9 ambiente è preconfigurato con le dipendenze di sistema necessarie per eseguire il tutorial. Nel riquadro di navigazione Ambiente della console, verifica che sia presente una cartella denominata. QLDB DMV Sample Application La seguente schermata della AWS Cloud9 console mostra il riquadro della cartella QLDB DMV Sample Application Environment.

    AWS Cloud9 console che mostra il riquadro della cartella QLDB DMV Sample Application Environment.

    Se non vedi un pannello di navigazione, attiva la scheda Ambiente sul lato sinistro della console. Se non vedi alcuna cartella nel riquadro, abilita Show Environment Root usando l'icona delle impostazioni () Settings icon .

  3. Nel riquadro inferiore della console, dovresti vedere una finestra di bash terminale aperta. Se non la vedi, scegli Nuovo terminale dal menu Finestra nella parte superiore della console.

  4. Successivamente, scarica ed esegui uno script di installazione per installare Open JDK 8 e, se applicabile, controlla il ramo appropriato dal repository Git. Nel AWS Cloud9 terminale che hai creato nel passaggio precedente, esegui i due comandi seguenti nell'ordine:

    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

    Al termine, dovresti vedere il seguente messaggio stampato nel terminale:

    ** DMV Sample App setup completed , enjoy!! **
  5. Prenditi un momento per sfogliare il codice dell'applicazione di esempio AWS Cloud9, in particolare nel seguente percorso di directory:src/main/java/software/amazon/qldb/tutorial.

Parte 3: Esegui l'applicazione QLDB DMV di esempio

In questo passaggio, imparerai come eseguire le attività dell'applicazione di QLDB DMV esempio di Amazon utilizzando AWS Cloud9. Per eseguire il codice di esempio, torna al tuo AWS Cloud9 terminale o crea una nuova finestra di terminale come hai fatto nella Parte 2: Configurazione del tuo IDE.

Per eseguire l'applicazione di esempio
  1. Esegui il seguente comando nel tuo terminale per passare alla directory principale del progetto:

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

    Assicurati di eseguire gli esempi nel seguente percorso di directory.

    /home/ec2-user/environment/amazon-qldb-dmv-sample-java/
  2. Il comando seguente mostra la sintassi Gradle per eseguire ogni attività.

    ./gradlew run -Dtutorial=Task

    Ad esempio, esegui il comando seguente per elencare tutti i libri contabili nella tua regione Account AWS e nella regione corrente.

    ./gradlew run -Dtutorial=ListLedgers
  3. Procedi con Fase 1: Creare un nuovo registro l'avvio del tutorial e la creazione di un libro mastro.

  4. (Facoltativo) Dopo aver completato il tutorial, pulisci AWS CloudFormation le risorse se non ti servono più.

    1. Apri la AWS CloudFormation console all'indirizzo https://console.aws.amazon.com/cloudformation ed elimina lo stack creato nella Parte 1: Fornisci le tue risorse.

    2. Elimina anche lo AWS Cloud9 stack creato dal AWS CloudFormation modello per te.