기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Image Builder를 사용하여 사용자 지정 이미지 생성
Image Builder 이미지를 새로 생성하는 데는 몇 가지 방법이 있습니다. 예를 들어 다음 방법 중 하나를 사용하여 AWS Management Console 또는를 사용하여 이미지를 생성할 수 있습니다 AWS CLI. [CreateImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html) API 작업을 사용하거나 빌드 파이프라인을 실행하여 이미지를 생성할 수도 있습니다. API 작업과 관련된 SDK 요청의 경우, *EC2 Image Builder API 참조*에서 해당 명령에 대한 [관련 참고 항목](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html#API_CreateImage_SeeAlso) 링크를 참조할 수도 있습니다.
------
#### [ AWS Management Console ]
기존 파이프라인에서 새 이미지를 생성하려면 다음과 같이 파이프라인을 수동으로 실행합니다. 또는 파이프라인 마법사를 사용하여 새 이미지를 처음부터 생성할 수도 있습니다. 생성할 이미지 유형에 따라 [파이프라인 마법사: AMI 생성](start-build-image-pipeline.md) 또는 [파이프라인 마법사: 컨테이너 이미지 생성](start-build-container-pipeline.md) 섹션을 참조하세요.
1. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)에서 EC2 Image Builder 콘솔을 엽니다.
1. 탐색 창에서 **이미지 파이프라인**을 선택합니다.
1. 실행할 **파이프라인 이름** 옆의 확인란을 선택합니다.
1. 이미지를 생성하려면 **작업** 메뉴에서 **파이프라인 실행**을 선택합니다. 이 작업은 파이프라인을 가동합니다.
또한 파이프라인 실행 일정을 지정하거나 Amazon EventBridge를 사용하여 구성한 규칙에 따라 파이프라인을 실행할 수 있습니다.
------
#### [ AWS CLI ]
에서 **[create-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html)** 명령을 실행하기 전에 리소스가 아직 없는 경우 다음 리소스를 생성해야 AWS CLI합니다.
**필수 리소스**
+ **레시피** - 다음과 같이 이미지에 대해 정확히 하나의 레시피를 지정해야 합니다.
이미지 레시피
`--image-recipe-arn` 파라미터를 사용하여 이미지 레시피 리소스에 대한 Amazon 리소스 이름(ARN)을 지정합니다.
컨테이너 레시피
`--container-recipe-arn` 파라미터를 사용하여 컨테이너 레시피 리소스의 ARN을 지정합니다.
+ **인프라 구성** - `--infrastructure-configuration-arn` 파라미터를 사용하여 인프라 구성 리소스의 ARN을 지정합니다.
이미지에 필요한 다음 리소스를 지정할 수도 있습니다.
**선택적 리소스 및 구성**
+ **배포 구성** - 기본적으로 Image Builder는 **create-image** 명령을 실행하는 리전의 계정에 출력 이미지 리소스를 배포합니다. 배포에 추가 대상 또는 구성을 제공하려면 `--distribution-configuration-arn` 파라미터를 사용하여 배포 구성 리소스의 ARN을 지정하세요.
+ **이미지 스캔**-이미지 또는 컨테이너 테스트 인스턴스에서 Amazon Inspector 결과에 대한 스냅샷을 구성하려면 `--image-scanning-configuration` 파라미터를 사용합니다. 컨테이너 이미지의 경우 Amazon Inspector에서 스캔에 사용하는 ECR 리포지토리도 지정합니다.
+ **이미지 테스트** - 이미지 빌더 테스트 단계를 억제하려면, `--image-tests-configuration` 파라미터를 사용합니다. 또는 실행 시간에 대한 제한 시간을 설정할 수 있습니다.
+ **이미지 태그** - `--tags` 파라미터를 사용하여 출력 이미지 리소스에 태그를 추가합니다.
+ **이미지 워크플로**-빌드 또는 테스트 워크플로를 지정하지 않는 경우 Image Builder는 기본 이미지 워크플로를 사용하여 이미지를 만듭니다. 생성한 워크플로를 지정하려면 `--workflows` 파라미터를 사용합니다.
**참고**
이미지 워크플로를 지정하는 경우 Image Builder가 워크플로 작업을 실행하는 데 사용하는 IAM 역할의 이름 또는 ARN도 `--execution-role` 파라미터에 제공해야 합니다.
다음 예에서는 [create-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html) AWS CLI 명령을 사용하여 이미지를 생성하는 방법을 보여줍니다. 자세한 내용은 *AWS CLI 명령 참조*를 참조하세요.
**예: 디폴트 분포를 사용하여 기본 이미지 만들기**
```
aws imagebuilder create-image --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/simple-recipe-linux/1.0.0 --infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/simple-infra-config-linux
```
**출력:**
```
{
"requestId": "1abcd234-e567-8fa9-0123-4567b890cd12",
"imageVersionList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/simple-recipe-linux/1.0.0",
"name": "simple-recipe-linux",
...
}
]
}
```
------
## 에서 이미지 생성 취소 AWS CLI
진행 중인 이미지 빌드를 취소하려면 다음과 같이 **cancel-image-creation** 명령을 사용합니다.
```
aws imagebuilder cancel-image-creation --image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-recipe/2019.12.03/1
```