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

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 Amazon QLDB proporcionada para el step-by-step Tutorial de Java. El caso de uso de esta aplicación de ejemplo es una base de datos del Departamento de Vehículos Motorizados (DMV) que realiza un seguimiento de la información histórica completa sobre los registros de vehículos.

La aplicación de ejemplo DMV para Java es de código abierto en el GitHub repositoryaws-samples/amazon-qldb-dmv-sample-java.

Requisitos previos

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

  1. Registrarse enAWS.

  2. Creación de unAWS Identity and Access Management(IAM) con los permisos QLDB adecuados. Para completar todos los pasos de este tutorial, necesita acceso administrativo completo a su recurso de libro mayor a través de la API de QLDB.

  3. Si utilizas un IDE distinto deAWS Cloud9, instale Java y obtenga una clave de acceso de IAM para el desarrollo.

Instalación

En los siguientes pasos se describe cómo descargar y configurar la aplicación de ejemplo con un entorno de desarrollo local. O bien, puede automatizar la configuración de la aplicación de ejemplo medianteAWS Cloud9como su IDE, y unAWS CloudFormationplantilla para aprovisionar sus recursos de desarrollo.

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

Para descargar y ejecutar la aplicación de ejemplo

  1. Ingrese el siguiente comando para clonar la aplicación de ejemplo desde GitHub.

    2.x
    git clone -b v2.0.0 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 delTutorial de Java.

  2. Cargue y ejecute la aplicación proporcionada.

    • Si utiliza Eclipse:

      1. Inicie Eclipse y en elEclipsemenú, elijaArchivo,Importación, y luegoProyecto Gradle de existente.

      2. En el directorio raíz del proyecto, navegue y seleccione el directorio de aplicaciones que contiene elbuild.gradlefile. A continuación, eligeAcabadopara utilizar la configuración predeterminada de Gradle para la importación.

      3. Puede intentar ejecutar elListLedgersprograma como ejemplo. Abra el menú contextual (con el botón derecho del ratón) delListLedgers.javaarchivo y elijaEjecutar como aplicación Java.

    • Si utiliza IntelliJ:

      1. Inicie IntelliJ y en elIntelliJmenú, elijaArchivoy luegoAbierto.

      2. En el directorio raíz del proyecto, navegue y seleccione el directorio de aplicaciones que contiene elbuild.gradlefile. A continuación, eligeDE ACUERDO. Mantenga la configuración predeterminada y seleccioneDE ACUERDOde nuevo.

      3. Puede intentar ejecutar elListLedgersprograma como ejemplo. Abra el menú contextual (con el botón derecho del ratón) delListLedgers.javaarchivo y elijaEjecutar 'ListLedgers'.

  3. Continúe enPaso 1: Crear un nuevo libro mayor de nuevopara iniciar el tutorial y crear un libro mayor.

En estas instrucciones se describe cómo automatizar la configuración de la aplicación de ejemplo de registro de vehículos de Amazon QLDB para Java, medianteAWS Cloud9como IDE. En esta guía, utilizas unAWS CloudFormationplantilla para aprovisionar sus recursos de desarrollo.

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

Parte 1: Aprovisionar los recursos

En este primer paso, utilizaAWS CloudFormationpara aprovisionar los recursos necesarios para configurar su entorno de desarrollo con la aplicación de ejemplo de Amazon QLDB.

Para abrirAWS CloudFormationconsola y carga 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 que admita QLDB. Para ver una lista completa, consulteCuotas y puntos de enlace de Amazon QLDBen laAWSReferencia general de.

    
                                    AWS Management Consolecaptura de pantalla de US East (N. Virginia) como el seleccionadoAWSRegión .
  2. En la páginaAWS CloudFormationconsola, elijaCreación de pilay luego seleccioneCon nuevos recursos (estándar).

  3. En la páginaCreación de pilapágina debajoEspecificar plantilla, eligeURL de Amazon S3.

  4. Escriba la siguiente URL y seleccionePróximo.

    https://amazon-qldb-assets.s3.amazonaws.com/templates/QLDB-DMV-SampleApp.yml
  5. Escriba unStack name(tales comoqldb-sample-app), y elijaPróximo.

  6. Puede añadir cualquier etiqueta según corresponda y conservar las opciones predeterminadas. A continuación, elija Next.

  7. Revise la configuración de la pila y elijaCreación de pila. LaAWS CloudFormationEl script podría tardar varios minutos en finalizar.

    Este script aprovisiona suAWS Cloud9con una instancia asociada de Amazon Elastic Compute Cloud (Amazon EC2) que se utiliza para ejecutar la aplicación de ejemplo de QLDB en este tutorial. También clona elaws-samples/amazon-qldb-dmv-sample-javarepositorio de GitHub en suAWS Cloud9entorno de desarrollo.

Parte 2: Configurar su IDE

En este paso, finalizará la configuración de su entorno de desarrollo en la nube. Descargue y ejecute un script de shell proporcionado para configurar elAWS Cloud9IDE con dependencias de aplicación de ejemplo.

Para configurar suAWS Cloud9entorno

  1. Abra el iconoAWS Cloud9Consola de enhttps://console.aws.amazon.com/cloud9/.

  2. UnderSus entornos, localice la tarjeta del entorno denominadoAplicación de muestra del DMV de QLDB, y elijaAbrir IDE. El entorno puede tardar un minuto en cargarse a medida que se lanza la instancia EC2 subyacente.

    SusAWS Cloud9está preconfigurado con las dependencias del sistema que necesita para ejecutar el tutorial. En el navegadorEntornopanel de navegación de la consola, confirma que ves una carpeta denominadaQLDB DMV Sample Application.

    
                                    AWS Cloud9captura de pantalla de la consola del panel de carpetas de entorno de aplicación de ejemplo DMV de QLDB.

    Si no ve un panel de navegación, active laEntornoen el lado izquierdo de la consola. Si no ve ninguna carpeta en el panel, activeMostrar raíz de entornoutilizando el icono de configuración ( ).

  3. En el panel inferior de la consola, debería ver un circuito abiertobashventana de terminal. Si no ve esto, elijaNew Terminal (Nuevo terminal)desde lasVentanamenú en 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, retira la rama correspondiente del repositorio de Git. En el navegadorAWS Cloud9terminal que creó en el paso anterior, ejecute los dos comandos siguientes en 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 impreso en el terminal:

    ** DMV Sample App setup completed , enjoy!! **
  5. Dedique un momento a buscar el código de aplicación de ejemplo enAWS Cloud9, en particular en la siguiente ruta de directorio:src/main/java/software/amazon/qldb/tutorial.

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

En este paso, aprenderá a ejecutar las tareas de aplicación de ejemplo DMV de Amazon QLDB medianteAWS Cloud9. Para ejecutar el código de muestra, vuelve a tuAWS Cloud9terminal o crea una nueva ventana de terminal como lo hizo enParte 2: Configurar el IDE.

Para ejecutar la aplicación de ejemplo

  1. Ejecute el siguiente comando en su terminal para cambiar 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 enumerar todos los libros mayores de suAWScuenta y región actual.

    ./gradlew run -Dtutorial=ListLedgers
  3. Continúe enPaso 1: Crear un nuevo libro mayor de nuevopara iniciar el tutorial y crear un libro mayor.

  4. (Opcional) Una vez que complete el tutorial, limpie suAWS CloudFormationSi ya no los necesita.

    1. Abra el iconoAWS CloudFormationConsola de enhttps://console.aws.amazon.com/cloudformationy elimine la pila que ha creado enParte 1: Aprovisionar sus recursos.

    2. Elimine también elAWS Cloud9pila que elAWS CloudFormationplantilla creada para ti.