

AWS Mainframe Modernization Service(관리형 런타임 환경 환경 환경)는 더 이상 신규 고객에게 공개되지 않습니다. AWS Mainframe Modernization Service(관리형 런타임 환경 환경)와 유사한 기능은 AWS Mainframe Modernization Service(자체 관리형 환경)를 참조하세요. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [AWS Mainframe Modernization 가용성 변경을](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html) 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 자습서: 메인프레임 AWS 변환을 위한 관리형 런타임 설정
<a name="tutorial-runtime-ba"></a>

이 자습서에 지정된 데모 애플리케이션을 사용하여 메인프레임 현대화 애플리케이션을 위한 AWS 변환을 AWS 메인프레임 현대화 런타임 환경에 배포할 수 있습니다.

**Topics**
+ [사전 조건](#tutorial-runtime-ba-prerequisites)
+ [1단계: 데모 애플리케이션 업로드](#tutorial-runtime-ba-step1)
+ [2단계: 애플리케이션 정의 만들기](#tutorial-runtime-ba-step2)
+ [3단계: 런타임 환경 생성](#tutorial-runtime-ba-step3)
+ [4단계: 애플리케이션 생성](#tutorial-runtime-ba-step4)
+ [3단계: 애플리케이션 배포](#tutorial-runtime-ba-step5)
+ [6단계: 애플리케이션 시작](#tutorial-runtime-ba-step6)
+ [7단계: 애플리케이션 액세스](#tutorial-runtime-ba-step7)
+ [8단계: 애플리케이션 테스트](#tutorial-runtime-ba-test)
+ [리소스 정리](#tutorial-runtime-ba-clean)

## 사전 조건
<a name="tutorial-runtime-ba-prerequisites"></a>

이 자습서를 완료하려면 데모 애플리케이션 아카이브 [PlanetsDemo-v4.zip](https://d2azvcayevmroy.cloudfront.net/tutorials/bluage/PlanetsDemo-v4.zip)을 다운로드하세요.

실행 중인 데모 애플리케이션에 액세스하려면 최신 브라우저가 필요합니다. 이 브라우저를 데스크톱에서 실행할지, Amazon Elastic Compute Cloud 인스턴스(예: VPC 내)에서 실행하는지에 따라 보안 설정이 결정됩니다.

## 1단계: 데모 애플리케이션 업로드
<a name="tutorial-runtime-ba-step1"></a>

Amazon S3 버킷에 애플리케이션 개정 버전을 업로드합니다. 애플리케이션을 배포할 AWS 리전 위치와 동일한 위치에 이 버킷이 있는지 확인하세요. 다음 예제에서는 키 접두사 또는 폴더가 v**1**이고 아카이브가 인 **planets-demo**라는 버킷을 보여줍니다`planetsdemo-v4.zip`.

![\[v1 접두사와 planetsdemo-v4.zip 파일을 보여주는 Amazon S3의 PlanetsDemo 버킷입니다.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/s3-ba-bucket.png)


**참고**  
버킷의 폴더는 필수입니다.

## 2단계: 애플리케이션 정의 만들기
<a name="tutorial-runtime-ba-step2"></a>

관리형 런타임에 애플리케이션을 배포하려면 AWS Mainframe Modernization 애플리케이션 정의가 필요합니다. 이 정의는 애플리케이션 위치 및 설정을 설명하는 JSON 파일입니다. 다음 예제는 데모 애플리케이션에 대한 이러한 애플리케이션 정의입니다.

```
{
    "template-version": "2.0",
    "source-locations": [{
        "source-id": "s3-source",
        "source-type": "s3",
        "properties": {
            "s3-bucket": "planets-demo",
            "s3-key-prefix": "v1"
        }
    }],
    "definition": {
        "listeners": [{
            "port": 8196,
            "type": "http"
        }],
        "ba-application": {
            "app-location": "${s3-source}/PlanetsDemo-v4.zip"
        }
    }
}
```

`s3-bucket` 항목을 샘플 애플리케이션 zip 파일의 이름(예: `planets-demo`)으로 변경하고, `app-location` 항목을 샘플 애플리케이션 zip 파일을 저장한 S3 경로(예: `${s3-source}/PlanetsDemo-v4.zip`)로 변경합니다.

**참고**  
로컬에서 애플리케이션 정의 파일을 텍스트 파일로 생성해야 합니다.

애플리케이션 정의에 대한 자세한 내용은 [AWS 메인프레임 애플리케이션 정의 샘플에 대한 변환](applications-m2-definition.md#applications-m2-definition-ba)를 참조하세요.

## 3단계: 런타임 환경 생성
<a name="tutorial-runtime-ba-step3"></a>

 AWS Mainframe Modernization 런타임 환경을 생성하려면 다음 단계를 수행합니다.

1. [AWS Mainframe Modernization](https://us-east-2.console.aws.amazon.com/m2/home?region=us-east-2#/landing) 콘솔을 엽니다.

1.  AWS 리전 선택기에서 환경을 생성할 리전을 선택합니다. 이는에서 S3 버킷을 생성한 리전과 일치해야 AWS 리전 합니다[1단계: 데모 애플리케이션 업로드](#tutorial-runtime-ba-step1).

1. **메인프레임 애플리케이션 현대화**에서 **메인프레임용 AWS 변환으로 리팩터**링을 선택한 다음 **시작하기를** 선택합니다.  
![\[메인프레임에 대해 리팩터링 AWS 변환을 선택한 메인프레임 애플리케이션 현대화 섹션.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/m2-ba-get-started.png)

1. **AWS Mainframe Modernization에 도움이 되는 방법**에서 **배포**와 **런타임 환경 생성**을 선택합니다.  
![\[런타임 환경 배포 및 생성이 선택된 AWS 메인프레임 현대화로 시작하는 방법 섹션입니다.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/update-m2-ba-deploy-create-env.png)

1. 왼쪽 탐색 창에서 **컴퓨팅 환경**을 선택한 다음 **환경 생성**을 선택합니다. **기본 정보 지정** 페이지에서 환경의 이름과 설명을 입력한 다음 **AWS Blu Age** 엔진이 선택되었는지 확인합니다. 선택적으로 생성된 리소스에 태그를 추가할 수 있습니다. 그리고 **다음**을 선택합니다.  
![\[AWS 메인프레임 현대화 메인프레임 엔진 AWS 변환이 선택된 기본 정보 지정 페이지입니다.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/m2-ba-env-basic.png)

1. **구성 지정** 페이지에서 **독립형 런타임 환경**을 선택합니다.  
![\[독립 실행형 런타임 환경이 선택된 AWS 메인프레임 현대화 가용성 섹션.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/m2-ba-config-avail.png)

1. **보안 및 네트워크**에서 다음과 같이 변경합니다.
   + **이 환경에 배포된 애플리케이션을 공개적으로 액세스할 수 있도록 허용**을 선택합니다. 이 옵션은 데스크톱에서 액세스할 수 있도록 애플리케이션에 퍼블릭 IP 주소를 할당합니다.
   + VPC를 선택합니다. **기본값**을 사용할 수 있습니다.
   + 서브넷 두 개를 선택합니다. 서브넷에서 퍼블릭 IP 주소 할당을 허용하는지 확인하세요.
   + 보안 그룹을 선택합니다. **기본값**을 사용할 수 있습니다. 선택한 보안 그룹이 브라우저 IP 주소로부터 애플리케이션 정의의 `listener` 속성에 지정한 포트에 액세스할 수 있도록 허용하는지 확인하세요. 자세한 내용은 [2단계: 애플리케이션 정의 만들기](#tutorial-runtime-ba-step2) 섹션을 참조하세요.  
![\[기본 VPC와 두 개의 서브넷이 선택된 보안 및 네트워크 섹션.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/m2-ba-security-network.png)

   선택한 VPC 외부에서 애플리케이션에 액세스하려는 경우 해당 VPC의 인바운드 규칙이 제대로 구성되어 있는지 확인하세요. 자세한 내용은 [오류 해결: 애플리케이션 URL에 액세스할 수 없음](both-application-connectivity.md) 섹션을 참조하세요.

1. **다음**을 선택합니다.

1. **스토리지 연결 - 선택 사항**에서 기본 선택 사항을 그대로 두고 **다음**을 선택합니다.  
![\[기본값이 적용된 스토리지 연결 페이지.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/m2-ba-attach-storage.png)

1. **일정 유지 관리**에서 **기본 설정 없음**을 선택한 후 **다음**을 선택합니다.

1. **검토 및 만들기**에서 정보를 검토한 다음 **환경 만들기**를 선택합니다.

## 4단계: 애플리케이션 생성
<a name="tutorial-runtime-ba-step4"></a>

1.  AWS Management Console에서 **AWS Mainframe Modernization**로 이동하세요.

1. 탐색 창에서 **애플리케이션(Applications)**을 선택한 다음 **애플리케이션 생성(Create application)**을 선택합니다. **기본 정보 지정** 페이지에서 애플리케이션의 이름과 설명을 입력하고 **메인프레임 엔진용 AWS 변환**이 선택되어 있는지 확인합니다. 그리고 **다음**을 선택합니다.  
![\[애플리케이션 메인프레임 엔진 AWS 변환이 선택된 기본 정보 지정 페이지입니다.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/m2-ba-app-basic.png)

1. **리소스 및 구성 지정** 페이지에서 [2단계: 애플리케이션 정의 만들기](#tutorial-runtime-ba-step2)에서 생성한 업데이트된 애플리케이션 정의 JSON을 복사하여 붙여넣습니다.  
![\[업데이트된 애플리케이션 정의 JSON이 붙여 넣기된 리소스 및 구성 섹션.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/m2-ba-resources-configs.png)

1. **검토 및 생성**에서 선택 사항을 검토한 다음 **애플리케이션 생성**을 선택합니다.
**참고**  
애플리케이션 생성에 실패하면 대/소문자를 구분하므로 입력한 S3 경로를 확인합니다.

## 3단계: 애플리케이션 배포
<a name="tutorial-runtime-ba-step5"></a>

 AWS Mainframe Modernization 런타임 환경과 애플리케이션을 모두 성공적으로 생성하고 둘 다 **사용 가능** 상태이면 애플리케이션을 런타임 환경에 배포할 수 있습니다. 이렇게 하려면 다음 단계를 완료하세요.

1.  AWS 관리 콘솔에서 **AWS Mainframe Modernization**으로 이동합니다. 탐색 창에서 **환경**을 선택합니다. 환경 목록 페이지가 표시됩니다.  
![\[AWS Mainframe Modernization 런타임 환경 목록입니다.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/m2-ba-environments.png)

1. 이전에 만든 런타임 환경을 선택합니다. 환경 세부 정보 페이지가 표시됩니다.

1. **애플리케이션 배포**를 선택합니다.  
![\[planets-demo-env 환경을 위한 환경 세부 정보 페이지.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/m2-ba-env-details-planets.png)

1. 이전에 만든 애플리케이션을 선택한 다음 애플리케이션을 배포할 버전을 선택합니다. 그런 다음 **배포**를 선택합니다.  
![\[행성 데모 앱이 표시된 AWS Mainframe Modernization Deploy 애플리케이션 페이지입니다.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/m2-ba-app-deploy.png)

1. 애플리케이션 배포가 완료될 때까지 기다리세요. **애플리케이션이 성공적으로 배포되었습니다**라는 메시지가 포함된 배너가 표시됩니다.

## 6단계: 애플리케이션 시작
<a name="tutorial-runtime-ba-step6"></a>

1. 에서 **AWS Mainframe Modernization**으로 이동하여 **애플리케이션을** AWS Management Console 선택합니다.

1. 애플리케이션 페이지로 이동하고 **배포**를 선택합니다. 애플리케이션 상태는 **성공**이어야 합니다.  
![\[배포 상태가 성공으로 표시된 AWS 메인프레임 현대화 배포 페이지입니다.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/m2-ba-app-deployments-succeeded.png)

1. **작업**을 선택한 후 **애플리케이션 시작**을 선택합니다.

## 7단계: 애플리케이션 액세스
<a name="tutorial-runtime-ba-step7"></a>

1. 애플리케이션이 **실행** 상태가 될 때까지 기다리세요. **애플리케이션이 성공적으로 시작되었습니다**라는 메시지가 포함된 배너가 표시됩니다.

1. 애플리케이션 DNS 호스트 이름을 복사합니다. 애플리케이션의 **애플리케이션 정보** 섹션에서 이 호스트 이름을 찾을 수 있습니다.

1. 브라우저에서 `http://{hostname}:{portname}/PlanetsDemo-web-1.0.0/`으로 이동하세요.
   + `hostname`은 이전에 DNS 호스트 이름이 복사되었습니다.
   + `portname`은 [2단계: 애플리케이션 정의 만들기](#tutorial-runtime-ba-step2)에서 생성한 애플리케이션 정의에 정의된 Tomcat 포트입니다.

   JICS 화면이 나타납니다.  
![\[JICS 트랜잭션 런처 페이지.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/ba-jics-launcher.png)

애플리케이션에 액세스할 수 없는 경우 [오류 해결: 애플리케이션 URL에 액세스할 수 없음](both-application-connectivity.md)를 참조하세요.

**참고**  
애플리케이션에 액세스할 수 없고 보안 그룹의 인바운드 규칙에 포트 8196에서 '내 IP'가 선택된 경우 포트 8196에서 LB i/p의 트래픽을 허용하는 규칙을 지정합니다.

## 8단계: 애플리케이션 테스트
<a name="tutorial-runtime-ba-test"></a>

이 단계에서는 마이그레이션된 애플리케이션에서 트랜잭션을 실행합니다.

1. JICS 화면에서 입력 필드에 `PINQ`를 입력하고 **실행**을 선택하거나 Enter 키를 눌러 애플리케이션 트랜잭션을 시작합니다.

   데모 앱 화면이 나타나야 합니다.  
![\[삽입 모드의 PlanetsDemo 애플리케이션 화면.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/ba-demo-app-screen.png)

1. 해당 필드에 행성 이름을 입력하고 Enter 키를 누릅니다.  
![\[행성 이름 필드에 지구가 입력된 PlanetsDemo 애플리케이션 화면.\]](http://docs.aws.amazon.com/ko_kr/m2/latest/userguide/images/ba-demo-with-data.png)

   행성에 대한 세부 정보를 볼 수 있을 것입니다.

## 리소스 정리
<a name="tutorial-runtime-ba-clean"></a>

이 자습서를 진행하기 위해 생성한 리소스가 더 이상 필요하지 않은 경우 해당 리소스를 삭제합니다. 이렇게 하려면 다음 단계를 완료합니다.
+  AWS Mainframe Modernization 애플리케이션이 여전히 실행 중인 경우 중지합니다.
+ 애플리케이션을 삭제합니다. 자세한 내용은 [AWS Mainframe Modernization 애플리케이션 삭제](applications-m2-delete.md) 섹션을 참조하세요.
+ 런타임 환경을 삭제합니다. 자세한 내용은 [AWS Mainframe Modernization 런타임 환경 삭제런타임 환경 삭제](delete-environments-m2.md) 섹션을 참조하세요.