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

# `gambar build pcluster`
<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\_CONFIGURATION}}**  
Menentukan file konfigurasi gambar sebagai dokumen YAMG.

**--image-id, -i {{IMAGE\_ID}}**  
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 melakukan 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\_ON\_FAILURE}}**  
Kapan`true`, secara otomatis memulai rollback tumpukan gambar pada kegagalan. (Default ke.) `false`

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

**--validation-failure-level {`INFO`,`WARNING`,`ERROR`}**  
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).