Skip to content

(4.0)Migration aws2

Jump to bottom
xsekiguchi edited this page Jan 29, 2026 · 1 revision

iPLAss 4.0 において、iplass-ee-aws から iplass-ee-aws2 への変更は以下のように作業する必要があります。

モジュールの変更

  • iPLAss バージョン 4.0.16 以上へ変更する（＊1）
  • build.gradle で指定しているモジュールを iplass-ee-aws2 へ変更する
    • 変更前： runtimeOnly 'org.iplass.ee:iplass-ee-aws'
    • 変更後： runtimeOnly 'org.iplass.ee:iplass-ee-aws2'
  • OpenSearch の機能を利用している場合、 iplass-ee-opensearch を追加する
    • runtimeOnly 'org.iplass.ee:iplass-ee-opensearch

Important

＊1
4.0.1 ～ 4.0.15 のバージョンには S3LobStore に不具合が含まれています。
4.0.16 以上のバージョンをご利用ください。

Service-Config の変更

inherits ファイルの変更

  • 変更前： <inherits>/aws-service-config.xml</inherits>
  • 変更後： <inherits>/aws2-service-config.xml</inherits>

AWSSetting

iplass-ee-aws の AWSSetting の記載を確認してください。

  • 記載がある場合
    • iplass-ee-aws の AWSSetting は削除してください。
    • iplass-ee-aws2 の AWSSetting の設定を追加してください。
  • 記載がない場合
    • 変更は不要です。
      ※inherits で指定している aws-service-config.xml のデフォルト値が利用されています。aws2-service-config.xml でも同様のデフォルト値が設定されます。
      （aws2-service-config.xml デフォルト値では AwsCredentialsProvider に software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider を利用しています。）

難読化関連（Secrets Manager）

暗号化設定を確認してください。

propertyValueCoder

propertyValueCoder に org.iplass.mtp.impl.aws.secretsmanager.SecretsManagerPropertyValueCoder を利用している場合、
propertyValueCoder の設定値を org.iplass.mtp.impl.core.config.secretsmanager.awsv2.SecretsManagerPropertyValueCoder に変更します。

passphraseSupplier

propertyValueCoder に org.iplass.mtp.impl.core.config.DefaultPropertyValueCoder を利用しており、
passphraseSupplier に org.iplass.mtp.impl.aws.secretsmanager.SecretsManagerPassphraseSupplier を利用している場合、
passphraseSupplier の設定値を org.iplass.mtp.impl.core.config.secretsmanager.awsv2.SecretsManagerPassphraseSupplier に変更します。

LobStoreService

LobStore として s3 を利用している場合、変更が必要です。

binaryStore および longTextStore プロパティに

  • org.iplass.mtp.impl.aws.lobstore.s3.S3LobStore を利用している場合
    • org.iplass.mtp.impl.lob.lobstore.s3.awsv2.S3LobStore に変更します。
    • 設定するプロパティは service-config ドキュメントを参照し設定願います。
  • org.iplass.mtp.impl.micrometer.metrics.aws.lobstore.s3.MetricsS3LobStore を利用している場合（micrometer でメトリクスを収集している場合）
    • org.iplass.mtp.impl.lob.lobstore.s3.awsv2.S3LobStore に変更します。
    • 設定するプロパティは service-config ドキュメントを参照し設定願います。
    • S3LobStore の s3Controller プロパティに設定するクラスのプロパティ requestConfigureList （S3RequestConfigure）に
      org.iplass.mtp.impl.lob.lobstore.s3.awsv2.S3RequestMetricPublisherConfigure を設定してください。 （＊3）

Note

＊1 s3controller プロパティで S3ClientFactory を設定する箇所があります。
　　選択肢として同期・非同期・非同期（crt）設定値はアプリケーションのワークロードに応じて決定してください。
　　（記載されているヒントもご確認願います）

＊2 非同期（crt）を利用する場合は、ライブラリ software.amazon.awssdk.crt:aws-crt の追加が必要となります。

＊3 非同期（crt）を選択している場合はメトリクス収集ができません。

MailService

Mail送信機能として ses を利用している場合、変更が必要です。

  • 変更前： org.iplass.mtp.impl.aws.AWSMailService
  • 変更後： org.iplass.mtp.impl.mail.ses.awsv2.SesMailService

FulltextSearchService

全文検索機能として opensearch を利用している場合、変更が必要です。

  • 変更前： org.iplass.mtp.impl.aws.fulltextsearch.opensearch.OpenSearchFulltextSearchService
  • 変更後： org.iplass.mtp.impl.fulltextsearch.opensearch.OpenSearchFulltextSearchService

WebFrontendService

mdc プロパティに、AmznTraceIdMdcValueResolver を指定している場合、クラス名の変更が必要です。

  • 変更前： org.iplass.mtp.impl.aws.web.mdc.AmznTraceIdMdcValueResolver
  • 変更後： org.iplass.mtp.impl.web.mdc.awsv2.AmznTraceIdMdcValueResolver

MicrometerService （iplass-ee-micrometer を利用している場合）

meterRegistryFactory プロパティに ElasticMeterRegistryFactory を利用している場合

httpSender プロパティの設定値を確認してください。

  • 変更前： org.iplass.mtp.impl.micrometer.aws.AWSHttpSender
  • 変更後： org.iplass.mtp.impl.micrometer.awsv2.AWSHttpSender

meterRegistryFactory プロパティに CloudWatchMeterRegistryFactory を利用している場合

メトリクスを cloudwatch に送信している場合、変更が必要です。

  • 変更前： org.iplass.mtp.impl.aws.micrometer.registry.cloudwatch.CloudWatchMeterRegistryFactory
  • 変更後： org.iplass.mtp.impl.aws.micrometer.registry.cloudwatch.awsv2.CloudWatchMeterRegistryFactory

この場合、build.gradle のライブラリを micrometer-registry-cloudwatch から micrometer-registry-cloudwatch2 に変更する必要があります。

  • 変更前： runtimeOnly 'io.micrometer:micrometer-registry-cloudwatch:1.12.8'
  • 変更後： runtimeOnly 'io.micrometer:micrometer-registry-cloudwatch2:1.12.8'
    • ※micrometer-registry-cloudwatch, micrometer-registry-cloudwatch2 のバージョンは、iPLAss で指定しているバージョンです。
      個別にバージョンを変更している場合は、変更しているバージョンを指定してください。

その他

  • 独自に直接AWS SDKを操作するようなコードを記述している場合、また直接 iplass-ee-aws のライブラリを参照するコードを記載している場合は、そちらの修正も必要と思われます

Clone this wiki locally