と Terraform を使用してメインフレームアプリケーションをモダナイズ AWS Transform およびデプロイする

次のコマンドを入力し、CardDemo リポジトリをローカルのワークステーションにクローンします。

git clone https://github.com/aws-samples/aws-mainframe-modernization-carddemo.git

aws-mainframe-modernization-carddemo フォルダを ZIP ファイルに圧縮します。

作成した Amazon S3 バケットに ZIP ファイルをアップロードします。手順については、Amazon S3 ドキュメントの「オブジェクトのアップロード」を参照してください。

認証情報を使用してログインして、 AWS Transform ウェブアプリケーションにアクセスします。

AWS Transform ドキュメントの「ワークスペースのセットアップ」の手順に従って、新しいワークスペースを作成します。

ワークスペースのランディングページで、ジョブの作成 AWS Transform を依頼を選択します。

次に、ジョブのタイプとして [メインフレームのモダナイズ] を選択します。

チャットウィンドウで [コードを Java に変換] と入力します。

推奨されるジョブタイプ、名前、目標を確認します。[はい] を押して確認します。

[ジョブの作成] を選択します。 

作成した Amazon S3 バケットを使用してコネクタを設定します。手順については、 AWS Transform ドキュメントの「コネクタのセットアップ」を参照してください。プロンプトが表示されたら、Amazon S3 バケットの aws-mainframe-modernization-carddemo zip ファイルのパスを入力します。

分析が完了するまで待ちます。

AWS Transform ドキュメントの「コードを分析する」の指示に従って、コード分析の結果を確認します。

AWS Transform ドキュメントの「リファクタリングコード」の指示に従って、メインフレームコードをリファクタリングします。サンプル CardDemo メインフレームアプリケーションでは、デフォルト設定を受け入れることができます。

リファクタリングが完了するまで待ちます。

[結果の表示] を選択して、Amazon S3 バケット内のリファクタリングされたコードのパスを表示します。ファイルパスを書き留めておきます。後で必要になります。

次のコマンドを入力して、メインフレーム変換 E2E リポジトリをローカルワークステーションにクローンします。

git clone https://github.com/aws-samples/sample-mainframe-transformation-e2e.git

現在のパブリック IP アドレスを取得するには、次のコマンドを入力します。

curl checkip.amazonaws.com

以下のコマンドを入力して、インフラストラクチャのディレクトリに移動します。

cd mainframe-transformation-e2e/infra

variables.tf ファイルを開きます。

YOUR_IP_ADDRESS_HERE を IP アドレスに置き換えます。

パブリックのホストゾーンがある場合は、次の操作を行います。

パブリックのホストゾーンがない場合は、次の操作を行います。

aws_region をターゲットリージョンに変更します。デフォルトは us-east-1 です。

variables.tf ファイルを保存して閉じます。

次のコマンドを入力して、Terraform を初期化します。

terraform init

実行プランを生成するには、次のコマンドを入力します。

terraform plan

計画を確認し、作成されるリソースとインフラストラクチャコンポーネントを検証します。

次のコマンドを入力してインフラストラクチャをデプロイします。

terraform apply

プロンプトが表示されたら、yes と入力してデプロイを確認します。

デプロイが完了するまで待ちます。

AWS Systems Manager Session Manager を使用して Amazon EC2 インスタンスに接続します。

ルートユーザーに切り替えるには、次のコマンドを入力します。

sudo su -

以下のコマンドを入力して、scripts ディレクトリに移動します。

cd /opt/scripts

install_software.sh スクリプトを確認します。このスクリプトは、Java 17、Apache Maven、および Apache Tomcat 10.0.23 をインストールします。

ユースケースに応じてスクリプトを更新します。

次のコマンドを入力して、スクリプトを実行可能にします。

chmod +x install_software.sh

次のコマンドを入力してスクリプトを実行します。

./install_software.sh

次のコマンドを入力して Tomcat サーバーを起動します。

/opt/tomcat/apache-tomcat-10.0.23/bin/startup.sh

次のコマンドを入力してウェブサーバーのレスポンスを確認します。

curl http://localhost:8080

出力により、Tomcat が HTML ページを提供していることが確認されます。

download_and_extract.sh スクリプトを実行可能にするには、次のコマンドを入力します。このスクリプトは、Amazon S3 バケットに保存されているリファクタリングされたコードと Gapwalk ランタイムライブラリをダウンロードします。

chmod +x /opt/scripts/download_and_extract.sh

次のコマンドを入力してスクリプトを実行します。<file_path> を Amazon S3 バケット内の generated.zip ファイルへのパスに置き換えます。

./download_and_extract.sh <file_path>

次のコマンドを入力して、shared フォルダに移動します。

cd /opt/runtime/velocity/shared

deploy-velocity-runtime.sh スクリプトをコピーするには、次のコマンドを入力します。

cp /opt/scripts/deploy-velocity-runtime.sh .

次のコマンドを入力して、コピーしたスクリプトを実行可能にします。

chmod +x deploy-velocity-runtime.sh

次のコマンドを入力してスクリプトを実行します。このスクリプトは、プロジェクトオブジェクトモデル (POM) ファイルに存在するすべての必要な Web Application Archive (WAR) 依存関係をリポジトリフォルダにコピーします。

./deploy-velocity-runtime.sh

エラーがないこと、および必要な WAR 依存関係がローカル Maven リポジトリにインストールされていることを確認します。

以下のコマンドを入力して、app-pom プロジェクトディレクトリに移動します。

cd /opt/codebase/app-pom/

次のコマンドを入力して Maven をインストールします。

mvn clean install

インストールと構築が完了するまで待ちます。

構築が正常に完了したら、app-service/target/app-service-1.0.0.war と app-web/target/app-web-1.0.0.war が存在していることを確認します。

次のコマンドを入力して、csd commands フォルダの名前を csd_commands に変更します。これにより、フォルダ名からスペースが削除されます。

mv /opt/codebase/extra/csd\ commands/ /opt/codebase/extra/csd_commands

以下のコマンドを入力して、scripts ディレクトリに移動します。

cd /opt/scripts

次のコマンドを入力して、データベース移行スクリプトを実行可能にします。

chmod +x database_migration_setup.sh

次のコマンドを入力して、次の変数をパラメータとして設定します。

RDS_ENDPOINT=<database_endpoint>
SECRET_NAME=<secret_name>
JICS_SQL_SCRIPT_DIR=/opt/runtime/velocity/jics/sql/jics.sql
INIT_JICS_SQL_SCRIPT_DIR=/opt/codebase/extra/csd_commands/sql/aws-mainframe-modernization-carddemo-main/app/csd/initJics.sql

コードの説明は以下のとおりです。

次のコマンドを入力して、データベース移行スクリプトを実行します。

./database_migration_setup.sh $RDS_ENDPOINT $SECRET_NAME $JICS_SQL_SCRIPT_DIR $INIT_JICS_SQL_SCRIPT_DIR

次のコマンドを入力して、Amazon EC2 インスタンスからデータベースに接続します。

psql -h <Your Amazon RDS Endpoint> -U foo -p 5432 postgres

プロンプトが表示されたら、データベースの認証情報を入力します。

すべてのデータベースを一覧表示するには、以下のコマンドを入力します。

\l

jics データベースに切り替えるには、次のコマンドを入力します。

\c jics

次のコマンドを入力して、作成されたテーブルのリストを確認します。

\dt

execute_listcat_sql.sh スクリプトを実行可能にするには、次のコマンドを入力します。

chmod +x execute_listcat_sql.sh

次のコマンドを入力して、LISTCAT SQL ファイルを含むディレクトリである PATH_TO_LISTCAT_SQL_FILES 変数を設定します。

PATH_TO_LISTCAT_SQL_FILES=/opt/codebase/extra/listcat/sql/cluster/aws-mainframe-modernization-carddemo-main/app/catlg

RDS_ENDPOINT と SECRET_NAME、および PATH_TO_LISTCAT_SQL_FILES 変数が前の手順に従って正しく設定されていることを確認します。

次のコマンドを入力して execute_listcat_sql.sh スクリプトを実行します。

./execute_listcat_sql.sh $RDS_ENDPOINT $SECRET_NAME $PATH_TO_LISTCAT_SQL_FILES

このスクリプトは、JICS データベースの VSAM ファイルプロパティを更新し、データベースを変更するために必要なクエリを実行します。

application_installer.sh スクリプトを実行可能にするには、次のコマンドを入力します。

chmod +x /opt/scripts/application_installer.sh

次のコマンドを入力して、次の変数をパラメータとして設定します。

RDS_ENDPOINT=<database_endpoint>
SECRET_NAME=<secret_name>
AIX_JSON_FILE_PATH=/opt/codebase/extra/csd_commands/json/aws-mainframe-modernization-carddemo-main/jicsFileAix.json
LISTCAT_JSON_FILES_DIR=/opt/codebase/extra/listcat/json/cluster/default/aws-mainframe-modernization-carddemo-main/app/catlg
S3_PATH_FOR_EBCDIC_DATA_FILES=s3://<bucket_name>/transform-output/<job_id>/inputs/aws-mainframe-modernization-carddemo-main/app/data/EBCDIC

コードの説明は以下のとおりです。

application_installer.sh スクリプトを実行するには、次のコマンドを入力します。

./application_installer.sh $RDS_ENDPOINT $SECRET_NAME $AIX_JSON_FILE_PATH $LISTCAT_JSON_FILES_DIR $S3_PATH_FOR_EBCDIC_DATA_FILES

/opt/tomcat/apache-tomcat-10.0.23/workingdir/config フォルダの application-utility-pgm.yml ファイルで、エンコードパラメータを次のように変更します。

encoding : CP1047

以下のコマンドを入力して、ワーキングディレクトリに移動します。

cd /opt/tomcat/apache-tomcat-10.0.23/workingdir

Tomcat サーバーを停止および起動するには、次のコマンドを入力します。

/opt/tomcat/apache-tomcat-10.0.23/bin/shutdown.sh
/opt/tomcat/apache-tomcat-10.0.23/bin/startup.sh

次のコマンドを入力して、Tomcat のサービス起動ログをモニタします。

tail -f /opt/tomcat/apache-tomcat-10.0.23/logs/catalina.out

Amazon EC2 コンソールを開きます。

ナビゲーションペインで、[Load Balancers] (ロードバランサー) を選択します。

Terraform で作成されたロードバランサーを選択します。

application-load-balancer-<id>.<region>.elb.amazonaws.com などの Application Load Balancer のドメインネームシステム (DNS) 名を見つけます。

ブラウザで http://<dns_name>/gapwalk-application/scripts/data-load に移動します。ここで <dns_name> は Application Load Balancer の DSN 名です。これにより、データロードスクリプトが開始されます。

スクリプトが完了するまで待ちます。完了すると、ブラウザに [DONE] と表示されます。

Amazon EC2 インスタンスで、新しいターミナルを開きます。

次のコマンドを入力して Amazon RDS データベースに接続し、<database_endpoint> の値を置き換えます。

psql -h <database_endpoint> -U foo -p 5432 postgres

プロンプトが表示されたら、認証情報を入力してデータベースに接続します。

すべてのデータベースを一覧表示するには、以下のコマンドを入力します。

\l

bluesam データベースに切り替えるには、次のコマンドを入力します。

\c bluesam

次のコマンドを入力して、作成されたテーブルのリストを確認します。

\dt

データロードを確認するには、次のコマンドを入力します。

SELECT * FROM public.aws_m2_carddemo_usrsec_vsam_ksds;

返された 10 個のレコードがアウトプットに表示されます。

以下のコマンドを入力して、スクリプトディレクトリに移動します。

cd /opt/tomcat/apache-tomcat-10.0.23/webapps/workingdir/scripts

フラットファイルへの参照を含むすべての Groovy ファイルで、次のファイル設定を更新します。

参照資料として、コードリポジトリのサンプル DUSRSECJ.jcl.groovy スクリプトもご確認ください。。

ファイルを保存して閉じます。

Application Load Balancer (http://<your-load-balancer-dns>) またはホストゾーン (https://myhostedzone.dev/) からオンラインアプリケーションにアクセスします。

トランザクション ID には、CC00 と入力します。

ユーザー名に USER0001 と入力します。

パスワードには PASSWORD と入力します。

ログインに成功すると、メインメニューが表示されます。

Application Load Balancer (http://<your-load-balancer-dns>/gapwalk-application/scripts) またはホストゾーン (https://myhostedzone.dev/gapwalk-application/scripts) からスクリプトインターフェイスにアクセスします。

DUSRSECJ.jcl.groovy スクリプトなど、実行するスクリプトを選択します。

スクリプトが正常に実行されたことを確認します。以下は、正常に実行された場合の出力例です。

{ "exitCode": 0, "stepName": "STEP03", "program": "IDCAMS", "status": "Succeeded" }

次のコマンドを入力して、Amazon RDS インスタンスから削除保護を削除します。

aws rds modify-db-instance \
  --db-instance-identifier <your-db-instance-name> \
  --no-deletion-protection \
  --apply-immediately

次のコマンドを入力して、Application Load Balancer から削除保護を削除します。

aws elbv2 modify-load-balancer-attributes \
  --load-balancer-arn <your-load-balancer-arn> \
  --attributes Key=deletion_protection.enabled,Value=false

次のコマンドを入力して、Amazon S3 バケットの内容を削除します。

ACCOUNT_NUMBER=$(aws sts get-caller-identity --query Account --output text)
aws s3 rm s3://mf-carddemo-$ACCOUNT_NUMBER --recursive
aws s3 rm s3://mf-carddemo-logs-$ACCOUNT_NUMBER --recursive

次のコマンドを入力して、infra フォルダに移動します。

cd /mainframe-transformation-e2e/infra

次のコマンドを入力してインフラストラクチャを削除します。

terraform destroy --auto-approve