기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS ParallelCluster AMI 사용자 지정
에 대한 사용자 지정 AMI를 빌드해야 하는 시나리오 AWS ParallelCluster 가 있습니다. 이 섹션에서는 사용자 지정 AWS ParallelCluster AMI를 빌드할 때 고려해야 할 사항을 다룹니다.
다음 방법 중 하나를 사용하여 사용자 지정 AWS ParallelCluster AMI를 빌드할 수 있습니다.
1. [빌드 이미지 구성 파일](image-builder-configuration-file-v3.md)을 생성한 다음 `pcluster` CLI를 사용하여 EC2 Image Builder로 이미지를 빌드합니다. 이 프로세스는 자동화되고 반복 가능하며 모니터링을 지원합니다. 자세한 내용은 [`pcluster`](pcluster-v3.md) 이미지 명령을 참조하세요.
1. AWS ParallelCluster AMI에서 인스턴스를 생성한 다음 인스턴스에 로그인하여 수동으로 수정합니다. 마지막으로 Amazon EC2를 사용하여 수정된 인스턴스로부터 새 AMI를 생성합니다. 이 프로세스에는 시간이 덜 걸립니다. 하지만 자동화나 반복이 불가능하며 `pcluster` CLI 이미지 모니터링 명령 사용을 지원하지 않습니다.
이 방법들에 대한 자세한 내용은 [사용자 지정 AWS ParallelCluster AMI 빌드](building-custom-ami-v3.md) 섹션을 참조하세요.
## AWS ParallelCluster AMI 사용자 지정 고려 사항
사용자 지정 이미지를 생성하는 방법에 관계없이 예비 검증 테스트를 수행하고 생성 중인 이미지의 상태를 모니터링하기 위한 조항을 포함하는 것이 좋습니다.
`pcluster`를 사용하여 사용자 지정 AMI를 구축하려면 [EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/what-is-image-builder.html)에서 사용자 지정 이미지를 구축하는 데 사용하는 [`Build`](Build-v3.md) 및 [`Image`](Image-v3.md#Image-v3.properties) 섹션이 포함된 [빌드 이미지 구성 파일](image-builder-configuration-file-v3.md)을 생성합니다. `Build` 섹션에서는 Image Builder에서 이미지를 빌드하는 데 필요한 사항을 지정합니다. 여기에는 [`ParentImage`](Build-v3.md#yaml-build-image-Build-ParentImage)(기본 이미지), 및 [`Components`](Build-v3.md#Build-v3-Components)가 포함됩니다. [Image Builder 구성 요소](https://docs.aws.amazon.com/imagebuilder/latest/userguide/toe-component-manager.html)는 이미지를 생성하기 전에 인스턴스를 사용자 지정하거나 생성된 이미지로 시작된 인스턴스를 테스트하는 데 필요한 일련의 단계를 정의합니다. 자세한 내용은 *EC2 * [Image Builder 사용 설명서의 Image Builder를 사용하여 사용자 지정 구성 요소 생성을](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-component.html) 참조하세요.
pcluster에서 호출[`build-image`](pcluster.build-image-v3.md)하여 사용자 지정 이미지를 생성하면 Image Builder는 AWS ParallelCluster 쿡북과 함께 빌드 이미지 구성을 사용하여 AWS ParallelCluster 에서 부트스트랩합니다[`ParentImage`](Build-v3.md#yaml-build-image-Build-ParentImage). Image Builder는 구성 요소를 다운로드하고, 빌드 및 검증 단계를 실행하고, AMI를 생성하고, AMI에서 인스턴스를 시작하고, 테스트를 실행합니다. 프로세스가 완료되면 Image Builder는 새 이미지나 중지 메시지를 생성합니다.
## 사용자 지정 구성 요소 검증 테스트 수행
Image Builder 구성 요소를 구성에 포함하기 전에 다음 방법 중 하나를 사용하여 구성 요소를 테스트하고 검증하세요. Image Builder 프로세스에는 최대 1시간이 걸릴 수 있으므로 구성 요소를 미리 테스트하는 것이 좋습니다. 이렇게 하면 시간을 크게 절약할 수 있습니다.
스크립트 케이스****
빌드 이미지 프로세스 외부에서 실행 중인 인스턴스에서 스크립트를 테스트하고 스크립트가 종료 코드 0으로 종료되는지 확인합니다.
Amazon 리소스 이름(ARN) 케이스****
빌드 이미지 프로세스 외부에서 실행 중인 인스턴스에서 구성 요소 문서를 테스트합니다. 요구 사항 목록은 Image Builder 사용 설명서**의 [구성 요소 관리자](https://docs.aws.amazon.com/imagebuilder/latest/userguide/toe-component-manager.html)를 참조하세요.
검증에 성공하면 구성 요소를 빌드 이미지 구성에 추가합니다.****
사용자 지정 구성 요소가 작동하는지 확인한 후 해당 구성 요소를 [빌드 이미지 구성 파일](image-builder-configuration-file-v3.md)에 추가합니다.
## 디버깅을 지원하는 `pcluster` 명령을 사용하여 Image Builder 프로세스를 모니터링합니다.
[`describe-image`](pcluster.describe-image-v3.md)
이 명령을 사용하여 빌드 이미지 상태를 모니터링할 수 있습니다.
[`list-image-log-streams`](pcluster.list-image-log-streams-v3.md)
이 명령을 사용하면 [`get-image-log-events`](pcluster.get-image-log-events-v3.md)로 로그 이벤트를 검색하는 데 사용할 수 있는 로그 스트림의 ID를 가져올 수 있습니다.
[`get-image-log-events`](pcluster.get-image-log-events-v3.md)
이 명령을 사용하면 빌드 이미지 프로세스 이벤트의 로그 스트림을 가져올 수 있습니다.
예를 들어 다음 명령을 사용하여 이미지 빌드 이벤트를 중단할 수 있습니다.
```
$ watch -n 1 'pcluster get-image-log-events -i {{}} \
--log-stream-name/1 {{}} \
--query "events[*].message" | tail -n 50'
```
[`get-image-stack-events`](pcluster.get-image-stack-events-v3.md)
이 명령을 사용하면 Image Builder가 생성하는 스택에 대한 이미지 스택 이벤트를 검색할 수 있습니다.
[`export-image-logs`](pcluster.export-image-logs-v3.md)
이 명령을 사용하면 이미지 로그를 저장할 수 있습니다.
AWS ParallelCluster 로그 및 Amazon CloudWatch에 대한 자세한 내용은 [Amazon CloudWatch Logs 빌드 이미지 로그](cloudwatch-logs-v3.md#cloudwatch-logs-build-images) 및 섹션을 참조하세요[Amazon CloudWatch 대시보드](cloudwatch-dashboard-v3.md).
## 기타 고려 사항
**새 AWS ParallelCluster 릴리스 및 사용자 지정 AMIs**
사용자 지정 AMI를 빌드하고 사용한다면, 새로운 각 AWS ParallelCluster 릴리스에서 사용자 지정 AMI를 생성하는 데 사용된 단계를 반복해야 합니다.
사용자 지정 부트스트랩 작업****
[사용자 지정 부트스트랩 작업](custom-bootstrap-actions-v3.md) 섹션을 검토하여 수정하려는 내용을 향후 AWS ParallelCluster 릴리스에서 스크립팅하고 지원할 수 있는지 확인합니다.
사용자 지정 AMI 사용****
[`Image`](Image-v3.md)/[`CustomAmi`](Image-v3.md#yaml-Image-CustomAmi) 및 [`Scheduling`](Scheduling-v3.md)/[`SlurmQueues`](Scheduling-v3.md#Scheduling-v3-SlurmQueues)/ - [`Name`](Scheduling-v3.md#yaml-Scheduling-SlurmQueues-Name)/[`Image`](Scheduling-v3.md#Scheduling-v3-SlurmQueues-Image)/[`CustomAmi`](Scheduling-v3.md#yaml-Scheduling-SlurmQueues-Image-CustomAmi) 섹션의 클러스터 구성에서 사용자 지정 AMI를 지정할 수 있습니다.
사용자 지정 AMI 검증 경고 문제를 해결하려면 [사용자 지정 AMI 문제 해결](troubleshooting-v3-custom-amis.md)을 참조하세요.