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

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 registro Amazon QLDB su Amazon Aurora PostgreSQL.

Questa sezione descrive come installare ed eseguire l'applicazione di esempio Amazon QLDB fornita per step-by-step il tutorial 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 di esempio DMV per Java è open source nel repository aws-samples/ -java. GitHub amazon-qldb-dmv-sample

Prerequisiti

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

  1. Iscriviti per. AWS

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

  3. Se utilizzi un IDE diverso da quello 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 utilizzandola AWS Cloud9 come IDE e un AWS CloudFormation modello per fornire le risorse di sviluppo.

Queste istruzioni descrivono come scaricare e installare l'applicazione di esempio Java QLDB 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 per la registrazione di veicoli Amazon QLDB 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 esempio Amazon QLDB.

Per aprire la AWS CloudFormation console e caricare il modello di applicazione di esempio QLDB

  1. Accedi AWS Management Console e apri la AWS CloudFormation console all'indirizzo https://console.aws.amazon.com /cloudformation.

    Passa a una regione che supporta QLDB. Per un elenco completo, consulta gli endpoint e le quote di Amazon QLDB 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 l'URL di Amazon S3.

  4. Inserisci il seguente URL e scegli 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 (Amazon EC2) associata che usi per eseguire l'applicazione di esempio QLDB in questo tutorial. Inoltre, clona il repository amazon-qldb-dmv-sampleaws-samples/ -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 l' AWS Cloud9 IDE con le 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 QLDB DMV Sample Application e scegli Open IDE. Il caricamento dell'ambiente potrebbe richiedere un minuto all'avvio dell'istanza sottostante. EC2

    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 dell'ambiente QLDB DMV Sample Application.

    AWS Cloud9 console che mostra il riquadro della cartella dell'ambiente QLDB DMV Sample Application.

    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 OpenJDK 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: Esecuzione dell'applicazione di esempio QLDB DMV

In questo passaggio, imparerai come eseguire le attività dell'applicazione di esempio Amazon QLDB DMV 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 dell'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 registri 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 in https://console.aws.amazon.com/cloudformation ed elimina lo stack che hai creato nella Parte 1: Fornisci le tue risorse.

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