NOUVEAU - Vous pouvez désormais accélérer votre migration et votre modernisation avec AWS Transform. Lisez Getting Started dans le guide de l'utilisateur de AWS Transform.
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Configurer la configuration pour AWS Blu Age Runtime
Le AWS Blu Age Runtime et le code client sont des applications Web utilisant le framework Spring Boot
Le AWS Blu Age Runtime contient également des applications Web facultatives supplémentaires, qui peuvent être activées si nécessaire.
Principes de base de configuration des applications
La méthode par défaut pour gérer la configuration des applications consiste à utiliser des fichiers YAML dédiés à fournir dans le config dossier du serveur d'applications. Il existe deux principaux fichiers de configuration YAML :
-
application-main.yaml -
application-(oùprofile.yamlla valeur est configurée lors de la génération de l'application).profile
Le premier fichier configure le framework, c'est-à-direGapwalk-application.war, tandis que le second est destiné à des options supplémentaires spécifiques à l'application cliente. Cela fonctionne avec l'utilisation de profils Spring : l'application Gapwalk utilise le main profil, tandis que l'application cliente utilise le profil.profile
L'exemple suivant montre un fichier YAML principal typique.
L'exemple suivant montre un fichier YAML client typique.
Pour plus d'informations sur le contenu des fichiers YAML, consultezActiver les propriétés de AWS Blu Age Runtime.
Priorité des applications
Pour ces fichiers de configuration, les règles de priorité Spring s'appliquent. Notamment :
-
Le fichier
application-mainYAML apparaît dans le fichier war principal de Gapwalk avec les valeurs par défaut, et celui duconfigdossier le remplace. -
La même chose doit être faite pour la configuration de l'application cliente
-
Des paramètres supplémentaires peuvent être transmis sur la ligne de commande au moment du lancement du serveur. Ils remplaceraient ceux de YAML.
Pour plus d'informations, consultez la documentation officielle de Spring Boot
JNDI pour bases de données
La configuration de la base de données peut être fournie avec JNDI dans le fichier context.xml de Tomcat. Toute configuration de ce type remplacerait celle de YAML. Mais attention, son utilisation ne permettra pas d'encapsuler vos informations d'identification dans un gestionnaire secret (voir ci-dessous).
L'exemple suivant montre des exemples de configurations pour les JICS et les Blusam bases de données.
<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
-
Ce serait
jdbc/jicspour la base de données JICS etjdbc/bluesam(attention au « e ») pour la Blusam base de données. - url="jdbc:postgresql : //xxxx.rds.amazonaws.com:5432/XXXX » Nom d'utilisateur = « XXXX » Mot de passe = « XXXX »
-
URL, nom d'utilisateur et mot de passe de la base de données.
Autres fichiers (groovy, sql, etc.)
Les autres fichiers utilisés par le projet client utilisent des règles de priorité similaires à celles de la configuration Spring. Exemples :
-
Les scripts Groovy sont des
.groovyfichiers contenus dans lescriptsdossier ou les sous-dossiers. -
Les scripts SQL sont des
.sqlfichiers contenus dans lesqldossier ou les sous-dossiers. -
Les scripts Daemon sont des
.groovyfichiers contenus dans ledaemonsdossier ou les sous-dossiers. -
Les fichiers de mappage de base de données de requêtes sont
queries-database.mappingdes fichiers nommés fichiers dans les sous-dossiers dusqldossier. -
Les modèles Jasper sont des
.jrxmlfichiers contenus dans letemplatesdossier ou les sous-dossiers. -
Les catalogues de jeux de données sont
.jsondes fichiers contenus dans lecatalogdossier. -
Les fichiers Lnk sont
.jsondes fichiers dulnkdossier.
Tous ces emplacements peuvent être remplacés par le biais d'une propriété système ou d'une propriété YAML du client.
-
Pour les scripts Groovy :
configuration.scripts -
Pour les scripts SQL :
configuration.sql -
Pour les scripts Daemon :
configuration.daemons -
Pour le fichier de mappage de base de données de requêtes :
configuration.databaseMapping -
Pour les modèles Jasper :
configuration.templates -
Pour les catalogues de jeux de données :
configuration.catalog -
Pour les fichiers Lnk :
configuration.lnk
Si la propriété n'est pas trouvée, les fichiers seront extraits de l'emplacement par défaut mentionné ci-dessus. La recherche sera d'abord effectuée avec le répertoire de travail Tomcat en tant que racine, puis dans le fichier war de l'application.
Application Web supplémentaire
Le AWS Blu Age Runtime contient des applications Web supplémentaires dans son webapps-extra dossier. Ces applications ne sont pas desservies par défaut par le serveur Tomcat.
L'activation de ces applications Web dépend du projet de modernisation et s'effectue en déplaçant le fichier war souhaité du webapps-extra dossier vers le webapps dossier. Après cela, la guerre sera servie par le serveur Tomcat au prochain démarrage.
Certaines configurations supplémentaires spécifiques au projet peuvent également être ajoutées dans un fichier de configuration YAML pour chaque guerre supplémentaire, comme cela est fait dans le application-main.yml fichier et expliqué ci-dessus. Les guerres supplémentaires sont les suivantes :
-
gapwalk-utility-pgm.war: contient le support pour les programmes utilitaires ZOS et l'utiliseapplication-utility-pgm.yamlcomme configuration. -
gapwalk-cl-command.war: contient le support pour les programmes utilitaires AS/400 et l'utiliseapplication-cl-command.yamlcomme configuration. -
gapwalk-hierarchical-support.war: contient le support des IMS/MFS transactions etapplication-jhdb.yamll'utilise comme configuration