と 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 を依頼を選択します。

次に、ジョブのタイプとして Mainframe Modernization を選択します。

チャットウィンドウで、「コードを Java に変換する」と入力します。

推奨されるジョブタイプ、名前、目標を確認します。確認するには、「はい」と入力します。

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

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

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

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

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

cd mainframe-transformation-e2e/infra

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

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

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

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

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

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

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

terraform init

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

terraform plan

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

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

terraform apply

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

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

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

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

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

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

./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 のドメインネームシステム (DNS) 名を見つけますapplication-load-balancer-<id>.<region>.elb.amazonaws.com。

ブラウザで、 に移動します。ここで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