Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Créez une AWS ParallelCluster image personnalisée dans la région spécifiée.

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

## Arguments nommés
<a name="pcluster-v3.build-image.namedargs"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster build-image`.

**--image-configuration, -c *IMAGE\$1CONFIGURATION***  
Spécifie le fichier de configuration de l'image sous forme de document YAML.

**--image-id, -i *IMAGE\$1ID***  
Spécifie l'identifiant de l'image qui sera créée.

**--debug**  
Activation de la journalisation du débogage

**--dryrun *DRYRUN***  
Lorsque`true`, la commande effectue la validation sans créer de ressources. Vous pouvez l'utiliser pour valider la configuration de l'image. (La valeur par défaut est`false`.)

**--query *QUERY***  
JMESPath requête à exécuter en sortie.

**--region, -r *REGION***  
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide du paramètre [Région](image-builder-configuration-file-v3.md#yaml-build-image-Region) du fichier de configuration de l'image, de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.

**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***  
Quand`true`, lance automatiquement une restauration de la pile d'images en cas d'échec. (La valeur par défaut est`false`.)

**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**  
Identifie un ou plusieurs validateurs de configuration à supprimer.  
Format : (`ALL`\$1`type:[A-Za-z0-9]+`)

**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**  
Spécifie le niveau de validation minimal qui entraînera l'échec de la création. (La valeur par défaut est`ERROR`.)

**Exemple utilisant AWS ParallelCluster la version 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"
  }
}
```

**Avertissement**  
`pcluster build-image`utilise le VPC par défaut. Si le VPC par défaut a été supprimé, par exemple en utilisant AWS Control Tower ou AWS Landing Zone, l'ID du sous-réseau doit être spécifié dans le fichier de configuration de l'image. Pour de plus amples informations, veuillez consulter [SubnetId](HeadNode-v3.md#yaml-HeadNode-Networking-SubnetId).