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 la configuración de AWS Blu Age Runtime
<a name="ba-runtime-config"></a>

El tiempo de ejecución de AWS Blu Age y el código del cliente son aplicaciones web que utilizan el [marco Spring Boot](https://docs.spring.io/spring-boot/docs/2.5.14/reference/html/). Aproveche las capacidades de Spring para proporcionar la configuración, con varias ubicaciones posibles y reglas de prioridad. También existen reglas de prioridad similares para el suministro de muchos otros archivos, como scripts groovy, sql, etc.

El AWS Blu Age Runtime también contiene aplicaciones web opcionales adicionales, que se pueden activar si es necesario.

**Topics**
+ [Principios básicos de la configuración de aplicaciones](#ba-runtime-config-app-basics)
+ [Prioridad de la aplicación](#ba-runtime-config-app-precedence)
+ [JNDI para bases de datos](#ba-runtime-config-app-jndi)
+ [AWS Secretos de Blu Age Runtime](ba-runtime-config-app-secrets.md)
+ [Otros archivos (groovy, sql, etc.)](#ba-runtime-config-app-files)
+ [Aplicación web adicional](#ba-runtime-config-app-webapp)
+ [Habilitar propiedades para AWS Blu Age Runtime](ba-runtime-key-value.md)
+ [Propiedades de caché de Redis disponibles en AWS Blu Age Runtime](ba-runtime-redis-configuration.md)
+ [Configuración de la seguridad para las aplicaciones de Gapwalk](ba-runtime-security.md)

## Principios básicos de la configuración de aplicaciones
<a name="ba-runtime-config-app-basics"></a>

La forma predeterminada de gestionar la configuración de la aplicación es mediante el uso de archivos YAML dedicados que se proporcionan en la carpeta `config` del servidor de aplicaciones. Hay dos archivos de configuración YAML principales:
+ `application-main.yaml`
+ `application-profile.yaml` (donde el valor `profile` se configura durante la generación de la aplicación).

El primer archivo configura el marco, es decir `Gapwalk-application.war`, mientras que el segundo es para opciones adicionales específicas para la aplicación cliente. Esto funciona con el uso de perfiles de Spring: la aplicación de Gapwalk usa el perfil `main`, mientras que la aplicación cliente usa el perfil `profile`.

A continuación se muestra un ejemplo de archivo YAML principal típico.

![\[Extracto de un archivo YAML principal.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/main-yaml.png)


A continuación se muestra un ejemplo de archivo YAML de cliente típico.

![\[Ejemplo de YAML de cliente\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/client-yaml.png)


Para obtener más información sobre el contenido de los archivos YAML, consulte [Habilitar propiedades para AWS Blu Age Runtime](ba-runtime-key-value.md).

## Prioridad de la aplicación
<a name="ba-runtime-config-app-precedence"></a>

Para estos archivos de configuración, se aplican las reglas de prioridad de Spring. En particular:
+ El archivo YAML `application-main` aparece en el archivo war principal de Gapwalk con los valores predeterminados y el archivo de la carpeta `config` lo sustituye.
+ Lo mismo debería hacerse con la configuración de la aplicación cliente
+ Es posible que se transfieran parámetros adicionales a través de la línea de comandos en el momento del lanzamiento del servidor. Anularían los de YAML.

Para obtener más información, consulte la [documentación oficial de Spring Boot](https://docs.spring.io/spring-boot/docs/2.5.14/reference/html/features.html#features.external-config).

## JNDI para bases de datos
<a name="ba-runtime-config-app-jndi"></a>

La configuración de la base de datos puede proporcionarse con JNDI en el archivo context.xml de Tomcat. Cualquier configuración de este tipo anularía la de YAML. Pero tenga en cuenta que, si usa eso, no podrá guardar sus credenciales en un administrador secreto (consultar a continuación).

El siguiente ejemplo muestra ejemplos de configuraciones para JICS y bases de datos. Blusam

```
<Resource auth="Container" driverClassName="org.postgresql.Driver" initialSize="0" maxIdle="5" 
   maxOpenPreparedStatements="-1" maxTotal="10" maxWaitMillis="-1" name="jdbc/jics"
   poolPreparedStatements="true" testOnBorrow="false" type="javax.sql.DataSource" 		
   url="jdbc:postgresql://XXXX.rds.amazonaws.com:5432/XXXX" username="XXXX" password="XXXX" />
```

jdbc/jics  
Sería `jdbc/jics` para la base de datos JICS y `jdbc/bluesam` (preste atención a la «e») para la Blusam base de datos.

url="jdbc:postgresql://XXXX.rds.amazonaws.com:5432/XXXX" username="XXXX" password="XXXX"  
URL, nombre de usuario y contraseña de la base de datos.

## Otros archivos (groovy, sql, etc.)
<a name="ba-runtime-config-app-files"></a>

Los demás archivos utilizados por el proyecto del cliente utilizan reglas de prioridad similares a las de la configuración de Spring. Ejemplos:
+ Los scripts groovy son los archivos `.groovy` de la carpeta o las subcarpetas `scripts`. 
+ Los scripts SQL son los archivos `.sql` de la carpeta o las subcarpetas `sql`.
+ Los scripts daemon son los archivos `.groovy` de la carpeta o las subcarpetas `daemons`. 
+ Los archivos de asignación de base de datos de consultas se llaman `queries-database.mapping` y se encuentran en las subcarpetas de la carpeta `sql`.
+ Las plantillas de Jasper son los archivos `.jrxml` de la carpeta o las subcarpetas `templates`. 
+ Los catálogos de conjuntos de datos son los archivos `.json` de la carpeta `catalog`.
+ Los archivos Lnk son los archivos `.json` de la carpeta `lnk`.

Todas estas ubicaciones se pueden sobrescribir mediante una propiedad del sistema o una propiedad YAML de cliente.
+ Para los scripts de Groovy: `configuration.scripts`
+ Para los scripts de SQL: `configuration.sql`
+ Para los scripts de Daemon: `configuration.daemons`
+ Para el archivo de asignación de bases de datos de consultas: `configuration.databaseMapping`
+ Para las plantillas de Jasper: `configuration.templates`
+ Para los catálogos de conjuntos de datos: `configuration.catalog`
+ Para los archivos Lnk: `configuration.lnk`

Si no se encuentra la propiedad, los archivos se tomarán de la ubicación predeterminada mencionada anteriormente. La búsqueda se realizará primero con la carpeta de trabajo de Tomcat como raíz y, por último, en el archivo war de la aplicación.

## Aplicación web adicional
<a name="ba-runtime-config-app-webapp"></a>

El AWS Blu Age Runtime contiene aplicaciones web adicionales en su `webapps-extra` carpeta. El servidor Tomcat no sirve estas aplicaciones de forma predeterminada.

La aceptación de estas aplicaciones web depende del proyecto de modernización y se realiza moviendo el archivo war deseado de la carpeta `webapps-extra` a la carpeta `webapps`. Después de eso, el servidor Tomcat servirá el archivo war la próxima vez que se inicie.

También se puede añadir alguna configuración adicional específica del proyecto en un archivo de configuración YAML para cada archivo war adicional, tal y como se ha hecho en el archivo `application-main.yml` y se ha explicado anteriormente. Los archivos war adicionales son:
+ `gapwalk-utility-pgm.war`: contiene soporte para los programas de utilidades de ZOS y utiliza `application-utility-pgm.yaml` como configuración.
+ `gapwalk-cl-command.war`: contiene soporte para los programas de utilidades de AS/400 y utiliza `application-cl-command.yaml` como configuración.
+ `gapwalk-hierarchical-support.war`: contiene soporte para IMS/MFS transacciones y `application-jhdb.yaml` lo usa como configuración