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

# `pcluster build-image`
<a name="pcluster.build-image-v3"></a>

지정된 리전에서 사용자 지정 AWS ParallelCluster 이미지를 생성합니다.

```
pcluster build-image [-h]
                 --image-configuration IMAGE_CONFIGURATION 
                 --image-id IMAGE_ID
                [--debug]
                [--dryrun DRYRUN]
                [--query QUERY]
                [--region REGION]
                [--rollback-on-failure ROLLBACK_ON_FAILURE]
                [--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]]
                [--validation-failure-level {INFO,WARNING,ERROR}]
```

## 이름 지정된 인수
<a name="pcluster-v3.build-image.namedargs"></a>

**-h, --help**  
`pcluster build-image`에 대한 도움말 텍스트를 표시합니다.

**--image-configuration, -c *IMAGE\$1CONFIGURATION***  
이미지 구성 파일을 YAML 문서로 지정합니다.

**--image-id, -i *IMAGE\$1ID***  
빌드될 이미지의 ID를 지정합니다.

**--debug**  
디버깅 로깅을 활성화합니다.

**--dryrun *DRYRUN***  
`true`면 명령이 리소스를 만들지 않고 유효성 검사를 수행합니다. 이를 사용하여 이미지 구성을 검증할 수 있습니다. (`false`로 디폴트됩니다.)

**--query *QUERY***  
출력에서 수행할 JMESPath 쿼리입니다.

**--region, -r *REGION***  
사용할 AWS 리전 를 지정합니다. 이미지 구성 파일의 [리전](image-builder-configuration-file-v3.md#yaml-build-image-Region) 설정, `AWS_DEFAULT_REGION` 환경 변수, 파일 `[default]` 섹션의 `region` 설정 `~/.aws/config` 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.

**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***  
`true`인 경우 실패 시 이미지 스택 롤백이 자동으로 시작됩니다. (기본값은 `false`입니다.)

**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**  
억제할 구성 유효성 검사기를 하나 이상 식별하세요.  
형식: (`ALL`\$1`type:[A-Za-z0-9]+`)

**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**  
생성 실패의 원인이 되는 최소 유효성 검사 수준을 지정합니다. (`ERROR`로 디폴트됩니다.)

** AWS ParallelCluster 버전 3.1.2 사용 예제:**

```
$ pcluster build-image --image-configuration image-config.yaml --image-id custom-alinux2-image
{
  "image": {
    "imageId": "custom-alinux2-image",
    "imageBuildStatus": "BUILD_IN_PROGRESS",
    "cloudformationStackStatus": "CREATE_IN_PROGRESS",
    "cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/custom-alinux2-image/1234abcd-56ef-78gh-90ij-abcd1234efgh",
    "region": "us-east-1",
    "version": "3.1.2"
  }
}
```

**주의**  
`pcluster build-image`는 기본 VPC를 사용합니다. AWS Control Tower 또는 AWS 랜딩 영역을 사용하여 기본 VPC를 삭제한 경우 이미지 구성 파일에 서브넷 ID를 지정해야 합니다. 자세한 내용은 [SubNetID](HeadNode-v3.md#yaml-HeadNode-Networking-SubnetId)를 참조하세요.