

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="ba-runtime-setup-onboard"></a>

**참고**  
메인프레임 런타임 액세스를 위한 AWS 변환이 티켓 기반 요청에서 [메인프레임 리팩터링을 위한 AWS 변환](https://bluinsights.aws/)을 통한 직접 다운로드로 전환되었습니다. 메인프레임 리팩터링을 위한 AWS 변환의 [AWS Transform for mainframe Toolbox](https://bluinsights.aws/docs/bluage-toolbox-introduction) 기능을 통해 AWS Transform for mainframe 제품에 액세스하는 새롭고 간소화된 방법을 도입했습니다.

시작하려면 메인프레임 런타임용 AWS 변환에 액세스하기 위한 온보딩을 요청하는 [AWS Support](https://support.console.aws.amazon.com/support/home) 사례를 생성합니다. 요청에 AWS 계정 ID, 사용하려는 AWS 리전, 컴퓨팅 선택, 메인프레임 런타임 버전에 대한 AWS 변환을 포함합니다. 어떤 버전이 필요한지 확실하지 않은 경우 메인프레임 전송 관리자용 AWS 변환에 문의하세요. AWS 메인프레임 현대화 리팩터링 도구에서 생성된 애플리케이션의 코드 소스가 이미 있는 경우 현대화된 코드 베이스 내의 `pom.xml` 파일에 `gapwalk.version` 태그 값을 기록해 둡니다.

**참고**  
메인프레임 런타임에 대한 AWS 변환은 알파 사전 릴리스와 릴리스의 두 가지 주요 품종으로 제공됩니다. 사용할 릴리스를 확인하려면 섹션을 참조[AWS 메인프레임 버전 관리를 위한 변환](ba-versioning.md)하거나 메인프레임 전송 관리자용 AWS 변환에 문의하세요.

## 메인프레임 런타임 AWS 변환을 위한 리전 및 버킷
<a name="ba-runtime-setup-buckets"></a>

메인프레임 런타임 아티팩트에 대한 AWS 변환은 리전별 및 컴퓨팅 선택별로 서로 다른 Amazon S3 버킷에 저장됩니다. 메인프레임 런타임 AWS 리전 용 AWS 변환용의 버킷에 액세스하려면 다음 표에 나열된 이름을 사용합니다.


| AWS 리전 | 버킷 해제 | Alpha 사전 출시 버킷 | 
| --- | --- | --- | 
|  미국 동부(오하이오)  |  aws-bluage-runtime-artifacts-055777665268-us-east-2  | aws-bluage-runtime-artifacts-dev-055777665268-us-east-2 | 
|  미국 동부(버지니아 북부)  |  aws-bluage-runtime-artifacts-139023371234-us-east-1  | aws-bluage-runtime-artifacts-dev-139023371234-us-east-1 | 
|  미국 서부(캘리포니아 북부)  |  aws-bluage-runtime-artifacts-788454048782-us-west-1  | aws-bluage-runtime-artifacts-dev-788454048782-us-west-1 | 
|  미국 서부(오리건)  |  aws-bluage-runtime-artifacts-836771190483-us-west-2  | aws-bluage-runtime-artifacts-dev-836771190483-us-west-2 | 
|  캐나다(중부)  |  aws-bluage-runtime-artifacts-637423580979-ca-central-1  |  aws-bluage-runtime-artifacts-dev-637423580979-ca-central-1  | 
|  유럽(아일랜드)  |  aws-bluage-runtime-artifacts-925278190477-eu-west-1  | aws-bluage-runtime-artifacts-dev-925278190477-eu-west-1 | 
|  유럽(런던)  |  aws-bluage-runtime-artifacts-767397831990-eu-west-1  |  aws-bluage-runtime-artifacts-dev-767397831990-eu-west-1  | 
|  유럽(파리)  |  aws-bluage-runtime-artifacts-673009995881-eu-west-3  | aws-bluage-runtime-artifacts-dev-673009995881-eu-west-3 | 
|  유럽(프랑크푸르트)  |  aws-bluage-runtime-artifacts-485196800481-eu-central-1  | aws-bluage-runtime-artifacts-dev-485196800481-eu-central-1 | 
|  유럽(스톡홀름)  |  aws-bluage-runtime-artifacts-654654484534-eu-north-1  |  aws-bluage-runtime-artifacts-dev-654654484534-eu-north-1  | 
|  유럽(밀라노)  |  aws-bluage-runtime-artifacts-654654328338-eu-south-1  |  aws-bluage-runtime-artifacts-dev-654654328338-eu-south-1  | 
|  유럽(스페인)  |  aws-bluage-runtime-artifacts-905417994954-eu-south-2  |  aws-bluage-runtime-artifacts-dev-905417994954-eu-south-2  | 
|  남아메리카(상파울루)  |  aws-bluage-runtime-artifacts-737536804457-sa-east-1  | aws-bluage-runtime-artifacts-dev-737536804457-sa-east-1 | 
|  아시아 태평양(도쿄)  |  aws-bluage-runtime-artifacts-445578176276-ap-northeast-1  | aws-bluage-runtime-artifacts-dev-445578176276-ap-northeast-1 | 
|  아시아 태평양(서울)  |  aws-bluage-runtime-artifacts-381492221498-ap-northeast-2  |  aws-bluage-runtime-artifacts-dev-381492221498-ap-northeast-2  | 
|  아시아 태평양(오사카)  |  aws-bluage-runtime-artifacts-905418229615-ap-northeast-3  |  aws-bluage-runtime-artifacts-dev-905418229615-ap-northeast-3  | 
|  아시아 태평양(싱가포르)  |  aws-bluage-runtime-artifacts-767397774613-ap-southeast-1  |  aws-bluage-runtime-artifacts-dev-767397774613-ap-southeast-1  | 
|  아시아 태평양(시드니)  |  aws-bluage-runtime-artifacts-726160321909-ap-southeast-2  | aws-bluage-runtime-artifacts-dev-726160321909-ap-southeast-2 | 
|  아시아 태평양(뭄바이)  |  aws-bluage-runtime-artifacts-905418353577-ap-south-1  |  aws-bluage-runtime-artifacts-dev-905418353577-ap-south-1  | 
|  아프리카(케이프타운)  |  aws-bluage-runtime-artifacts-992382777663-af-south-1  |  aws-bluage-runtime-artifacts-dev-992382777663-af-south-1  | 
|  이스라엘(텔아비브)  |  aws-bluage-runtime-artifacts-471112516508-il-central-1  |  aws-bluage-runtime-artifacts-dev-471112516508-il-central-1  | 

## AWS CLI 를 사용하여 버킷의 콘텐츠 나열
<a name="ba-runtime-setup-cmds"></a>

온보딩된 후 터미널에서 다음 AWS CLI 명령을 실행하여 버킷의 콘텐츠를 나열할 수 있습니다.

`aws s3 ls bucket-name `

를 이전 테이블의에 대한 버킷 이름으로 `bucket-name` 바꿉 AWS 리전 니다.

이 명령은 릴리스 버킷의 다음과 같이 메인프레임 런타임용 AWS 변환의 다양한 버전에 해당하는 폴더 목록을 반환합니다.

```
PRE 4.0.0/
PRE 4.10.0/
```

또는 빌드 버킷에 대해 다음 작업을 수행합니다.

```
PRE 4.11.0/
PRE 4.13.0/
```

지원되는 최신 버전을 사용하는 것이 좋습니다. 불가능한 경우 애플리케이션 리팩터링 단계에서 검증된 런타임 버전을 사용하세요. 특정 버전에 사용 가능한 프레임워크를 나열하려면 다음 명령을 실행합니다.

`aws s3 ls s3://bucket-name/version/Framework/`

`bucket-name`를의 버킷 이름으로 바꾸 AWS 리전 고 `version`를 원하는 버전으로 바꿉니다. 다음은 두 가지 예제입니다.

릴리스 버킷의 경우:

`aws s3 ls s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.10.0/Framework/`

명령은 다음과 같은 zip 파일 목록을 반환합니다.

```
2025-04-08 16:11:19  152040176 aws-bluage-runtime-4.10.0.zip
2025-04-08 16:11:52  176518889 aws-bluage-webapps-4.10.0.zip
```

Alpha 시험판 버킷의 경우:

`aws s3 ls s3://aws-bluage-runtime-artifacts-dev-139023371234-us-east-1/4.11.0/Framework/`

명령은 다음과 같은 zip 파일 목록을 반환합니다.

```
2025-04-09 20:23:34  152304534 aws-bluage-runtime-4.11.0.zip
2025-04-09 20:24:07  176262381 aws-bluage-webapps-4.11.0.zip
```

## 프레임워크 다운로드
<a name="ba-runtime-setup-download"></a>

예를 들어 프레임워크를 다운로드하여 기존 Amazon EC2 인스턴스에서 메인프레임 런타임용 AWS 변환 버전을 업그레이드할 수 있습니다.

`aws s3 cp s3://bucket-name/version/Framework/ folder-of-your-choice --recursive `

위치:

folder-of-your-choice  
프레임워크를 다운로드하려는 폴더 경로.

예: `aws s3 cp s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/ . --recursive`

이 명령으로 다음 출력이 생성됩니다.

```
download: s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/aws-bluage-webapps-4.0.0.zip to ./aws-bluage-webapps-4.0.0.zip
download: s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/aws-bluage-runtime-4.0.0.zip to ./aws-bluage-runtime-4.0.0.zip
```

다음과 같이 프레임워크 파일을 나열할 수 있습니다.

`ls -l`

이 명령으로 다음 출력이 생성됩니다.

```
total 230928
-rw-rw-r-- 1 cloudshell-user cloudshell-user 152040176 Apr  8 16:11 aws-bluage-runtime-4.0.0.zip
-rw-rw-r-- 1 cloudshell-user cloudshell-user 176518889 Apr  8 16:11 aws-bluage-webapps-4.0.0.zip
```

**참고**  
아티팩트에 대한 액세스는 일시적으로 중단될 수 있으며 보안상의 이유로 버전이 제거될 수 있습니다. 사용하는 아티팩트를 자신의 계정에 저장하는 것이 좋습니다. 로컬 버전은 내부 아키텍처에서 참조용으로 사용해야 합니다.