AWS El servicio de modernización de mainframes (experiencia en entornos de ejecución gestionados) ya no está abierto a nuevos clientes. Para obtener prestaciones similares a las del Servicio de Modernización de AWS Mainframe (experiencia en entornos de ejecución gestionados), explore el Servicio de Modernización de AWS Mainframe (experiencia autogestionada). Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte Cambio en la disponibilidad de la modernización del [AWS mainframe.](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)
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.
# Tutorial: Utilice AWS Blu Age Developer en WorkSpaces aplicaciones
Este tutorial le muestra cómo acceder a AWS Blu Age Developer on WorkSpaces Applications y cómo usarlo con una aplicación de muestra para que pueda probar las funciones. Cuando haya acabado este tutorial, podrá seguir los mismos pasos con sus propias aplicaciones.
**Topics**
+ [Paso 1: Crear una base de datos](#tutorial-ba-developer-create-db)
+ [Paso 2: Acceder al entorno](#tutorial-ba-developer-access-env)
+ [Paso 3: Configurar el tiempo de ejecución](#tutorial-ba-developer-set-up-runtime)
+ [Paso 4: Iniciar el IDE de Eclipse](#tutorial-ba-developer-start-eclipse)
+ [Paso 5: Configurar un proyecto de Maven](#tutorial-ba-developer-set-up-maven)
+ [Paso 6: Configurar un servidor de Tomcat](#tutorial-ba-developer-config-tomcat)
+ [Paso 7: Implementar en Tomcat](#tutorial-ba-developer-deploy-tomcat)
+ [Paso 8: Crear la base de datos de JICS](#tutorial-ba-developer-create-jics)
+ [Paso 8: iniciar y probar la aplicación](#tutorial-ba-developer-test-app)
+ [Paso 10: Depurar la aplicación](#tutorial-ba-developer-debug)
+ [Eliminar recursos](#tutorial-ba-developer-clean)
## Paso 1: Crear una base de datos
En este paso, utilizará Amazon RDS para crear una base de datos PostgreSQL administrada que la aplicación de ejemplo utilizará para almacenar la información de configuración.
1. Abra la consola de Amazon RDS.
1. Seleccione **Bases de datos > Crear base de datos**.
1. Elija **Creación estándar > PostgreSQL**, deje la versión predeterminada y, a continuación, elija **Capa gratuita**.
1. Elija el identificador de la instancia de base de datos.
1. En **Configuración de credenciales**, seleccione **Administrar credenciales principales en AWS Secrets Manager**. Para obtener más información, consulte [Administración de contraseñas con Amazon RDS y AWS Secrets Manager](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html) en la *Guía del usuario de Amazon RDS*.
1. Asegúrese de que la VPC sea la misma que la que utiliza para la instancia de WorkSpaces aplicaciones. Puede solicitar este valor a su administrador.
1. En **Nuevo nombre del grupo de seguridad de VPC**, elija **Crear nuevo**.
1. Establezca **Acceso público** en **Sí**.
1. Deje los demás valores predeterminados. Revise estos valores.
1. Elija **Crear base de datos**.
Para que el servidor de base de datos sea accesible desde su instancia, seleccione el servidor de base de datos en Amazon RDS. En **Conectividad y seguridad**, elija el grupo de seguridad de VPC para el servidor de base de datos. Este grupo de seguridad se ha creado previamente para usted y debe tener una descripción similar a la de **Creado por la consola de administración de RDS**. Seleccione **Acción > Editar reglas de entrada**, elija **Agregar regla** y cree una regla de tipo **PostgreSQL**. Para el origen de la regla, utilice el grupo de seguridad **predeterminado**. Puede empezar a escribir el nombre del origen en el campo **Origen** y aceptar el ID sugerido. Por último, seleccione **Guardar reglas**.
## Paso 2: Acceder al entorno
En este paso, accederá al entorno de desarrollo de AWS Blu Age en WorkSpaces Applications.
1. Póngase en contacto con su administrador para conocer la forma correcta de acceder a su instancia de WorkSpaces Applications. Para obtener información general sobre posibles clientes y configuraciones, consulte [WorkSpaces Applications Access Methods and Clients](https://docs.aws.amazon.com/appstream2/latest/developerguide/clients-access-methods-user.html) en la *Amazon WorkSpaces Applications Administration Guide*. Considere la posibilidad de utilizar el cliente nativo para disfrutar de la mejor experiencia.
1. En WorkSpaces Aplicaciones, elija **Escritorio**.
## Paso 3: Configurar el tiempo de ejecución
En este paso, configuras el tiempo de ejecución de AWS Blu Age. Debe configurar el tiempo de ejecución en el primer lanzamiento y de nuevo si se le notifica una actualización del tiempo de ejecución. Este paso rellena la carpeta `.m2`.
1. Seleccione **Aplicaciones** en la barra de menús y, a continuación, elija **Terminal**.
1. Escriba el siguiente comando:
```
~/_install-velocity-runtime.sh
```
## Paso 4: Iniciar el IDE de Eclipse
En este paso, iniciará el IDE de Eclipse y elegirá la ubicación en la que desee crear un espacio de trabajo.
1. En WorkSpaces Aplicaciones, elija el icono Iniciar aplicación en la barra de herramientas y, a continuación, elija **Eclipse JEE.**
![\[Abra el icono de la aplicación en la barra de herramientas de WorkSpaces Aplicaciones. Eclipse JEE seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/aas-ba-eclipse.png)
1. Cuando se abra el lanzador, introduzca la ubicación en la que quiere crear su espacio de trabajo y elija **Launch**.
![\[Blu AgeEl lanzador Eclipse IDE en WorkSpaces Aplicaciones. Workspace seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-eclipse-launcher.png)
Si lo desea, puede lanzar Eclipse desde la línea de comandos, de la siguiente manera:
```
~/eclipse &
```
## Paso 5: Configurar un proyecto de Maven
En este paso, importará un proyecto de Maven para la aplicación de demostración Planets.
1. Sube el [PlanetsDemoarchivo -pom.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-pom.zip) a tu carpeta de inicio. Para ello, puede utilizar la característica “My Files” del cliente nativo.
1. Utilice la herramienta de línea de comandos de `unzip` para extraer los archivos.
1. Desplácese por la carpeta descomprimida y abra el `pom.xml` raíz de su proyecto en un editor de texto.
1. Edite la propiedad `gapwalk.version` para que coincida con el motor de tiempo de ejecución de AWS Blu Age instalado.
Si no conoce con seguridad la versión instalada, ejecute el siguiente comando en un terminal:
```
cat ~/runtime-version.txt
```
Este comando imprime la versión de tiempo de ejecución disponible actualmente, por ejemplo `3.1.0-b3257-dev`.
**nota**
No incluya el sufijo `-dev` en `gapwalk.version`. Por ejemplo, un valor válido sería `3.1.0-b3257`.
1. En Eclipse, elija **File** e **Import**. En la ventana de diálogo **Import**, expanda **Maven** y elija **Existing Maven Projects**. Elija **Next**.
1. En **Import Maven Projects**, proporcione la ubicación de los archivos extraídos y elija **Finish.**
Puede omitir la siguiente ventana emergente de forma segura. Maven descarga una copia local de `node.js` para compilar la parte angular (\$1-web) del proyecto:
![\[Mensaje que advierte de que falta el node.js.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-eclipse-node-warning.png)
Espere hasta el final de la compilación. Puede seguir la compilación en la vista de **Progreso**.
1. En Eclipse, seleccione el proyecto y elija **Run as**. Después, seleccione **Maven install**. Una vez que la instalación de Maven se haya realizado correctamente, se creará el archivo `war` en `PlanetsDemoPom/PlanetsDemo-web/target/PlanetsDemo-web-1.0.0.war`.
## Paso 6: Configurar un servidor de Tomcat
En este paso, configurará un servidor de Tomcat en el que implementará e iniciará la aplicación compilada.
1. En Eclipse, seleccione **Window > Show View > Servers** para mostrar la vista **Servers**:
![\[AWS Blu Age Eclipse con la vista de servidores seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-eclipse-servers.png)
1. Seleccione **No servers are available. Haga clic en este enlace para crear un nuevo servidor**. Se abrirá el asistente **New Server**. En el campo **Select the server type** del asistente, escriba **tomcat v9** y elija **Tomcat v9.0 Server**. A continuación, elija **Siguiente**.
![\[Cuadro de diálogo New Server. Servidor Tomcat v9.0 seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-eclipse-new-server.png)
1. Seleccione **Browse** y elija la carpeta **tomcat** situada en la raíz de la carpeta de inicio. Deje el JRE en su valor predeterminado y seleccione **Finish**.
Se ha creado un proyecto **Servers** en el espacio de trabajo y ahora hay un servidor Tomcat v9.0 disponible en la vista **Servers.** Aquí es donde se implementará e iniciará la aplicación compilada:
![\[AWS Pestaña de servidores de Blu Age Eclipse con el nuevo servidor Tomcat en la lista.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-eclipse-server-added.png)
## Paso 7: Implementar en Tomcat
En este paso, implementará la aplicación de ejemplo Planets en el servidor de Tomcat para poder ejecutar la aplicación.
1. Seleccione el archivo `PlanetsDemo-web` y elija **Run As > Maven install**. Vuelva a seleccionar `PlanetsDemo-web` y elija **Refresh** para asegurarse de que la interfaz compilada con npm esté correctamente compilada en un archivo .war y Eclipse la detecte.
1. Cargue el [PlanetsDemoarchivo -runtime.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-runtime.zip) a la instancia y descomprima el archivo en una ubicación accesible. Esto garantiza que la aplicación de demostración pueda acceder a las carpetas y archivos de configuración que necesite.
1. Copie el contenido de `PlanetsDemo-runtime/tomcat-config` en la subcarpeta `Servers/Tomcat v9.0...` que ha creado para su servidor Tomcat:
![\[AWS La subcarpeta Blu Age Eclipse Tomcat v9.0 y los archivos que contiene.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-eclipse-tomcat-subfolder.png)
1. Abra la entrada del servidor `tomcat v9.0` en la vista Servers. Aparece el editor de propiedades del servidor:
![\[Editor de propiedades del servidor. Pestaña Overview seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-eclipse-server-properties-editor.png)
1. En la pestaña **Overview**, aumente los valores de **Timeouts** a 450 segundos para Start y 150 segundos para Stop, como se muestra a continuación:
![\[Valor de tiempo de espera de inicio establecido en 450 segundos. Valor de tiempo de espera de fin establecido en 150 segundos.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-eclipse-timeout-values.png)
1. Seleccione **Open launch configuration**. Aparecerá el asistente. En el asistente, vaya a la carpeta **Arguments** y, en **Working directory**, elija **Other**. Elija **File System** y navegue hasta la carpeta `PlanetsDemo-runtime` descomprimida anteriormente. Esta carpeta debe contener una subcarpeta directa llamada **config**.
![\[Cuadro de diálogo Edit Configurations con el directorio de trabajo especificado en el campo Other.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-eclipse-edit-configuration.png)
1. Seleccione la pestaña **Modules** del editor de propiedades del servidor y realice los siguientes cambios:
+ Seleccione **Add Web Module** and añada `PlanetsDemo-service`.
+ Elija **Add External Web Module**. Aparece la ventana **Add Web Module**. Realice los siguientes cambios:
+ En **Document base**, elija **Browse** y vaya a `~/webapps/gapwalk-application...war`
+ En **Path**, introduzca `/gapwalk-application`.
+ Seleccione Aceptar.
+ Vuelva a seleccionar **Add External Web Module** y realice los siguientes cambios:
+ En **Document base**, introduzca la ruta a la interfaz .war (in `PlanetsDemo-web/target`)
+ En **Path**, introduzca `/demo`
+ Seleccione Aceptar.
+ Guarde las modificaciones del editor (Ctrl \$1 S).
El editor debe de mostrar un contenido similar al del siguiente ejemplo.
![\[Pestaña Web Modules de las propiedades del servidor Tomcat con los módulos.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-eclipse-web-modules.png)
## Paso 8: Crear la base de datos de JICS
En este paso, se conectará a la base de datos que ha creado en[Paso 1: Crear una base de datos](#tutorial-ba-developer-create-db).
1. Desde la instancia de WorkSpaces Aplicaciones, ejecute el siguiente comando en una terminal para iniciar: `pgAdmin`
```
./pgadmin-start.sh
```
1. Elija una dirección de correo electrónico y una contraseña como identificadores para el inicio de sesión. Tome nota de la URL proporcionada (normalmente es http://127.0.0.1:5050). Lance Google Chrome en la instancia, copie y pegue la URL en el navegador e inicie sesión con sus identificadores.
![\[Cuadro de diálogo de inicio de sesión de pgAdmin.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-pgadmin-login.png)
1. Después de iniciar sesión, elija **Add New Server** e introduzca la información de conexión a la base de datos creada anteriormente de la siguiente manera.
![\[Cuadro de diálogo del servidor de registro de pgAdmin. Pestaña Connection seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-pgadmin-register-server.png)
1. Cuando se conecte al servidor de base de datos, utilice **Object > Create > Database** y cree una nueva base de datos llamada **jics**.
1. Edite la información de conexión a la base de datos que ha utilizado la aplicación de demostración. Esta información se define en `PlanetsDemo-runtime/config/application-main.yml`. Busque la entrada `jicsDs`. Para recuperar los valores de `username` y `password`, vaya a la base de datos en la consola de Amazon RDS. En la pestaña **Configuración**, en **ARN de credenciales maestras**, seleccione **Administrar en Secrets Manager**. A continuación, en la consola de Secrets Manager, en el secreto, selecciona **Recuperar valor del secreto**.
## Paso 8: iniciar y probar la aplicación
En este paso, iniciará el servidor de Tomcat y la aplicación de demostración para poder probarla.
1. Para iniciar el servidor de Tomcat y las aplicaciones implementadas anteriormente, seleccione la entrada del servidor en la vista Servers y elija **Start**. Aparece una consola que muestra los registros de inicio.
1. Compruebe el estado del servidor en la vista **Servers** o espere a que aparezca el mensaje de **Server startup in [xxx] milliseconds** en la consola. Cuando se inicie el servidor, compruebe que gapwalk-application esté correctamente implementada. Para ello, acceda a la URL **http://localhost:8080/gapwalk-application** en un navegador Google Chrome. Debería ver lo siguiente:
![\[Mensaje de confirmación que indica que la aplicación jics se está ejecutando.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-jics-run-confirm.png)
1. Acceda a la interfaz de la aplicación implementada desde Google Chrome en http://localhost:8080/demo. Debería aparecer la página **Transaction Launcher** siguiente.
![\[Página del lanzador de transacciones del JICS.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-jics-launcher.png)
1. Para iniciar la transacción de la aplicación, introduzca `PINQ` en el campo de entrada y elija **Run** (o presione Intro).
Debería aparecer la pantalla de la aplicación de demostración.
![\[La pantalla PlanetsDemo de la aplicación en modo de inserción.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-demo-app-screen.png)
1. Escriba el nombre de un planeta en el campo correspondiente y pulse Intro.
![\[La pantalla de la PlanetsDemo aplicación con la Tierra ingresada en el campo Nombre del planeta.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-demo-with-data.png)
## Paso 10: Depurar la aplicación
En este paso, probará las características de depuración estándar de Eclipse. Estas características están disponibles cuando se trabaja en una aplicación modernizada.
1. Para abrir la clase de servicio principal, pulse Ctrl \$1 Mayús \$1 T. Después, introduzca `PlanetsinqProcessImpl`.
![\[Se PlanetsinqProcessImpl ha introducido la ventana de diálogo Open Type de Eclipse.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ba-eclipse-open-type.png)
1. Navegue hasta el método `searchPlanet` y coloque allí un punto de ruptura.
1. Seleccione el nombre del servidor y elija **Restart in Debug**.
1. Repita los pasos anteriores. Es decir, acceda a la aplicación, introduzca el nombre de un planeta y pulse Intro.
Eclipse detendrá la aplicación en el método `searchPlanet`. Ahora puede examinarlo.
## Eliminar recursos
Si ya no necesita los recursos que ha creado para este tutorial, elimínelos para que no se le cobre por ellos. Realice los siguientes pasos:
+ Si la aplicación Planets sigue ejecutándose, deténgala.
+ Elimine la base de datos que ha creado en [Paso 1: Crear una base de datos](#tutorial-ba-developer-create-db). Para obtener más información, consulte [Eliminación de una instancia de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html).