AWS Transform 사용자 지정을 사용하여 Easytrieve를 최신 언어로 변환

AWS Transform 사용자 지정을 위한 인프라를 프로비저닝합니다.

보안 변환 환경을 호스팅하는 데 필요한 프로덕션 지원 인프라를 배포합니다. 여기에는 Easytrieve 코드를 변환하는 데 필요한 도구, IAM 권한 및 네트워크 설정으로 구성된 프라이빗 Amazon EC2 인스턴스가 포함됩니다. 코드형 인프라(IaC)를 사용하여 환경을 프로비저닝하려면 AWS Transform 사용자 지정 GitHub 리포지토리를 사용한 Easytrieve to Modern Languages 변환의 배포 지침을 따릅니다. GitHub

변환을 위한 입력 재료를 준비합니다.

BRE 변환 정의 생성

다음 단계에 따라 Easytrieve 소스 코드에서 BRE(비즈니스 규칙 추출)에 대한 사용자 지정 변환 정의를 생성합니다.

1. 이 패턴에 대한 코드 리포지토리로 이동하여 문서 폴더의 bre_transformation_definition.md를 EZT 코딩 가이드가 있는 document_references 폴더와 함께 복사합니다.

2. AWS Transform CLI 업로드의 해당 콘텐츠를 선택한 위치에 업로드하고 다음 단계에서 사용할 경로 위치를 기록해 둡니다.

3. atx 명령을 사용하여 CLI AWS Transform 에서를 호출합니다.

4. CLI에 다음 프롬프트를 제공합니다.

<path to content from step#2> 경로에서 사용할 수 있는 내 변환 정의 파일을 사용하여 사용자 지정 변환 생성

AWS Transform 는 BRE 생성을 위한 새 사용자 지정 변환 정의를 생성합니다.

5. 변환 정의를 검토하고 필요한 경우 변경합니다.

BRE 변환 정의 게시

BRE 변환 정의를 검토하고 검증한 후 자연어 프롬프트를 사용하여 사용자 AWS Transform 지정 레지스트리에 게시하여 Easytrieve-Business-Rule-Extract와 같은 정의 이름을 제공할 수 있습니다.

변환 정의를 생성합니다.

다음 단계에 따라 기능 검증을 통해 EZT에서 Java로의 변환에 대한 사용자 지정 변환 정의를 생성합니다.

변환 정의를 게시합니다.

변환 정의를 검토하고 검증한 후 자연어 프롬프트를 사용하여 사용자 지정 레지스트리에 AWS Transform 게시하여 Easytrieve-to-Java-Migration과 같은 정의 이름을 제공할 수 있습니다.

BRE 생성 작업을 실행합니다.

CLI AWS Transform 명령을 실행하여 비대화형 또는 대화형 옵션을 선택합니다.

비대화형 실행(완전 자율):

atx custom def exec --transformation-name "Easytrieve-Business-Rule-Extract" --code-repository-path ~/root/transform-workspace/mainframe-source/source-code --non-interactive --trust-all-tools

대화형 실행(사람의 감독 아래):

atx custom def exec -n "Easytrieve-Business-Rule-Extract" -p ~/root/transform-workspace/mainframe-source/source-code

중단된 실행 재개:

atx --resume

또는

atx --conversation-id <conversation-id>  

Easytrieve-to-Java-to-Java 변환 단계에서 생성된 BRE 문서를 입력으로 사용할 bre-doc/ 폴더로 이동합니다.

변환 검증 요약을 검토합니다.

사용자 지정 변환을 AWS Transform 실행하기 전에 폴더에 메인프레임 배치 작업을 실행하기 전에 캡처된 필수 데이터 파일이 포함되어 있는지 input-data 확인합니다. 메인프레임 배치 작업을 실행한 후 output-data 폴더가 결과 파일을 캡처하는지 확인합니다. 모든 파일은 실행 요구 사항에 따라 EBCDIC 인코딩을 사용하는 Sequential/Text/DB2 형식입니다.

사용자 지정 변환 작업을 실행합니다.

CLI AWS Transform 명령을 실행하여 비대화형 또는 대화형 옵션을 선택합니다.

:# Non-interactive execution (fully autonomous):
atx custom def exec \
  --transformation-name "Easytrieve-to-Java-Migration" \
  --code-repository-path ~/root/transform-workspace/mainframe-source/source-code \
  --build-command "mvn clean install" \
  --non-interactive \
  --trust-all-tools \

# Interactive execution (with human oversight):
atx custom def exec \
  -n "Easytrieve-to-Java-Migration" \
  -p ~/root/transform-workspace/mainframe-source/source-code \
  -c "mvn clean install"

# Resume interrupted execution:
atx -resume
# OR
atx --conversation-id <conversation-id>

AWS Transform 는 변환 실행 중에 빌드/테스트 명령을 통해 자동으로 검증합니다.

변환 검증 요약을 검토합니다.

검증 보고서에 액세스합니다.

다음 명령을 입력하여 자세한 검증 아티팩트를 검토합니다.

# Full validation report
cat ~/.aws/atx/custom/$LATEST_SESSION/artifacts/validation_report.html

# Generated code location
ls ~/.aws/atx/custom/$LATEST_SESSION/generated/

# Execution logs
cat ~/.aws/atx/custom/$LATEST_SESSION/logs/execution.log

지속적인 학습을 위해 지식 항목을 활성화합니다.

제안된 지식 항목을 영구 구성으로 승격하여 향후 변환 정확도를 개선합니다. 변환 후 에이전트는 식별된 패턴 및 매핑 규칙을 로컬 세션 디렉터리에 저장합니다. 이러한 학습된 항목을 검토하고 적용하려면 Amazon EC2 인스턴스에서 다음 명령을 실행합니다.

# List all knowledge items for a specific transformation definition
atx custom def list-ki -n <transformation-name>

# Retrieve the details of a specific knowledge item
atx custom def get-ki -n <transformation-name> --id <id>

# Update the status of a knowledge item (ENABLED or DISABLED)
atx custom def update-ki-status -n <transformation-name> --id <id> --status ENABLED

# Update the knowledge item configuration to enable auto-approval
atx custom def update-ki-config -n <transformation-name> --auto-enabled TRUE