

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.

# Configurar AWS Blu Age Runtime
<a name="ba-runtime-setup"></a>

En esta sección se explican los pasos para configurar AWS Blu Age Runtime en su AWS infraestructura. Antes de configurar su AWS Blu Age Runtime para las aplicaciones, comprenda los requisitos previos, las regiones y los intervalos, así como la configuración de las CloudWatch alarmas, para configurar y administrar su entorno de ejecución.

**Topics**
+ [AWS Requisitos previos de Blu Age Runtime](ba-runtime-setup-prereq.md)
+ [Incorporación de AWS Blu Age Runtime](ba-runtime-setup-onboard.md)
+ [Requisitos de configuración de infraestructura para AWS Blu Age Runtime](ba-infrastructure-setup.md)
+ [AWS artefactos de Blu Age Runtime](ba-runtime-artifacts.md)
+ [Implemente AWS Blu Age Runtime en Amazon EC2](ba-deploy-ec2.md)
+ [Implemente AWS Blu Age Runtime en contenedores de Amazon ECS y Amazon EKS](ba-deploy-container.md)
+ [Probar la PlanetsDemo aplicación](ba-runtime-test-planetsdemo.md)

# AWS Requisitos previos de Blu Age Runtime
<a name="ba-runtime-setup-prereq"></a>

AWS Blu Age Runtime está disponible en varias versiones [AWS Notas de lanzamiento de Blu Age](ba-release-notes.md) de lanzamiento. Si tiene proyectos de modernización en curso, es posible que necesite versiones incrementales del tiempo de ejecución para fines de implementación y pruebas. Para definir sus necesidades, póngase en contacto con su gerente de entrega de AWS Blu Age.

Antes de empezar a utilizar el AWS Blu Age Runtime, haga lo siguiente:
+ Asegúrese de tener una AWS cuenta.
+ Asegúrese de tener una aplicación modernizada refactorizada con Blu Age. AWS 
+ Elige una AWS región y una de las opciones de procesamiento compatibles con Blu Age Runtime. AWS 
+ Elige la versión de AWS Blu Age Runtime que quieras usar.
+ Revisa [Requisitos de configuración de infraestructura para AWS Blu Age Runtime](ba-infrastructure-setup.md) y valida los componentes adicionales necesarios para ejecutar el AWS Blu Age Runtime.

**nota**  
Si quieres probar las funciones de AWS Blu Age Runtime, puedes usar la aplicación de demostración`Planets Demo`, que puedes descargar desde [PlanetsDemo-v1.zip](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip).

# Incorporación de AWS Blu Age Runtime
<a name="ba-runtime-setup-onboard"></a>

**nota**  
El acceso a AWS Blu Age Runtime ha pasado de las solicitudes basadas en tickets a la descarga directa a través de [AWS](https://bluinsights.aws/) Blu Insights. Hemos introducido una forma nueva y simplificada de acceder a los Blu Age productos a través de la función [Blu AgeToolbox](https://bluinsights.aws/docs/bluage-toolbox-introduction) de AWS Blu Insights.

Para empezar, cree un [AWS Support](https://support.console.aws.amazon.com/support/home)caso para solicitar la incorporación a AWS Blu Age Runtime. Incluye en tu solicitud tu Cuenta de AWS ID, la AWS región que deseas usar y una opción de procesamiento, además de la versión de AWS Blu Age Runtime. Si no estás seguro de qué versión necesitas, ponte en contacto con tu responsable de entregas de AWS Blu Age. Si ya tiene el código fuente de la aplicación generado por las herramientas de refactorización de la modernización de AWS mainframe, anote el valor de la `gapwalk.version` etiqueta en el `pom.xml` archivo de su base de código modernizada.

**nota**  
El AWS Blu Age Runtime está disponible en dos versiones principales: versiones preliminares y versiones Alpha. Para determinar qué versión utilizar[AWS Control de versiones de Blu Age](ba-versioning.md), consulta o ponte en contacto con tu responsable de entregas de AWS Blu Age.

## Regiones y segmentos de AWS Blu Age Runtime
<a name="ba-runtime-setup-buckets"></a>

Almacenamos los artefactos de AWS Blu Age Runtime en diferentes depósitos de Amazon S3 por región y por elección de cómputo. Para acceder al depósito correspondiente a Región de AWS AWS Blu Age Runtime, usa el nombre que aparece en la siguiente tabla.


| Región de AWS | Bucket de versión | Bucket de versión preliminar alfa | 
| --- | --- | --- | 
|  Este de EE. UU. (Ohio)  |  aws-bluage-runtime-artifacts-055777665268-Este-EE. UU.  | aws-bluage-runtime-artifacts-dev-055777665268-us-east-2 | 
|  Este de EE. UU. (Norte de Virginia)  |  aws-bluage-runtime-artifacts-139023371234-Estados Unidos-Este-1  | aws-bluage-runtime-artifacts-dev-139023371234-uso-este-1 | 
|  Oeste de EE. UU. (Norte de California)  |  aws-bluage-runtime-artifacts-788454048782-us-west-1  | aws-bluage-runtime-artifacts-dev-788454048782-us-west-1 | 
|  Oeste de EE. UU. (Oregón)  |  aws-bluage-runtime-artifacts-836771190483-Estados Unidos-Oeste-2  | aws-bluage-runtime-artifacts-dev-836771190483-us-west-2 | 
|  Canadá (centro)  |  aws-bluage-runtime-artifacts-637423580979-ca-central-1  |  aws-bluage-runtime-artifacts-dev-637423580979-ca-central-1  | 
|  Europa (Irlanda)  |  aws-bluage-runtime-artifacts-925278190477-eu-west-1  | aws-bluage-runtime-artifacts-dev-925278190477-eu-west-1 | 
|  Europa (Londres)  |  aws-bluage-runtime-artifacts-767397831990-eu-west-1  |  aws-bluage-runtime-artifacts-dev-767397831990-eu-west-1  | 
|  Europa (París)  |  aws-bluage-runtime-artifacts-673009995881-eu-west-3  | aws-bluage-runtime-artifacts-dev-673009995881-eu-west-3 | 
|  Europa (Fráncfort)  |  aws-bluage-runtime-artifacts-485196800481-eu-central-1  | aws-bluage-runtime-artifacts-dev-485196800481-eu-central-1 | 
|  Europa (Estocolmo)  |  aws-bluage-runtime-artifacts-654654484534-eu-norte-1  |  aws-bluage-runtime-artifacts-dev-654654484534-eu-norte-1  | 
|  Europa (Milán)  |  aws-bluage-runtime-artifacts-654654328338-eu-sur-1  |  aws-bluage-runtime-artifacts-dev-654654328338-eu-sur-1  | 
|  Europa (España)  |  aws-bluage-runtime-artifacts-905417994954-eu-sur-2  |  aws-bluage-runtime-artifacts-dev-905417994954-eu-sur-2  | 
|  América del Sur (São Paulo)  |  aws-bluage-runtime-artifacts-737536804457-sa-este-1  | aws-bluage-runtime-artifacts-dev-737536804457-sa-este-1 | 
|  Asia-Pacífico (Tokio)  |  aws-bluage-runtime-artifacts-445578176276-ap-northeast-1  | aws-bluage-runtime-artifacts-dev-445578176276-ap-northeast-1 | 
|  Asia-Pacífico (Seúl)  |  aws-bluage-runtime-artifacts-381492221498-ap-northeast-2  |  aws-bluage-runtime-artifacts-dev-381492221498-ap-northeast-2  | 
|  Asia-Pacífico (Osaka)  |  aws-bluage-runtime-artifacts-905418229615-ap-northeast-3  |  aws-bluage-runtime-artifacts-dev-905418229615-ap-northeast-3  | 
|  Asia-Pacífico (Singapur)  |  aws-bluage-runtime-artifacts-767397774613-ap-southeast-1  |  aws-bluage-runtime-artifacts-dev-767397774613-ap-sudeste-1  | 
|  Asia-Pacífico (Sídney)  |  aws-bluage-runtime-artifacts-726160321909-ap-southeast-2  | aws-bluage-runtime-artifacts-dev-726160321909-ap-sudeste-2 | 
|  Asia-Pacífico (Mumbai)  |  aws-bluage-runtime-artifacts-905418353577-ap-sur-1  |  aws-bluage-runtime-artifacts-dev-905418353577-ap-sur-1  | 
|  África (Ciudad del Cabo)  |  aws-bluage-runtime-artifacts-992382777663-af-sur-1  |  aws-bluage-runtime-artifacts-dev-992382777663-af-sur-1  | 
|  Israel (Tel Aviv)  |  aws-bluage-runtime-artifacts-471112516508-il-central-1  |  aws-bluage-runtime-artifacts-dev-471112516508-il-central-1  | 

## Se usa para enumerar el contenido del depósito AWS CLI
<a name="ba-runtime-setup-cmds"></a>

Una vez incorporado o incorporada, puede ver una lista del contenido del bucket ejecutando el siguiente comando AWS CLI en un terminal.

`aws s3 ls bucket-name `

`bucket-name`Sustitúyalo por el nombre del depósito correspondiente Región de AWS a usted de la tabla anterior.

Este comando devuelve una lista de carpetas que corresponden a diferentes versiones del motor de ejecución de AWS Blu Age Runtime, como la siguiente para un depósito de versiones:

```
PRE 4.0.0/
PRE 4.10.0/
```

O lo siguiente para un bucket de compilación:

```
PRE 4.11.0/
PRE 4.13.0/
```

Le recomendamos que utilice la última versión disponible. Si eso no es posible, utilice la versión de tiempo de ejecución que se validó durante la fase de refactorización de la aplicación. Para ver una lista de los marcos disponibles para una versión específica, ejecute el siguiente comando:

`aws s3 ls s3://bucket-name/version/Framework/`

`bucket-name`Sustitúyelo por el nombre del depósito Región de AWS y `version` por la versión que desee. A continuación se muestran dos ejemplos:

Para un bucket de versión:

`aws s3 ls s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.10.0/Framework/`

El comando devuelve una lista de archivos zip, como:

```
2025-04-08 16:11:19  152040176 aws-bluage-runtime-4.10.0.zip
2025-04-08 16:11:52  176518889 aws-bluage-webapps-4.10.0.zip
```

Para una versión preliminar de Alpha:

`aws s3 ls s3://aws-bluage-runtime-artifacts-dev-139023371234-us-east-1/4.11.0/Framework/`

El comando devuelve una lista de archivos zip, como:

```
2025-04-09 20:23:34  152304534 aws-bluage-runtime-4.11.0.zip
2025-04-09 20:24:07  176262381 aws-bluage-webapps-4.11.0.zip
```

## Descarga del marco
<a name="ba-runtime-setup-download"></a>

Puede descargar el marco, por ejemplo, para actualizar la versión de AWS Blu Age Runtime en una EC2 instancia de Amazon existente.

`aws s3 cp s3://bucket-name/version/Framework/ folder-of-your-choice --recursive `

Donde:

folder-of-your-choice  
ruta de la carpeta en la que vaya a descargar el marco.

Por ejemplo: `aws s3 cp s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/ . --recursive`

Este comando produce el resultado siguiente:

```
download: s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/aws-bluage-webapps-4.0.0.zip to ./aws-bluage-webapps-4.0.0.zip
download: s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/aws-bluage-runtime-4.0.0.zip to ./aws-bluage-runtime-4.0.0.zip
```

Puede obtener una lista de los archivos del marco de la siguiente manera:

`ls -l`

Este comando produce el resultado siguiente:

```
total 230928
-rw-rw-r-- 1 cloudshell-user cloudshell-user 152040176 Apr  8 16:11 aws-bluage-runtime-4.0.0.zip
-rw-rw-r-- 1 cloudshell-user cloudshell-user 176518889 Apr  8 16:11 aws-bluage-webapps-4.0.0.zip
```

**nota**  
El acceso a los artefactos puede interrumpirse temporalmente y las versiones pueden eliminarse por motivos de seguridad. Te recomendamos encarecidamente que guardes los artefactos que utilices en tu propia cuenta. La versión local debe usarse como referencia en sus arquitecturas internas.

# Requisitos de configuración de infraestructura para AWS Blu Age Runtime
<a name="ba-infrastructure-setup"></a>

En este tema se describe la configuración de infraestructura mínima necesaria para ejecutar AWS Blu Age Runtime. Los siguientes procedimientos describen cómo configurar AWS Blu Age Runtime en el ordenador que prefiera para implementar una aplicación modernizada en AWS Blu Age Runtime. Los recursos que cree deben estar en una Amazon VPC que tenga una subred dedicada al dominio de su aplicación.

**Topics**
+ [Requisitos de infraestructura](#infrastructure-requirements)
+ [Ejecutando AWS Blu Age Runtime en Amazon EC2](#ba-running-on-ec2)
+ [Ejecución de AWS Blu Age Runtime en Amazon ECS en Amazon EC2](#ba-running-on-ecs-on-ec2)
+ [Ejecutar AWS Blu Age Runtime en Amazon EKS en Amazon EC2](#ba-running-on-eks-on-ec2)
+ [Ejecución de AWS Blu Age Runtime en Amazon ECS gestionado por AWS Fargate](#ba-running-on-fargate)

## Requisitos de infraestructura
<a name="infrastructure-requirements"></a>

**Creación de un grupo de seguridad**

Si planea trabajar con EC2 instancias de Amazon en Amazon EKS, omita este procedimiento porque el proceso de creación del clúster de Amazon EKS crea un grupo de seguridad en su nombre. Utilice ese grupo de seguridad en los siguientes procedimientos en lugar de crear otro nuevo.

1. Abra la consola de Amazon VPC en [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/).

1. En el panel de navegación izquierdo, en **Seguridad**, elija **Grupos de seguridad**.

1. En el panel central, elija **Crear grupos de seguridad**.

1. En el campo **Nombre del grupo de seguridad**, escriba **M2BluagePrivateLink-SG**.

1. En la sección **Inbound rules (Reglas de entrada)**, elija **Add rule (agregar regla)**.

1. En **Tipo**, seleccione HTTPS.

1. En **Origen**, introduzca el CIDR de su VPC.

1. En la sección **Reglas salientes**, elija **Agregar regla**.

1. En **Tipo**, seleccione HTTPS.

1. En **Destino**, escriba **0.0.0.0/0**.

1. Elija **Creación de grupo de seguridad**.

**Creación de un rol de IAM**

1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. En el panel de navegación, en **Administración del acceso**, elija **Roles**.

1. En el panel central, elija **Crear rol**.

1. En la sección **Casos de uso**, en función de la opción de computación que elija, seleccione una de las siguientes opciones:
   + **EC2**(para Amazon EC2 y Amazon EKS en Amazon EC2)
   + **Elastic Container Service** y, después, **EC2Rol para Elastic Container Service** (para Amazon ECS en Amazon EC2)
   + **Elastic Container Service** y, a continuación, **Tarea de Elastic Container Service** (para Amazon ECS administrado por Fargate)

1. Elija **Siguiente**.

1. Ingrese un nombre para el rol y, a continuación, seleccione **Crear rol**.

## Ejecutando AWS Blu Age Runtime en Amazon EC2
<a name="ba-running-on-ec2"></a>

Para crear una EC2 instancia de Amazon, sigue estos pasos. 

**Crear una EC2 instancia de Amazon**

1. Abre la EC2 consola de Amazon en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Seleccione **Iniciar instancia**.

1. En **Tipo de instancia**, elija un tipo de instancia EC2 disponible.

1. En la sección **Par de claves**, seleccione o bien un par de claves existente o bien cree uno nuevo.

1. En la sección **Configuración de red**, elija **Seleccionar grupo de seguridad existente**.

1. En **Grupos de seguridad comunes**, elija **M2 BluagePrivateLink -SG**.

1. Amplíe la sección **Detalles avanzados**.

1. En **Perfil de instancia de IAM**, seleccione el rol de IAM que creó antes.

1. Seleccione **Iniciar instancia**.

**Instalar la aplicación en la EC2 instancia de Amazon**

1. Cuando el estado de la EC2 instancia de Amazon cambie a En **ejecución**, conéctese a la instancia.

1. Instala los siguientes componentes de software en la instancia (consulta las versiones que se mencionan en la[AWS Notas de lanzamiento de Blu Age](ba-release-notes.md)):
   + Java Runtime Environment (JRE).
   + Apache Tomcat.
   + AWS Blu Age Runtime (en Amazon EC2). Instale el motor de ejecución AWS Blu Age en la raíz de la carpeta de instalación de Apache Tomcat (algunos archivos se añadirán y otros se sobrescribirán).

   Para instalar las aplicaciones web adicionales que se incluyen con el archivo AWS Blu Age Runtime, configure una instancia secundaria del servidor Apache Tomcat y descomprima el archivo de aplicaciones web en esa ubicación. Para obtener instrucciones detalladas, consulte [AWS artefactos de Blu Age Runtime](ba-runtime-artifacts.md).

## Ejecución de AWS Blu Age Runtime en Amazon ECS en Amazon EC2
<a name="ba-running-on-ecs-on-ec2"></a>

1. Cree un clúster de Amazon ECS con ** EC2 instancias de Amazon** como infraestructura subyacente. Consulte [Introducción a Windows en Amazon EC2 en](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-ecs-ec2-v2.html#getting-started-ec2-cluster-v2) la Guía para desarrolladores de Amazon Elastic Container Service.

1. Especifique el rol de IAM que creó en los pasos anteriores.

1. Elija un tipo de EC2 instancia.

1. En **Configuración de red para EC2 instancias de Amazon**, elige el grupo de seguridad que creaste en los pasos anteriores.

## Ejecutar AWS Blu Age Runtime en Amazon EKS en Amazon EC2
<a name="ba-running-on-eks-on-ec2"></a>

1. Cree un clúster de Amazon EKS. Consulte [Creación de un clúster de Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html) en la *Guía del usuario de Amazon EKS*.

1. Como se ha mencionado anteriormente, se crea un grupo de seguridad en su nombre.

1. Cree un grupo de nodos. Especifique el rol de IAM que creó en los pasos anteriores.

1. Elija un tipo de EC2 instancia.

1. Amazon EKS asignará automáticamente el grupo de seguridad a las EC2 instancias de Amazon generadas.

## Ejecución de AWS Blu Age Runtime en Amazon ECS gestionado por AWS Fargate
<a name="ba-running-on-fargate"></a>

Cree un clúster de Amazon ECS con **AWS Fargate (sin servidor)** como infraestructura subyacente. Consulte [Introducción a Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-fargate.html) en la *Amazon Elastic Container Service Developer Guide*.

# AWS artefactos de Blu Age Runtime
<a name="ba-runtime-artifacts"></a>

AWS Los artefactos de Blu Age Runtime son los componentes para implementar y ejecutar aplicaciones modernizadas. Este documento describe los diferentes tipos de artefactos disponibles, sus ubicaciones de almacenamiento y cómo acceder a ellos.

## AWS Artefactos de Blue Age Runtime
<a name="ba-runtime-artifacts-contents"></a>

### Contenido de los artefactos
<a name="ba-runtime-artifacts-artifacts"></a>

Tanto en la sección de lanzamiento como en la versión preliminar, encontrarás:

**gapwalk-x.y.z.zip**

Este archivo, donde x.y.z representa el número de versión (consulte Control de [versiones de Blu Age), contiene los componentes principales de AWS Blu Age Runtime](https://docs.aws.amazon.com/m2/latest/userguide/ba-versioning.html) esenciales para ejecutar aplicaciones de AWS Blu Age, entre los que se incluyen: AWS 


| Artefacto | Description (Descripción) | Tipo | Carpeta de distribución | 
| --- | --- | --- | --- | 
| gapwalk-application-x.y.z.war | Blu Ageaplicación web principal Gapwalk | Guerra | webapps | 
| \$1.jar | Blu AgeBibliotecas compartidas de Runtime Framework (Gapwalk) | Frascos | guardado | 
| gapwalk-\$1-x.y.z.war | Blu Ageaplicaciones web adicionales (utility-pgm, soporte jerárquico,...) | ¿Guerra | webapps-extra | 
| bac-x.y.z.war/jac-x.y.z.war | Blu AgeConsolas de administración (no independientes) | Guerra | webapps-consolas | 

**aws-bluage-webapps-x.y.z.zip**

Este archivo, en el que x.y.z sigue el mismo esquema de control de versiones que el anterior, incluye las consolas de administración (independientes) Blu Age
+ Archivo WAR **BAC** (Blusamconsola), que se utiliza para supervisar la base de datos. Blusam
+ Archivo WAR **JAC** (consola JICS), utilizado para monitorear la base de datos JICS.
+ Bibliotecas de apoyo necesarias.

### Verificación de firma de paquete
<a name="ba-runtime-signed"></a>

Los archivos zip publicados se proporcionan como archivos ZIP firmados digitalmente para garantizar la seguridad y la autenticidad. Las firmas digitales ayudan a comprobar que los archivos que descargas son auténticos, están inalterados y han sido publicados oficialmente por nuestra organización. Esto evita la manipulación y protege contra el malware o los archivos comprometidos que podrían distribuirse de forma malintencionada.

Para comprobar la firma del archivo ZIP antes de usarlo, puede utilizar el siguiente comando:

`jarsigner -verify -certs -verbose aws-bluage-runtime-x.y.z.zip`

Este es el ejemplo de resultado de un archivo certificado:

```
...
jar verified.
```

Para obtener más información sobre cómo se abordan las vulnerabilidades de seguridad, consulte la descripción general de las [Blu Ageversiones de AWS Mainframe Modernization Refactorization with AWS](https://docs.aws.amazon.com/m2/latest/userguide/lifecycle-m2.html#lifecycle-ba-overview).

**nota**  
Si bien nos esforzamos por lanzar nuestros productos sin ellos CVEs, es CVEs posible que aparezcan nuevos productos más adelante.

# Implemente AWS Blu Age Runtime en Amazon EC2
<a name="ba-deploy-ec2"></a>

Puedes aprender cómo configurar AWS Blu Age Runtime en Amazon EC2, cómo actualizar la versión en tiempo de ejecución, cómo monitorizar tu despliegue mediante CloudWatch las alarmas de Amazon y cómo añadir dependencias con licencia en los temas de esta sección. Estas instrucciones se aplican tanto al crear EC2 instancias de Amazon como al utilizar Amazon ECS en Amazon EC2 o Amazon EKS en Amazon EC2.

A partir de la versión alfa 5.60.0, la distribución de AWS Blu Age Runtime incluye una carpeta de despliegue con un archivo README.md completo. Esta guía proporciona instrucciones de EC2 despliegue de step-by-step Amazon, opciones de configuración y consejos para la solución de problemas.

**Topics**
+ [Configura AWS Blu Age Runtime en Amazon EC2](ba-runtime-deploy-ec2.md)
+ [Actualiza el tiempo de ejecución de AWS Blu Age en Amazon EC2](ba-runtime-maint-ec2.md)
+ [Configura las CloudWatch alarmas de Amazon de AWS Blu Age Runtime (en Amazon EC2)](ba-cw-alarms-ec2.md)
+ [Configura dependencias con licencia en AWS Blu Age Runtime en Amazon EC2](ba-runtime-dependencies-ec2.md)

# Configura AWS Blu Age Runtime en Amazon EC2
<a name="ba-runtime-deploy-ec2"></a>

En este tema se explica cómo configurar e implementar la aplicación de PlanetsDemo ejemplo con AWS Blu Age Runtime en Amazon EC2.

**Topics**
+ [Requisitos previos](#ba-runtime-deploy-prereq)
+ [Configuración](#ba-runtime-deploy-setup)
+ [Prueba de la aplicación implementada](#ba-runtime-deploy-test)

## Requisitos previos
<a name="ba-runtime-deploy-prereq"></a>

Antes de comenzar, asegúrese de que cumple los requisitos previos que se indican a continuación:
+ Configure el AWS CLI archivo siguiendo los pasos que se indican en [Configuración de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html).
+ Complete [AWS Requisitos previos de Blu Age Runtime](ba-runtime-setup-prereq.md) y [Incorporación de AWS Blu Age Runtime](ba-runtime-setup-onboard.md).
+ Crea una EC2 instancia de Amazon con uno de los tipos de instancias compatibles. Para [obtener más información, consulte Introducción a las instancias de Amazon EC2 Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html).
+ Asegúrese de poder conectarse a la EC2 instancia de Amazon correctamente, por ejemplo, mediante SSM.
**nota**  
A lo largo de esta guía, se asume que la ruta de instalación de Tomcat es. `/m2-anywhere/tomcat-gapwalk/velocity` Asegúrese de utilizar esta ruta cuando siga las instrucciones siguientes o adapte la siguiente instrucción a la ruta que elija.
+ Descarga y extrae AWS Blu Age Runtime (en Amazon EC2) directamente en el directorio velocity `/m2-anywhere/tomcat-gapwalk/velocity` (la carpeta de instalación de Tomcat). Para obtener instrucciones sobre cómo recuperar los artefactos de AWS Blu Age Runtime, incluida información sobre el almacenamiento, el acceso y el contenido, consulte[AWS artefactos de Blu Age Runtime](ba-runtime-artifacts.md).
+ Descargue el [archivo PlanetsDemo de la aplicación](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip).
+ Descomprima el archivo y cargue la aplicación en el bucket de Amazon S3 de su elección.
+ Cree una base de datos PostgreSQL de Amazon Aurora para JICS. El motor de ejecución de AWS Blu Age ejecutará automáticamente el `PlanetsDemo-v1/jics/sql/initJics.sql` script durante el primer inicio. Para obtener información sobre cómo crear una base de datos de PostgreSQL de Amazon Aurora, consulte [Creación de un clúster de base de datos de Aurora PostgreSQL y conexión a él](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster).

## Configuración
<a name="ba-runtime-deploy-setup"></a>

Para configurar la aplicación PlanetsDemo de muestra, complete los siguientes pasos.

1. Conéctese a su EC2 instancia de Amazon y vaya a la `conf` carpeta situada debajo de la carpeta de instalación de Apache Tomcat 10. Abra el archivo `catalina.properties` para editarlo y sustituya la línea que empieza por `common.loader` por la siguiente línea.

   ```
   common.loader="${catalina.base}/lib","${catalina.base}/lib/*.jar","${catalina.home}/lib","${catalina.home}/lib/*.jar","${catalina.home}/shared","${catalina.home}/shared/*.jar","${catalina.home}/extra","${catalina.home}/extra/*.jar"
   ```

1. Vaya a la carpeta `/m2-anywhere/tomcat-gapwalk/velocity/webapps`.

1. Copie los PlanetsDemo archivos binarios disponibles en la `PlanetsDemo-v1/webapps/` carpeta del bucket de Amazon S3 mediante el siguiente comando.

   ```
   aws s3 cp s3://path-to-demo-app-webapps/ . --recursive
   ```
**nota**  
`path-to-demo-app-webapps`Sustitúyalo por el URI de Amazon S3 correcto para el depósito en el que descomprimió el PlanetsDemo archivo anteriormente.

1. Copie el contenido de la carpeta `PlanetsDemo-v1/config/` a `/m2-anywhere/tomcat-gapwalk/velocity/config/`.

1. Proporcione la información de conexión para la base de datos que creó como parte de los requisitos previos en el siguiente fragmento de código del archivo `/m2-anywhere/tomcat-gapwalk/velocity/config/application-main.yml`. Para obtener más información, consulte [Creación de un clúster de base de datos de Aurora PostgreSQL y conexión a él](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster).

   ```
   datasource:
      jicsDs:
        driver-class-name :  
        url: 
        username: 
        password: 
        type :
   ```

1. Inicie el servidor de Apache Tomcat y compruebe los registros.

   ```
   /m2-anywhere/tomcat-gapwalk/velocity/startup.sh
   
   tail -f /m2-anywhere/tomcat-gapwalk/velocity/logs/catalina.log
   ```

   Si encuentra códigos de error que empiecen por una C seguida de un número, como CXXXX, anote los mensajes de error. Por ejemplo, el código de error C5102 es un error común que indica una configuración de infraestructura incorrecta.

## Prueba de la aplicación implementada
<a name="ba-runtime-deploy-test"></a>

Para ver un ejemplo de cómo probar la PlanetsDemo aplicación, consulte. [Probar la PlanetsDemo aplicación](ba-runtime-test-planetsdemo.md)

# Actualiza el tiempo de ejecución de AWS Blu Age en Amazon EC2
<a name="ba-runtime-maint-ec2"></a>

Esta guía describe cómo actualizar el tiempo de ejecución de AWS Blu Age en Amazon EC2.

**Topics**
+ [Requisitos previos](#ba-runtime-maint-prereq)
+ [Actualice el tiempo de ejecución de AWS Blu Age en la EC2 instancia de Amazon](#ba-runtime-maint-copy-files)
+ [Actualice el tiempo de ejecución de AWS Blu Age en un contenedor](#ba-runtime-maint-copy-files)

## Requisitos previos
<a name="ba-runtime-maint-prereq"></a>

Antes de comenzar, asegúrese de que cumple los siguientes requisitos previos:
+ Para comprobar si hay instrucciones específicas para su versión, consulte [Instrucciones de actualización para AWS Blu Age](ba-migration-notes.md).
+ Complete [AWS Requisitos previos de Blu Age Runtime](ba-runtime-setup-prereq.md) y [Incorporación de AWS Blu Age Runtime](ba-runtime-setup-onboard.md).
+ Asegúrese de tener una EC2 instancia de Amazon con una instalación de AWS Blu Age Runtime existente. Para [obtener más información, consulte Introducción a las instancias de Amazon EC2 Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html).
+ Asegúrese de poder conectarse a la EC2 instancia de Amazon correctamente, por ejemplo, mediante SSM.
+ Descarga la versión de AWS Blu Age Runtime a la que deseas actualizar. El marco consta de dos archivos: `gapwalk-x.y.z.zip` y`aws-bluage-webapps-x.y.z.zip`. Para obtener más información, consulte [AWS artefactos de Blu Age Runtime](ba-runtime-artifacts.md).

## Actualice el tiempo de ejecución de AWS Blu Age en la EC2 instancia de Amazon
<a name="ba-runtime-maint-copy-files"></a>

Complete los siguientes pasos para actualizar el tiempo de ejecución de AWS Blu Age.

1. Conéctate a tu EC2 instancia de Amazon y cambia el usuario a **su** ejecutando el siguiente comando.

   ```
   sudo su
   ```

   En este tutorial, necesitará el privilegio de superusuario para ejecutar los comandos.

1. Para extraer los archivos binarios, utilice los siguientes comandos: Ejecute los comandos en cada carpeta:

   ```
   unzip gapwalk-x.y.z.zip
   unzip aws-bluage-webapps-x.y.z.zip
   ```

1. Detenga los servicios de Apache Tomcat con los siguientes comandos.

   ```
   systemctl stop tomcat.service
   systemctl stop tomcat-webapps.service
   ```

1. Sustituya el contenido de `<your-tomcat-path>/shared/` por el contenido de `gapwalk-x.y.z/shared/`.

1. Sustituya `<your-tomcat-path>/webapps/gapwalk-application.war` por `gapwalk-x.y.z/webapps/gapwalk-application.war`.

1. Reemplace los archivos war de `<your-tomcat-path>/webapps/`, es decir `bac.war` y `jac.war`, por los mismos archivos de `aws-bluage-webapps-x.y.z/velocity/webapps/`.

1. Inicie los servicios de Apache Tomcat ejecutando los siguientes comandos.

   ```
   systemctl start tomcat.service
   systemctl start tomcat-webapps.service
   ```

1. Consulte los registros.

Para comprobar el estado de la aplicación implementada, ejecute los siguientes comandos.

```
curl http://localhost:8080/gapwalk-application/
```

Debería aparecer el siguiente mensaje.

```
Jics application is running
```

```
curl http://localhost:8181/jac/api/services/rest/jicsservice/
```

Debería aparecer el siguiente mensaje.

```
Jics application is running
```

```
curl http://localhost:8181/bac/api/services/rest/bluesamserver/serverIsUp
```

La respuesta debe estar vacía.

El tiempo de ejecución de AWS Blu Age se actualizó correctamente.

## Actualice el tiempo de ejecución de AWS Blu Age en un contenedor
<a name="ba-runtime-maint-copy-files"></a>

Complete los siguientes pasos para actualizar el tiempo de ejecución de AWS Blu Age.

1. Reconstruye tu imagen de Docker con la versión de AWS Blu Age Runtime que desees. Para obtener instrucciones, consulte [Configura AWS Blu Age Runtime en Amazon EC2](ba-runtime-deploy-ec2.md).

1. Envíe la imagen de Docker a su repositorio de Amazon ECR.

1. Detenga y reinicie el servicio de Amazon ECS o Amazon EKS.

1. Consulte los registros.

El tiempo de ejecución de AWS Blu Age se actualizó correctamente.

# Configura las CloudWatch alarmas de Amazon de AWS Blu Age Runtime (en Amazon EC2)
<a name="ba-cw-alarms-ec2"></a>

Puede configurarlo CloudWatch para recibir el registro de su aplicación y añadir una alarma que le avise de posibles errores. Esto le permite tener notificaciones más visibles siempre que las aplicaciones implementadas encuentren excepciones. Las siguientes secciones le ayudarán a comprender y obtener información sobre la configuración del CloudWatch registro y la configuración de las alarmas.

## Habilite el CloudWatch registro
<a name="ba-cw-log-deploy"></a>

Para habilitar el CloudWatch registro, cree un `logback-cloudwatch.xml` archivo en la carpeta de configuración mediante la plantilla de configuración que se proporciona en la siguiente sección. A continuación, haga referencia a este archivo en el `application-main.yml` archivo quitando el comentario de las siguientes líneas:

```
# logging:
#  config: classpath:logback-cloudwatch.xml
```

 Tras eliminar los comentarios de estas líneas, se activará el CloudWatch registro y se podrá configurar con más detalle, tal y como se explica en las siguientes secciones.

## Configuración del registro CloudWatch
<a name="config-cw-log"></a>

Utilice la siguiente plantilla para crear el `logback-cloudwatch.xml` archivo:

```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration>
<configuration>

    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%date{yyyy-MM-dd HH:mm:ss.SSS,UTC}  %level --- [%thread{15}] %logger{40} : %msg%n%xThrowable</pattern>
        </encoder>
    </appender>

    <appender name="cloudwatch" class="com.netfective.bluage.runtime.cloudwatchlogger.CloudWatchAppender">
        <logGroup>BluAgeRuntimeOnEC2-Logs</logGroup>
        <logStream>%date{yyyy-MM-dd,UTC}.%instanceId.%uuid</logStream>
        <layout>
            <pattern>%date{yyyy-MM-dd HH:mm:ss.SSS,UTC}  %level --- [%thread{15}] %logger{40} : %msg%n%xThrowable</pattern>
        </layout>
        <appender-ref ref="console" />
    </appender>

    <root level="INFO">
        <appender-ref ref="cloudwatch" />
    </root>
</configuration>
```

Todo lo que está fuera del elemento <appender name="cloudwatch"/> es la configuración estándar de logback. Hay dos anexos en este archivo: un anexador de consola para enviar los registros a la consola y un CloudWatch anexador al que enviar los registros. CloudWatch

El atributo de `level` del elemento `root` especifica el nivel de registro de toda la aplicación.

Los valores obligatorios dentro de la etiqueta <appender name="cloudwatch"/> son: 
+ <logGroup/>:Establece el nombre del grupo de registros en CloudWatch. Si no se especifica ningún valor, el predeterminado es `BluAgeRuntimeOnEC2-Logs`. Si el grupo de registro no existe, se creará automáticamente. Este comportamiento se puede cambiar mediante la configuración, que se describe a continuación.
+ <logStream/>: Establece el nombre del LogStream (dentro del grupo de registros) en. CloudWatch

Valores opcionales: 
+ <region/>: sobrescribe la región en la que se escribirá el flujo de registro. De forma predeterminada, los registros van a la misma región que la EC2 instancia.
+ <layout/>: el patrón que utilizarán los mensajes de registro. 
+ <maxbatchsize/>: el número máximo de mensajes de registro a los que se debe enviar CloudWatch por operación.
+ <maxbatchtimemillis/>: el tiempo en milisegundos que se permite escribir CloudWatch los registros.
+ <maxqueuewaittimemillis/>: el tiempo en milisegundos que se tarda en intentar insertar las solicitudes en la cola de registros interna.
+ <internalqueuesize/>: el tamaño máximo de la cola interna.
+ <createlogdests/>: crea un grupo y un flujo de registro si no existen.
+ <initialwaittimemillis/>: la cantidad de tiempo que el subproceso debe permanecer en reposo al startup. Esta espera inicial permite una acumulación inicial de registros.
+ <maxeventmessagesize/>: el tamaño máximo de un evento de registro. Los registros que superen este tamaño no se enviarán.
+ <truncateeventmessages/>: trunca los mensajes que son demasiado largos.
+ <printrejectedevents/>: habilita el appender de emergencia.

## CloudWatch configuración
<a name="cw-setup"></a>

Para que la configuración anterior envíe los registros correctamente CloudWatch, actualice el rol de perfil de su instancia de Amazon EC2 IAM para concederle permisos adicionales para el grupo de registros `BluAgeRuntimeOnEC2-Logs` y sus flujos de registros: 
+ `logs:CreateLogStream`
+ `logs:DescribeLogStreams`
+ `logs:CreateLogGroup`
+ `logs:PutLogEvents`
+ `logs:DescribeLogGroups`

## Configuración de alarmas
<a name="alarm-setup"></a>

Gracias a CloudWatch los registros, puede configurar diferentes métricas y alarmas, en función de su aplicación y sus necesidades. En concreto, puede configurar alarmas proactivas para las alertas de uso, a fin de recibir alertas en caso de que se produzcan errores que puedan poner a su aplicación en un período de gracia (y, en última instancia, impedir que funcione). Para ello, puede añadir en los registros una métrica relativa a la cadena «Error C5001", que muestre los errores en la conexión con el sistema de control AWS Blu Age. A continuación, puede definir una alarma que reaccione a esta métrica. 

# Configura dependencias con licencia en AWS Blu Age Runtime en Amazon EC2
<a name="ba-runtime-dependencies-ec2"></a>

Esta guía describe cómo configurar dependencias con licencia adicionales que puedes usar con AWS Blu Age Runtime en Amazon EC2.

**Topics**
+ [Requisitos previos](#ba-runtime-dependencies-prereq)
+ [Pasos de instalación](#ba-runtime-dependencies-overview)

## Requisitos previos
<a name="ba-runtime-dependencies-prereq"></a>

Antes de comenzar, asegúrese de que cumple los requisitos previos que se indican a continuación:
+ Complete [AWS Requisitos previos de Blu Age Runtime](ba-runtime-setup-prereq.md) y [Incorporación de AWS Blu Age Runtime](ba-runtime-setup-onboard.md).
+ Asegúrese de tener una EC2 instancia de Amazon con AWS Blu Age Runtime (en Amazon EC2) instalado. Para [obtener más información, consulte Introducción a las instancias de Amazon EC2 Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html).
+ Asegúrese de poder conectarse a la EC2 instancia de Amazon correctamente, por ejemplo, mediante SSM.
+ Obtenga las siguientes dependencias de sus orígenes.

### Base de datos de Oracle
<a name="ba-runtime-dependencies-prereq-oracle"></a>

Proporcione un [controlador de base de datos de Oracle](https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html). Probamos la funcionalidad de AWS Blu Age Runtime (en Amazon EC2) con la versión **ojdbc11-23.3.0.23.09.jar**, pero podría ser compatible con una versión más reciente.

### Conexión MQ de IBM
<a name="ba-runtime-dependencies-prereq-mq"></a>

Suministre un [cliente MQ de IBM](https://www.ibm.com/support/pages/mqc91-ibm-mq-clients). Probamos la funcionalidad de AWS Blu Age Runtime (en Amazon EC2) con la versión **com.ibm.mq.jakarta.client-9.3.4.1.jar**, pero podría ser compatible con una versión más reciente.

Con esta versión de dependencias, suministre también las siguientes dependencias transitivas:
+ bcprov-jdk15to18-1.76.jar
+ bcpkix-jdk15to18-1.76.jar
+ bcutil-jdk15to18-1.76.jar

### Archivos de impresora DDS
<a name="ba-runtime-dependencies-prereq-dds"></a>

Proporcione la biblioteca de informes de Jasper https://com (munity.jaspersoft). com/download-jaspersoft/community-edición). Probamos la funcionalidad de AWS Blu Age Runtime (en Amazon EC2) con **jasperreports-6.16.0.jar**, pero es posible que una versión más reciente sea compatible.

Con esta versión de dependencias, suministre también las siguientes dependencias transitivas:
+ castor-core-1.4.1. jar
+ castor-core-1.4.1. jar
+ commons-digester-2.1.jar
+ ecj-3.21.0.jar
+ itext-2.1.7. js8.jar
+ javax.inject-1.jar
+ jcommon-1.0.23.jar
+ jfreechart-1.0.19.jar
+ commons-beanutils-1.9.4.jar
+ commons-collections-3.2.2.jar

## Pasos de instalación
<a name="ba-runtime-dependencies-overview"></a>

Para instalar las dependencias, complete los pasos siguientes.

1. Conéctate a tu EC2 instancia de Amazon y cambia el usuario a **su** ejecutando el siguiente comando.

   ```
   sudo su
   ```

   En este tutorial, necesitará el privilegio de superusuario para ejecutar los comandos.

1. Vaya a la carpeta `<your-tomcat-path>/extra/`.

   ```
   cd <your-tomcat-path>/extra/
   ```

1. Copie cualquiera de las dependencias anteriores según sea necesario en esta carpeta.
**nota**  
En el caso de las aplicaciones web JAC y BAC con bases de datos alojadas en Oracle, asegúrese de incluir el controlador de base de datos de Oracle (ojdbc) en esta carpeta.

1. Pare e inicie el tomcat.service ejecutando los siguientes comandos.

   ```
   systemctl stop tomcat.service
   ```

   ```
   systemctl start tomcat.service
   ```

1. Compruebe el estado del servicio para asegurarse de que se está ejecutando.

   ```
   systemctl status tomcat.service
   ```

1. Verifique los registros.

# Implemente AWS Blu Age Runtime en contenedores de Amazon ECS y Amazon EKS
<a name="ba-deploy-container"></a>

Puede utilizar los temas de esta sección para aprender a configurar AWS Blu Age Runtime en contenedores para implementarlo en Amazon ECS (gestionado por Amazon EC2 o AWS Fargate) y Amazon EKS gestionado por Amazon EC2, cómo actualizar la versión en tiempo de ejecución, cómo supervisar el despliegue mediante CloudWatch las alarmas de Amazon y cómo añadir dependencias con licencia.

**nota**  
Esto no es compatible con Amazon EKS gestionado por AWS Fargate.

**Topics**
+ [Configurar AWS Blu Age Runtime en un contenedor](ba-runtime-deploy-container.md)
+ [Actualice el tiempo de ejecución de AWS Blu Age en un contenedor](ba-runtime-maint-container.md)
+ [Configura CloudWatch las alarmas de Amazon para AWS Blu Age Runtime en un contenedor](ba-cw-alarms-container.md)
+ [Configure las dependencias con licencia en AWS Blu Age Runtime en un contenedor](ba-runtime-dependencies-container.md)

# Configurar AWS Blu Age Runtime en un contenedor
<a name="ba-runtime-deploy-container"></a>

En este tema se explica cómo configurar e implementar la aplicación de PlanetsDemo ejemplo mediante AWS Blu Age Runtime en un contenedor docker.

AWS Blu Age Runtime en contenedor está disponible para Amazon ECS gestionado por Amazon EC2, Amazon ECS gestionado por AWS Fargate Amazon y Amazon EKS gestionado por Amazon EC2. No es compatible con Amazon EKS gestionado por AWS Fargate.

**Topics**
+ [Requisitos previos](#ba-runtime-deploy-prereq)
+ [Configuración](#ba-runtime-deploy-setup)
+ [Prueba de la aplicación implementada](#ba-runtime-deploy-test)

## Requisitos previos
<a name="ba-runtime-deploy-prereq"></a>

Antes de comenzar, asegúrese de que cumple los requisitos previos que se indican a continuación:
+ Configure el AWS CLI archivo siguiendo los pasos de [Configuración de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html).
+ Complete [AWS Requisitos previos de Blu Age Runtime](ba-runtime-setup-prereq.md) y [Incorporación de AWS Blu Age Runtime](ba-runtime-setup-onboard.md).
+ Descargue los binarios de AWS Blu Age Runtime. Para obtener instrucciones, consulte [Incorporación de AWS Blu Age Runtime](ba-runtime-setup-onboard.md).
+ Descargue los binarios de Apache Tomcat 10.
+ Descarga el [archivo de PlanetsDemo la aplicación](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip).
+ Cree una base de datos de PostgreSQL de Amazon Aurora para JICS y ejecute la consulta `PlanetsDemo-v1/jics/sql/initJics.sql` en ella. Para obtener información sobre cómo crear una base de datos de PostgreSQL de Amazon Aurora, consulte [Creación de un clúster de base de datos de Aurora PostgreSQL y conexión a él](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster).

## Configuración
<a name="ba-runtime-deploy-setup"></a>

Para configurar la aplicación PlanetsDemo de muestra, complete los siguientes pasos.

1. Tras descargar los binarios de Apache Tomcat, extraiga el contenido y vaya a la carpeta `conf`. Abra el archivo `catalina.properties` para editarlo y sustituya la línea que empieza por `common.loader` por la siguiente línea.

   ```
   common.loader="${catalina.base}/lib","${catalina.base}/lib/*.jar","${catalina.home}/lib","${catalina.home}/lib/*.jar","${catalina.home}/shared","${catalina.home}/shared/*.jar","${catalina.home}/extra","${catalina.home}/extra/*.jar"
   ```

1. Comprima la carpeta de Apache Tomcat mediante el comando tar para crear un archivo tar.gz.

1. Prepare un [Dockerfile](https://docs.docker.com/engine/reference/builder/) para crear su imagen personalizada a partir de los binarios de tiempo de ejecución proporcionados y los binarios del servidor de Apache Tomcat. Consulte el siguiente Dockerfile de ejemplo. El objetivo es instalar Apache Tomcat 10, seguido de AWS Blu Age Runtime (para Amazon ECS gestionado por AWS Fargate) extraído de la raíz del directorio de instalación de Apache Tomcat 10 y, a continuación, instalar la aplicación modernizada de muestra denominada. PlanetsDemo
**nota**  
El contenido de los scripts install-gapwalk.sh e install-app.sh, que se utilizan en este Dockerfile de ejemplo, aparece después del Dockerfile.

   ```
   FROM --platform=linux/x86_64 amazonlinux:2
   
   RUN mkdir -p /workdir/apps
   WORKDIR /workdir
   COPY install-gapwalk.sh .
   COPY install-app.sh .
   RUN chmod +x install-gapwalk.sh
   RUN chmod +x install-app.sh
   
   # Install Java and AWS CLI v2-y
   RUN yum install sudo java-17-amazon-corretto unzip tar -y
   RUN sudo yum remove awscli -y
   RUN curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
   RUN sudo unzip awscliv2.zip
   RUN sudo ./aws/install
   
   # Installation dir
   RUN mkdir -p /usr/local/velocity/installation/gapwalk
   # Copy PlanetsDemo archive to a dedicated apps dir
   COPY PlanetsDemo-v1.zip /workdir/apps/
   
   # Copy resources (tomcat, blu age runtime) to installation dir
   COPY tomcat.tar.gz /usr/local/velocity/installation/tomcat.tar.gz
   COPY aws-bluage-runtime-4.x.x.zip /usr/local/velocity/installation/gapwalk/gapwalk.zip
   
   # run relevant installation scripts
   RUN ./install-gapwalk.sh
   RUN ./install-app.sh
   
   EXPOSE 8080
   EXPOSE 8081
   # ...
   
   WORKDIR /bluage/tomcat.gapwalk/velocity
   # Run Command to start Tomcat server
   CMD ["sh", "-c", "sudo bin/catalina.sh run"]
   ```

   A continuación se muestra el contenido de `install-gapwalk.sh.`

   ```
   # Vars
   TEMP_DIR=/bluage-on-fargate/tomcat.gapwalk/temp
   
   # Install
   echo "Installing Gapwalk and Tomcat"
   sudo rm -rf /bluage-on-fargate
   mkdir -p ${TEMP_DIR}
   # Copy Blu Age runtime and tomcat archives to temporary extraction dir
   sudo cp /usr/local/velocity/installation/gapwalk/gapwalk.zip ${TEMP_DIR}
   sudo cp /usr/local/velocity/installation/tomcat.tar.gz ${TEMP_DIR}
   # Create velocity dir
   mkdir -p /bluage/tomcat.gapwalk/velocity
   # Extract tomcat files
   tar -xvf ${TEMP_DIR}/tomcat.tar.gz -C ${TEMP_DIR}
   # Copy all tomcat files to velocity dir
   cp -fr ${TEMP_DIR}/apache-tomcat-10.x.x/* /bluage/tomcat.gapwalk/velocity
   # Remove default webapps of Tomcat
   rm -f /bluage-on-fargate/tomcat.gapwalk/velocity/webapps/*
   # Extract Blu Age runtime at velocity dir
   unzip ${TEMP_DIR}/gapwalk.zip -d /bluage/tomcat.gapwalk
   # Remove temporary extraction dir
   sudo rm -rf ${TEMP_DIR}
   ```

   A continuación se muestra el contenido de `install-app.sh`.

   ```
   #!/bin/sh
   
   APP_DIR=/workdir/apps
   TOMCAT_GAPWALK_DIR=/bluage-on-fargate/tomcat.gapwalk
   
   unzip ${APP_DIR}/PlanetsDemo-v1.zip -d ${APP_DIR}
   cp -r ${APP_DIR}/webapps/* ${TOMCAT_GAPWALK_DIR}/velocity/webapps/
   cp -r ${APP_DIR}/config/* ${TOMCAT_GAPWALK_DIR}/velocity/config/
   ```

1. Proporcione la información de conexión para la base de datos que creó como parte de los requisitos previos en el siguiente fragmento de código del archivo `application-main.yml`, que se encuentra en la carpeta `{TOMCAT_GAPWALK_DIR}/config`. Para obtener más información, consulte [Creación de un clúster de base de datos de Aurora PostgreSQL y conexión a él](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster).

   ```
   datasource:
      jicsDs:
        driver-class-name :  
        url: 
        username: 
        password: 
        type :
   ```

1. Compile y envíe la imagen a su repositorio de Amazon ECR. Para ver más instrucciones, consulte [Inserción de una imagen de Docker](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html) en la Guía del usuario de Amazon Elastic Container Registry. A continuación, según su situación, cree un pod de Amazon EKS o una definición de tarea de Amazon ECS con su imagen de Amazon ECR e impleméntela en su clúster. Para ver ejemplos de cómo crearlos, consulte [Creación de una definición de tareas con la consola](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-task-definition.html) en la *Guía para desarrolladores de Amazon Elastic Container Service (Amazon ECS)* e [Implementación de una aplicación de ejemplo](https://docs.aws.amazon.com/eks/latest/userguide/sample-deployment.html) en la *Guía del usuario de Amazon EKS*.

1.  En concreto, en el caso de **Amazon ECS administrado por AWS Fargate**, al crear la definición de tarea, utilice el rol de IAM que creó como parte de la configuración de la infraestructura inicial. A continuación, al crear el servicio, expanda la sección **Redes** y configure la VPC, las subredes y el grupo de seguridad que creó como parte de la configuración de la infraestructura inicial. Consulte [Requisitos de configuración de infraestructura para AWS Blu Age Runtime](https://docs.aws.amazon.com/m2/latest/userguide/ba-infrastructure-setup.html).

## Prueba de la aplicación implementada
<a name="ba-runtime-deploy-test"></a>

Para ver un ejemplo de cómo probar la PlanetsDemo aplicación, consulte[Probar la PlanetsDemo aplicación](ba-runtime-test-planetsdemo.md).

# Actualice el tiempo de ejecución de AWS Blu Age en un contenedor
<a name="ba-runtime-maint-container"></a>

Esta guía describe cómo actualizar el tiempo de ejecución de AWS Blu Age en un contenedor. Para ello, primero debe completar algunos requisitos previos y, a continuación, trabajar con la imagen de Docker para actualizar el tiempo de ejecución de AWS Blu Age.

**Topics**
+ [Requisitos previos](#ba-runtime-maint-prereq)
+ [Actualiza el tiempo de ejecución de AWS Blu Age](#ba-runtime-maint-copy-files)

## Requisitos previos
<a name="ba-runtime-maint-prereq"></a>

Antes de comenzar, asegúrese de que cumple los siguientes requisitos previos:
+ Complete [AWS Requisitos previos de Blu Age Runtime](ba-runtime-setup-prereq.md) y [Incorporación de AWS Blu Age Runtime](ba-runtime-setup-onboard.md).
+ Descarga la versión de AWS Blu Age Runtime a la que deseas actualizar. Para obtener más información, consulte [Incorporación de AWS Blu Age Runtime](ba-runtime-setup-onboard.md). El marco consta de dos archivos binarios: `aws-bluage-runtime-x.y.z.zip` y `aws-bluage-webapps-x.y.z.zip`.

## Actualiza el tiempo de ejecución de AWS Blu Age
<a name="ba-runtime-maint-copy-files"></a>

Complete los siguientes pasos para actualizar el tiempo de ejecución de AWS Blu Age.

1. Reconstruye tu imagen de Docker con la versión de AWS Blu Age Runtime que desees. Para obtener instrucciones, consulte [Configurar AWS Blu Age Runtime en un contenedor](ba-runtime-deploy-container.md).

1. Envíe la imagen de Docker a su repositorio de Amazon ECR.

1. Detenga y reinicie el servicio de Amazon ECS o Amazon EKS.

1. Verifique los registros.

El tiempo de ejecución de AWS Blu Age se actualizó correctamente.

# Configura CloudWatch las alarmas de Amazon para AWS Blu Age Runtime en un contenedor
<a name="ba-cw-alarms-container"></a>

Puede configurarlo CloudWatch para que las notificaciones sean más visibles cada vez que las aplicaciones implementadas encuentren excepciones. Esto le ayuda a supervisar el registro de aplicaciones al CloudWatch que se redirige y a añadir una alarma para advertirle de posibles errores.

## Configuración de alarmas
<a name="alarm-setup"></a>

Con CloudWatch los registros, puede configurar cualquier cantidad de métricas y alarmas, en función de la aplicación y de sus necesidades.

En concreto, puede configurar alarmas proactivas para alertas de uso directamente durante la creación del clúster, de modo que reciba notificaciones cuando se produzcan errores. Para resaltar los errores en la conexión al sistema de control AWS Blu Age, añada una métrica relativa a la cadena «Error C» en los registros. A continuación, puede definir una alarma que reaccione a esta métrica. 

# Configure las dependencias con licencia en AWS Blu Age Runtime en un contenedor
<a name="ba-runtime-dependencies-container"></a>

Esta guía describe cómo configurar dependencias con licencia adicionales que puede usar con el tiempo de ejecución de AWS Blu Age en contenedor.

**Topics**
+ [Requisitos previos](#ba-runtime-dependencies-prereq)
+ [Descripción general](#ba-runtime-dependencies-overview)

## Requisitos previos
<a name="ba-runtime-dependencies-prereq"></a>

Antes de comenzar, asegúrese de que cumple los requisitos previos que se indican a continuación:
+ Complete [AWS Requisitos previos de Blu Age Runtime](ba-runtime-setup-prereq.md) y [Incorporación de AWS Blu Age Runtime](ba-runtime-setup-onboard.md).
+ Obtenga las siguientes dependencias de su origen.

### Base de datos de Oracle
<a name="ba-runtime-dependencies-prereq-oracle"></a>

Proporcione un [controlador de base de datos de Oracle]( https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html). Por ejemplo, **ojdbc11-23.3.0.23.09.jar**.

### Conexión MQ de IBM
<a name="ba-runtime-dependencies-prereq-mq"></a>

Suministre un [cliente MQ de IBM](https://www.ibm.com/support/pages/mqc91-ibm-mq-clients). Por ejemplo, **com.ibm.mq.jakarta.client-9.3.4.1.jar.**

Con esta versión de dependencias, suministre también las siguientes dependencias transitivas:
+ bcprov-jdk15to18-1.76.jar
+ bcpkix-jdk15to18-1.76.jar
+ bcutil-jdk15to18-1.76.jar

### Archivos de impresora DDS
<a name="ba-runtime-dependencies-prereq-dds"></a>

Proporcione la biblioteca de informes de Jasper (munity.jaspersoft)https://com. com/download-jaspersoft/community-edición). Por ejemplo, **jasperreports-6.16.0.jar**, pero una versión más reciente podría ser compatible.

Con esta versión de dependencias, suministre también las siguientes dependencias transitivas:
+ castor-core-1.4.1. jar
+ castor-core-1.4.1. jar
+ commons-digester-2.1.jar
+ ecj-3.21.0.jar
+ itext-2.1.7. js8.jar
+ javax.inject-1.jar
+ jcommon-1.0.23.jar
+ jfreechart-1.0.19.jar
+ commons-beanutils-1.9.4.jar
+ commons-collections-3.2.2.jar

## Descripción general
<a name="ba-runtime-dependencies-overview"></a>

Para instalar las dependencias, complete los pasos siguientes.

1. Copie cualquiera de las dependencias anteriores según sea necesario en la carpeta de compilación de imágenes de Docker.

1. Si su base de datos JICS está alojada en Oracle, proporcione el controlador de la base de datos Oracle. `your-tomcat-path/extra`

1. En su Dockerfile, copie estas dependencias en `your-tomcat-path/extra`.

1. Cree su imagen de Docker y, a continuación, envíela a Amazon ECR.

1. Detenga y reinicie el servicio de Amazon ECS o Amazon EKS.

1. Consulte los registros.

# Probar la PlanetsDemo aplicación
<a name="ba-runtime-test-planetsdemo"></a>

Para comprobar el estado de la PlanetsDemo aplicación desplegada, ejecute los siguientes comandos después de `load-balancer-DNS-name` reemplazarla y `web-binary-name` con los valores correctos para la configuración. `listener-port`

```
curl http://load-balancer-DNS-name:listener-port/gapwalk-application/
```

Si la aplicación está ejecutándose, verá el siguiente mensaje de salida: `Jics application is running`.

A continuación, ejecute los comandos siguientes:

```
curl http://load-balancer-DNS-name:listener-port/jac/api/services/rest/jicsservice/
```

Si la aplicación está ejecutándose, verá el siguiente mensaje de salida: `Jics application is running`.

```
Jics application is running
```

Si lo ha configuradoBlusam, puede esperar una respuesta vacía cuando ejecute el siguiente comando.

```
curl http://load-balancer-DNS-name:listener-port/bac/api/services/rest/bluesamserver/serverIsUp
```

Anote el nombre del binario web (PlanetsDemo-web-1.0.0, si no ha cambiado). Para acceder a la PlanetsDemo aplicación, utilice una URL con el siguiente formato.

```
https://load-balancer-DNS-name:listener-port/web-binary-name
```

Cuando se inicie la PlanetsDemo aplicación, aparecerá la página de inicio.

![\[Página de inicio\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/PlanetsDemo-homepage.png)


En el cuadro de texto, escriba PINQ y, a continuación, pulse Intro. Aparece la página de consulta de datos.

![\[Página de consulta de datos\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/PlanetsDemo-app.png)


Por ejemplo, escriba EARTH en el campo PlanetsDemo del nombre y, a continuación, presione Entrar. Aparece la página del planeta que haya introducido.

![\[Página EARTH\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/PlanetsDemo-EARTH.png)
