新規 - AWS Transform を使用して移行とモダナイゼーションを高速化できるようになりました。AWS 「変換ユーザーガイド」の「開始方法」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS Blu Age ランタイムの設定
AWS Blu Age ランタイムとクライアントコードは、Spring Boot フレームワーク
AWS Blu Age ランタイムには、必要に応じてオプトインできる追加のオプションのウェブアプリケーションも含まれています。
トピック
アプリケーション設定の基本
アプリケーション設定を処理するデフォルトの方法は、アプリケーションサーバーの config フォルダにある専用の YAML ファイルを使用することです。YAML 設定ファイルは主に 2 つあります。
-
application-main.yaml -
application-(profile.yaml値はアプリケーション生成時に設定されます)。profile
最初のファイルはフレームワーク、つまり Gapwalk-application.war を設定し、2 番目のファイルはクライアントアプリケーション専用の追加オプション用です。これは Spring プロファイルを使用しても機能します。Gapwalk アプリケーションは main プロファイルを使用し、クライアントアプリケーションは プロファイルを使用します。profile
次の例は、代表的なメインの YAML ファイルを示しています。
次の例は、代表的なクライアント YAML ファイルを示しています。
YAML ファイルの内容については、「AWS Blu Age ランタイムのプロパティを有効にする」を参照してください。
アプリケーションの優先順位
これらの設定ファイルには、Spring の優先順位ルールが適用されます。特筆すべき点は以下のとおりです。
-
application-mainの YAML ファイルはデフォルト値で Gapwalk のメイン war ファイルに表示され、configフォルダ内のファイルがそれに取って代わります。 -
クライアントアプリケーションの設定についても同じことを行う必要があります。
-
サーバーの起動時に、コマンドラインで追加のパラメータを渡すことができます。これらは YAML の設定を上書きします。
詳細については、「Spring Boot の公式ドキュメント
データベース用 JNDI
データベース設定は Tomcat の context.xml ファイル内の JNDI で提供されている場合があります。このような設定は YAML の設定よりも優先されます。ただし、これを使用しても認証情報をシークレットマネージャーでラップできなくなることに注意してください (以下を参照)。
次の例は、JICS と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
-
JICS データベース
jdbc/jicsの場合は 、Blusamデータベースの場合はjdbc/bluesam(「e」に注意) になります。 - url="jdbc:postgresql://XXXX.rds.amazonaws.com:5432/XXXX" username="XXXX" password="XXXX"
-
データベース URL、ユーザー名、パスワード。
その他のファイル (groovy、SQL など)
カスタマープロジェクトが使用する他のファイルには、Spring 設定のものと同様の優先順位ルールが使われています。例:
-
Groovy スクリプトは
scriptsフォルダまたはサブフォルダ内の.groovyファイルです。 -
SQL スクリプトは
sqlフォルダまたはサブフォルダ内の.sqlファイルです。 -
デーモンスクリプトは
daemonsフォルダまたはサブフォルダ内の.groovyファイルです。 -
クエリデータベースマッピングファイルは、
sqlフォルダのサブフォルダにあるqueries-database.mappingファイルという名前のファイルです。 -
Jasper テンプレートは、
templatesフォルダまたはサブフォルダ内の.jrxmlファイルです。 -
データセットカタログは、
catalogフォルダ内の.jsonファイルです。 -
リンクファイルは、
lnkフォルダ内の.jsonファイルです。
これらすべての場所を、システムプロパティまたはクライアントの YAML プロパティによって上書きできます。
-
Groovy スクリプトの場合:
configuration.scripts -
SQL スクリプトの場合:
configuration.sql -
デーモンスクリプトの場合:
configuration.daemons -
クエリデータベースマッピングファイルの場合:
configuration.databaseMapping -
Jasper テンプレートの場合:
configuration.templates -
データセットカタログの場合:
configuration.catalog -
リンクファイルの場合:
configuration.lnk
プロパティが見つからない場合、ファイルは上記のデフォルトの場所から取得されます。検索は、最初に Tomcat の作業ディレクトリをルートとして行われ、最後にアプリケーションの war ファイル内で行われます。
その他のウェブアプリケーション
AWS Blu Age ランタイムには、そのwebapps-extraフォルダに追加のウェブアプリケーションが含まれています。これらのアプリケーションは、Tomcat サーバーではデフォルトでは提供されません。
これらのウェブアプリケーションへのオプトインはモダナイゼーションプロジェクトによって異なり、必要な war ファイルを webapps-extra フォルダから webapps フォルダに移動して行います。それ以降は、次回の起動時に Tomcat サーバーが war を処理します。
application-main.yml ファイルで行われ、上記で説明したように、war が追加されるたびに YAML 設定ファイルに、プロジェクト固有の設定を追加することもできます。追加の war は以下のとおりです。
-
gapwalk-utility-pgm.war: ZOS ユーティリティプログラムのサポートを含み、その構成としてapplication-utility-pgm.yamlを使用します。 -
gapwalk-cl-command.war: AS/400 ユーティリティプログラムのサポートを含み、その構成としてapplication-cl-command.yamlを使用します。 -
gapwalk-hierarchical-support.war: IMS/MFS トランザクションサポートを含み、その構成としてapplication-jhdb.yamlを使用します。