AWS Transform 및 Terraform을 사용하여 메인프레임 애플리케이션 현대화 및 배포

다음 명령을 입력하여 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 버킷에서 리팩터링된 코드의 경로를 확인합니다. 이 파일 경로를 기록해 둡니다. 잠시 후 필요한 정보입니다.

다음 명령을 입력하여 Mainframe Transformation 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

메시지가 표시되면 예를 입력하여 배포를 확인합니다.

배포가 완료될 때까지 기다립니다.

를 사용하여 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(Project Object Model) 파일에 있는 모든 필수 웹 애플리케이션 아카이브(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 콘솔을 엽니다.

탐색 창에서 로드 밸런서를 선택합니다.

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 이름입니다. 그러면 데이터 로드 스크립트가 시작됩니다.

스크립트가 완료될 때까지 기다립니다. 완료되면 브라우저에 완료가 표시됩니다.

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