Instalación de la aplicación de ejemplo Java de Amazon QLDB - Amazon Quantum Ledger Database (Amazon QLDB)
Requisitos previosInstalación

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Instalación de la aplicación de ejemplo Java de Amazon QLDB

En esta sección se describe cómo instalar y ejecutar la aplicación de ejemplo de Amazon QLDB proporcionada para este tutorial de Java paso a paso. El caso de uso de esta aplicación de ejemplo es una base de datos del Departamento de Vehículos Automóviles (DMV) que rastrea la información histórica completa de las matriculaciones de vehículos.

Esta aplicación de ejemplo de DMV para Java es de código abierto y se encuentra en el repositorio de GitHub aws-samples/amazon-qldb-dmv-sample-java.

Requisitos previos

Antes de comenzar, asegúrese de completar el controlador QLDB para Java Requisitos previos. Estas incluyen las siguientes:

  1. Regístrese en AWS.

  2. Cree un usuario con los permisos de QLDB adecuados. Para completar todos los pasos de este tutorial, necesitará acceso administrativo completo a su recurso de libro mayor a través de la API de QLDB.

  3. Si usa un IDE distinto a AWS Cloud9, instale Java y conceda acceso programático de desarrollo.

Instalación

Los siguientes pasos describen cómo descargar y configurar la aplicación de muestra en un entorno de desarrollo local. También puede automatizar la configuración de la aplicación de muestra usando AWS Cloud9 como IDE y aprovisionando los recursos de desarrollo con una plantilla de AWS CloudFormation.

Estas instrucciones describen cómo descargar e instalar la aplicación de ejemplo Java de QLDB usando sus propios recursos y entorno de desarrollo.

Para descargar y ejecutar la aplicación de muestra

  1. Introduzca el siguiente comando para clonar la aplicación de muestra desde 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

    Este paquete incluye la configuración de Gradle y el código completo de Tutorial de Java.

  2. Cargue y ejecute la aplicación proporcionada.

    • Si usa Eclipse:

      1. Inicie Eclipse y, en el menú de Eclipse, seleccione Archivo, Importar y, a continuación, Proyecto de Gradle existente.

      2. En el directorio raíz del proyecto, busque y seleccione el directorio de aplicación que contiene el archivo build.gradle. A continuación, seleccione Finalizar para usar la configuración predeterminada de Gradle para la importación.

      3. Puede ejecutar el programa ListLedgers a modo de ejemplo. Abra el menú contextual (clic derecho) del archivo ListLedgers.java y seleccione Ejecutar como aplicación Java.

    • Si usa IntelliJ:

      1. Inicie IntelliJ y, en el menú de IntelliJ, seleccione Archivo y, a continuación, Abrir.

      2. En el directorio raíz del proyecto, busque y seleccione el directorio de aplicación que contiene el archivo build.gradle. A continuación, seleccione Aceptar. Mantenga la configuración predeterminada y vuelva a seleccionar Aceptar.

      3. Puede ejecutar el programa ListLedgers a modo de ejemplo. Abra el menú contextual (clic con el botón secundario) para el archivo ListLedgers.java, y elija Ejecutar 'ListLedgers'.

  3. Continúe a Paso 1: Crear un nuevo libro mayor para iniciar el tutorial y crear un libro mayor.

Estas instrucciones describen cómo automatizar la configuración de la aplicación de ejemplo de registro de vehículos de Amazon QLDB para Java, usando AWS Cloud9 como IDE. En esta guía, usará una plantilla de AWS CloudFormation para aprovisionar sus recursos de desarrollo.

Para obtener más información sobre AWS Cloud9, consulte la AWS Cloud9Guía del usuario de . Para obtener más información sobre AWS CloudFormation, consulte la Guía del usuario de AWS CloudFormation.

Parte 1: aprovisione sus recursos

En este primer paso, deberá usar AWS CloudFormation para aprovisionar los recursos necesarios para configurar su entorno de desarrollo con la aplicación de ejemplo de Amazon QLDB.

Para abrir la consola de AWS CloudFormation y cargar la plantilla de aplicación de ejemplo de QLDB

  1. Inicie sesión en la AWS Management Console y abra la consola de AWS CloudFormation en https://console.aws.amazon.com/cloudformation.

    Cambie a una región compatible con QLDB. Para obtener una lista completa, consulte Puntos de conexión y cuotas de Amazon QLDB en Referencia general de AWS. En la siguiente captura de pantalla de la AWS Management Console se muestra Este de EE. UU. (Norte de Virginia) como Región de AWS seleccionada.

    AWS Management Console que muestra Este de EE. UU. (Norte de Virginia) como Región de AWS seleccionada.

  2. En la consola de AWS CloudFormation, elija Crear pila, y, a continuación, elija Con nuevos recursos (estándar).

  3. En la página Crear pila, en Especificar plantilla, elija URL de Amazon S3.

  4. Introduzca la siguiente URL y seleccione Siguiente.

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

  5. Introduzca un nombre de pila (por ejemplo, qldb-sample-app) y elija Siguiente.

  6. Puede añadir las etiquetas que desee y mantener las opciones predeterminadas. A continuación, elija Next.

  7. Revise la configuración de su pila y seleccione Crear pila. El script de AWS CloudFormation podría tardar varios minutos en finalizar.

    Este script aprovisiona su entorno de AWS Cloud9 con una instancia de Amazon Elastic Compute Cloud (Amazon EC2) asociada que usará para ejecutar la aplicación de ejemplo de QLDB de este tutorial. También clona el repositorio aws-samples/amazon-qldb-dmv-sample-java de GitHub en su entorno de desarrollo AWS Cloud9.

Parte 2: configure el IDE

En este paso, terminará de configurar el entorno de desarrollo en la nube. Descargue y ejecute el script de intérprete de comandos proporcionado para configurar su IDE de AWS Cloud9 con las dependencias de la aplicación de muestra.

Para configurar su entorno de AWS Cloud9

  1. Abra la consola de AWS Cloud9 en https://console.aws.amazon.com/cloud9/.

  2. En Sus entornos, busque la tarjeta de entorno denominada QLDB DMV Sample Application y seleccione Open IDE. Es posible que su entorno tarde un minuto en cargarse cuando se lance la instancia de EC2 subyacente.

    Su entorno de AWS Cloud9 está preconfigurado con las dependencias del sistema que necesita para ejecutar el tutorial. En el panel de navegación Entorno de la consola, confirme que ve una carpeta con el nombre QLDB DMV Sample Application. La siguiente captura de pantalla de la consola AWS Cloud9 muestra el panel de carpetas del entorno QLDB DMV Sample Application.

    Consola de AWS Cloud9 que muestra el panel de carpetas del entorno QLDB DMV Sample Application.

    Si no ve ningún panel de navegación, active la pestaña Entorno, en la parte izquierda de la consola. Si no ve ninguna carpeta en el panel, active Mostrar raíz del entorno en el icono de configuración ( Settings icon ).

  3. En el panel inferior de la consola, debería ver una ventana de terminal de bash abierta. Si no lo ve, seleccione Nueva terminal en el menú Ventana de la parte superior de la consola.

  4. A continuación, descargue y ejecute un script de configuración para instalar OpenJDK 8 y, si procede, consulte la ramificación correspondiente del repositorio de Git. En la terminal de AWS Cloud9 creada en el paso anterior, ejecute los dos siguientes comandos en este orden:

    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 finalizar, debería ver el siguiente mensaje en la terminal:

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

  5. Tómese un momento para explorar el código de la aplicación de ejemplo en AWS Cloud9, especialmente la siguiente ruta de directorio: src/main/java/software/amazon/qldb/tutorial.

Parte 3: ejecute la aplicación de ejemplo QLDB DMV

En este paso, aprenderá a ejecutar las tareas de la aplicación de ejemplo DMV de Amazon QLDB usando AWS Cloud9. Para ejecutar el código de ejemplo, vuelva a la terminal de AWS Cloud9 o cree una nueva ventana de terminal, tal como hizo en la Parte 2: configure su IDE.

Para ejecutar las aplicaciones de ejemplo

  1. Ejecute el siguiente comando en su terminal para pasar al directorio raíz del proyecto:

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

    Asegúrese de ejecutar los ejemplos en la siguiente ruta de directorio.

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

  2. El siguiente comando muestra la sintaxis de Gradle para ejecutar cada tarea.

    ./gradlew run -Dtutorial=Task

    Por ejemplo, ejecute el siguiente comando para ver todos los libros mayores de su Cuenta de AWS y región actuales.

    ./gradlew run -Dtutorial=ListLedgers

  3. Continúe a Paso 1: Crear un nuevo libro mayor para iniciar el tutorial y crear un libro mayor.

  4. (Opcional) Tras completar el tutorial, limpie los recursos de AWS CloudFormation si ya no los necesita.

    1. Abra la consola de AWS CloudFormation en https://console.aws.amazon.com/cloudformation y elimine la pila que creó en la Parte 1: aprovisione sus recursos.

    2. Elimine también la pila AWS Cloud9 creada por la plantilla de AWS CloudFormation.