Imposta la configurazione per AWS Blu Age Runtime

AWS Blu Age Runtime e il codice client sono applicazioni Web che utilizzano il framework Spring Boot. Sfrutta le funzionalità di Spring per fornire la configurazione, con diverse posizioni possibili e regole di precedenza. Esistono anche regole di precedenza simili per fornire molti altri file, come groovy scripts, sql, ecc.

AWS Blu Age Runtime contiene anche applicazioni web opzionali aggiuntive, che possono essere attivate se necessario.

Argomenti

• Nozioni di base sulla configurazione delle applicazioni

• Precedenza delle applicazioni

• JNDI per database

• AWS I segreti di Blu Age Runtime

• Altri file (groovy, sql, ecc.)

• Applicazione web aggiuntiva

• Abilita le proprietà per AWS Blu Age Runtime

• Proprietà della cache Redis disponibili in AWS Blu Age Runtime

• Configurare la sicurezza per le applicazioni Gapwalk

Nozioni di base sulla configurazione delle applicazioni

Il modo predefinito per gestire la configurazione delle applicazioni consiste nell'uso di file YAML dedicati da fornire nella cartella del server delle applicazioni. config Esistono due file di configurazione YAML principali:

• application-main.yaml

• application-profile.yaml(dove profile il valore è impostato durante la generazione dell'applicazione).

Il primo file configura il framework, ad esempioGapwalk-application.war, mentre il secondo riguarda opzioni aggiuntive specifiche per l'applicazione client. Funziona con l'uso di profili Spring: l'applicazione Gapwalk utilizza il main profilo, mentre l'applicazione client utilizza il profilo. profile

L'esempio seguente mostra un tipico file YAML principale.

L'esempio seguente mostra un tipico file YAML del client.

Per informazioni sul contenuto dei file YAML, vedere. Abilita le proprietà per AWS Blu Age Runtime

Precedenza delle applicazioni

Per questi file di configurazione, si applicano le regole di precedenza Spring. In particolare:

• Il file application-main YAML appare nel file di guerra principale di Gapwalk con i valori predefiniti e quello nella cartella lo sostituisce. config

• Lo stesso dovrebbe essere fatto per la configurazione dell'applicazione client

• È possibile passare parametri aggiuntivi sulla riga di comando al momento dell'avvio del server. Avrebbero la precedenza su quelli YAML.

Per ulteriori informazioni, consulta la documentazione ufficiale di Spring Boot.

JNDI per database

La configurazione del database potrebbe essere fornita con JNDI nel file context.xml in Tomcat. Qualsiasi configurazione di questo tipo avrebbe la precedenza su quella YAML. Ma fai attenzione che l'utilizzo di questa opzione non ti consentirà di racchiudere le tue credenziali in un gestore segreto (vedi sotto).

L'esempio seguente mostra configurazioni di esempio per JICS e database. 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

Sarebbe jdbc/jics per il database JICS e jdbc/bluesam (presta attenzione alla «e») per il database blusam.

url="jdbc:postgresql: //xxxx.rds.amazonaws.com:5432/XXXX» username="XXXX» password="XXXX»

L'URL, il nome utente e la password del database.

Altri file (groovy, sql, ecc.)

Gli altri file utilizzati dal progetto del cliente utilizzano regole di precedenza simili a quelle per la configurazione primaverile. Esempi:

• Gli script Groovy sono .groovy file nella cartella o nelle sottocartelle. scripts

• Gli script SQL sono .sql file contenuti nella cartella o nelle sottocartelle. sql

• Gli script daemon sono .groovy file contenuti nella cartella o nelle sottocartelle. daemons

• Queries Database mapping file sono file queries-database.mapping denominati file nelle sottocartelle delle cartelle. sql

• I modelli Jasper sono .jrxml file contenuti nella cartella o nelle sottocartelletemplates.

• I cataloghi dei set di dati sono .json file contenuti nella cartella. catalog

• I file Lnk sono .json file contenuti nella cartella. lnk

Tutte queste posizioni possono essere sovrascritte tramite una proprietà di sistema o una proprietà YAML del client.

• Per gli script Groovy: configuration.scripts

• Per gli script SQL: configuration.sql

• Per gli script Daemon: configuration.daemons

• Per il file di mappatura del database Queries: configuration.databaseMapping

• Per i modelli Jasper: configuration.templates

• Per i cataloghi Dataset: configuration.catalog

• Per i file Lnk: configuration.lnk

Se la proprietà non viene trovata, i file verranno prelevati dalla posizione predefinita sopra menzionata. La ricerca verrà eseguita prima con la directory di lavoro di tomcat come root e infine nel file war dell'applicazione.

Applicazione web aggiuntiva

AWS Blu Age Runtime contiene applicazioni web aggiuntive nella sua webapps-extra cartella. Queste applicazioni non sono servite di default dal server tomcat.

L'attivazione di queste applicazioni Web dipende dal progetto di modernizzazione e viene effettuata spostando il file war desiderato dalla webapps-extra cartella alla cartella. webapps Dopodiché, la guerra verrà gestita dal server tomcat al prossimo avvio.

Alcune configurazioni aggiuntive specifiche del progetto possono anche essere aggiunte in un file di configurazione YAML per ogni guerra aggiuntiva, come viene fatto nel file e spiegato sopra. application-main.yml Le guerre aggiuntive sono:

• gapwalk-utility-pgm.war: contiene il supporto per i programmi di utilità ZOS e li utilizza application-utility-pgm.yaml come configurazione.

• gapwalk-cl-command.war: contiene il supporto per i programmi di utilità AS/400 e li utilizza application-cl-command.yaml come configurazione.

• gapwalk-hierarchical-support.war: contiene il supporto per le transazioni IMS/MFS e lo utilizza come configurazione application-jhdb.yaml