Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Buat AWS ParallelCluster gambar kustom di Wilayah yang ditentukan.

```
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}]
```

## Argumen bernama
<a name="pcluster-v3.build-image.namedargs"></a>

**-h, --help**  
Menampilkan teks bantuan untuk`pcluster build-image`.

**--image-configuration, -c *IMAGE\$1CONFIGURATION***  
Menentukan file konfigurasi gambar sebagai dokumen YAMG.

**--image-id, -i *IMAGE\$1ID***  
Menentukan id dari gambar yang akan dibangun.

**--debug**  
Aktifkan logging debug.

**--dryrun *DRYRUN***  
Kapan`true`, perintah melakukan validasi tanpa membuat sumber daya apa pun. Anda dapat menggunakan ini untuk memvalidasi konfigurasi gambar. (Default ke.) `false`

**--query *QUERY***  
JMESPath query untuk dilakukan pada output.

**--region, -r *REGION***  
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan pengaturan [Wilayah](image-builder-configuration-file-v3.md#yaml-build-image-Region) dalam file konfigurasi gambar, variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.

**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***  
Kapan`true`, secara otomatis memulai rollback tumpukan gambar pada kegagalan. (Default ke.) `false`

**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**  
Mengidentifikasi satu atau lebih validator konfigurasi untuk ditekan.  
Format: (`ALL`\$1`type:[A-Za-z0-9]+`)

**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**  
Menentukan tingkat validasi minimum yang akan menyebabkan penciptaan gagal. (Default ke.) `ERROR`

**Contoh menggunakan AWS ParallelCluster versi 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"
  }
}
```

**Awas**  
`pcluster build-image`menggunakan VPC default. Jika VPC default telah dihapus, mungkin dengan menggunakan AWS Control Tower atau AWS Landing Zone, maka ID subnet harus ditentukan dalam file konfigurasi gambar. Untuk informasi selengkapnya, lihat [SubnetId](HeadNode-v3.md#yaml-HeadNode-Networking-SubnetId).