AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) は、新規のお客様に公開されなくなりました。 AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) と同様の機能については、 AWS Mainframe Modernization Service (セルフマネージドエクスペリエンス) をご覧ください。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、[AWS 「 Mainframe Modernization の可用性の変更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# メインフレームランタイムの AWS 変換の設定
<a name="ba-runtime-config"></a>

メインフレームランタイムの AWS 変換とクライアントコードは、[Spring Boot フレームワーク](https://docs.spring.io/spring-boot/docs/2.5.14/reference/html/)を使用するウェブアプリケーションです。Spring の機能を活用して、考えられる場所や優先順位のルールを複数指定して設定を行います。groovy スクリプト、SQL など、他の多くのファイルを指定する場合にも同様の優先順位ルールがあります。

メインフレームランタイムの AWS 変換には、必要に応じてオプトインできる追加のオプションのウェブアプリケーションも含まれています。

**Topics**
+ [アプリケーション設定の基本](#ba-runtime-config-app-basics)
+ [アプリケーションの優先順位](#ba-runtime-config-app-precedence)
+ [データベース用 JNDI](#ba-runtime-config-app-jndi)
+ [AWS メインフレームランタイムシークレットの変換](ba-runtime-config-app-secrets.md)
+ [その他のファイル (groovy、SQL など)](#ba-runtime-config-app-files)
+ [その他のウェブアプリケーション](#ba-runtime-config-app-webapp)
+ [メインフレームランタイムの AWS 変換のプロパティを有効にする](ba-runtime-key-value.md)
+ [AWS Transform for mainframe Runtime で使用可能な Redis キャッシュプロパティ](ba-runtime-redis-configuration.md)
+ [Gapwalk アプリケーションのセキュリティを設定する](ba-runtime-security.md)

## アプリケーション設定の基本
<a name="ba-runtime-config-app-basics"></a>

アプリケーション設定を処理するデフォルトの方法は、アプリケーションサーバーの `config` フォルダにある専用の YAML ファイルを使用することです。YAML 設定ファイルは主に 2 つあります。
+ `application-main.yaml`
+ `application-profile.yaml` (`profile` 値はアプリケーション生成時に設定されます)。

最初のファイルはフレームワーク、つまり `Gapwalk-application.war` を設定し、2 番目のファイルはクライアントアプリケーション専用の追加オプション用です。これは Spring プロファイルを使用しても機能します。Gapwalk アプリケーションは `main` プロファイルを使用し、クライアントアプリケーションは `profile` プロファイルを使用します。

次の例は、代表的なメインの YAML ファイルを示しています。

![\[「メインの」 YAML ファイルの抜粋。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/main-yaml.png)


次の例は、代表的なクライアント YAML ファイルを示しています。

![\[クライアント YAML の例\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/client-yaml.png)


YAML ファイルの内容については、「[メインフレームランタイムの AWS 変換のプロパティを有効にする](ba-runtime-key-value.md)」を参照してください。

## アプリケーションの優先順位
<a name="ba-runtime-config-app-precedence"></a>

これらの設定ファイルには、Spring の優先順位ルールが適用されます。特筆すべき点は以下のとおりです。
+ `application-main` の YAML ファイルはデフォルト値で Gapwalk のメイン war ファイルに表示され、`config` フォルダ内のファイルがそれに取って代わります。
+ クライアントアプリケーションの設定についても同じことを行う必要があります。
+ サーバーの起動時に、コマンドラインで追加のパラメータを渡すことができます。これらは YAML の設定を上書きします。

詳細については、「[Spring Boot の公式ドキュメント](https://docs.spring.io/spring-boot/docs/2.5.14/reference/html/features.html#features.external-config)」を参照してください。

## データベース用 JNDI
<a name="ba-runtime-config-app-jndi"></a>

データベース設定は 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 など)
<a name="ba-runtime-config-app-files"></a>

カスタマープロジェクトが使用する他のファイルには、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 ファイル内で行われます。

## その他のウェブアプリケーション
<a name="ba-runtime-config-app-webapp"></a>

Transform AWS for mainframe Runtime には、その`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` を使用します。