Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Erstellt ein benutzerdefiniertes AWS ParallelCluster Bild in der angegebenen Region.

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

## Benannte Argumente
<a name="pcluster-v3.build-image.namedargs"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster build-image`.

**--image-configuration, -c *IMAGE\$1CONFIGURATION***  
Gibt die Image-Konfigurationsdatei als YAML-Dokument an.

**--image-id, -i *IMAGE\$1ID***  
Gibt die ID des Images an, das erstellt wird.

**--debug**  
Aktivieren von Debugging-Protokollierung.

**--dryrun *DRYRUN***  
Wenn`true`, führt der Befehl eine Validierung durch, ohne Ressourcen zu erstellen. Sie können dies verwenden, um die Image-Konfiguration zu überprüfen. (Die Standardeinstellung ist`false`.)

**--query *QUERY***  
JMESPath Abfrage, die bei der Ausgabe ausgeführt werden soll.

**--region, -r *REGION***  
Gibt die AWS-Region zu verwendende an. Das AWS-Region muss mithilfe der [Region-Einstellung](image-builder-configuration-file-v3.md#yaml-build-image-Region) in der Image-Konfigurationsdatei, der `AWS_DEFAULT_REGION` Umgebungsvariablen, der `region` Einstellung im `[default]` Abschnitt der `~/.aws/config` Datei oder des `--region` Parameters angegeben werden.

**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***  
Wenn`true`, leitet bei einem Fehler automatisch ein Rollback des Image-Stacks ein. (Die Standardeinstellung ist.) `false`

**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**  
Identifiziert einen oder mehrere Konfigurationsprüfer, die unterdrückt werden sollen.  
Format: (\$1) `ALL` `type:[A-Za-z0-9]+`

**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**  
Gibt die Mindestvalidierungsstufe an, die dazu führen wird, dass die Erstellung fehlschlägt. (Die Standardeinstellung ist`ERROR`.)

**Beispiel mit AWS ParallelCluster 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"
  }
}
```

**Warnung**  
`pcluster build-image`verwendet die Standard-VPC. Wenn die Standard-VPC gelöscht wurde, möglicherweise mithilfe von AWS Control Tower oder AWS Landing Zone, muss die Subnetz-ID in der Image-Konfigurationsdatei angegeben werden. Weitere Informationen finden Sie unter [SubnetId](HeadNode-v3.md#yaml-HeadNode-Networking-SubnetId).