View a markdown version of this page

pcluster build-image - AWS ParallelCluster
Benannte Argumente

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

Erstellen Sie 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

-h, --help

Zeigt den Hilfetext fürpcluster build-image.

--image-configuration, -c IMAGE_CONFIGURATION

Gibt die Image-Konfigurationsdatei als YAML-Dokument an.

--image-id, -i IMAGE_ID

Gibt die ID des Images an, das erstellt wird.

--debug

Aktivieren von Debugging-Protokollierung.

--dryrun DRYRUN

Wenntrue, 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 istfalse.)

--query QUERY

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

--region, -r REGION

Gibt die zu verwendende AWS-Region an. Der AWS-Region muss mithilfe der Region-Einstellung 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_ON_FAILURE

Wenntrue, initiiert bei einem Fehler automatisch ein Image-Stack-Rollback. (Die Standardeinstellung ist.) false

--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]

Identifiziert einen oder mehrere Konfigurationsvalidatoren, die unterdrückt werden sollen.

Format: (|) ALL type:[A-Za-z0-9]+

--validation-failure-level {INFO,WARNING,ERROR}

Gibt die Mindestvalidierungsstufe an, bei der die Erstellung fehlschlägt. (Die Standardeinstellung istERROR.)

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-imageverwendet die Standard-VPC. Wenn die Standard-VPC gelöscht wurde, vielleicht mithilfe AWS Control Tower unserer AWS Landing Zone, muss die Subnetz-ID in der Image-Konfigurationsdatei angegeben werden. Weitere Informationen finden Sie unter SubnetId.