So verwendet Image Builder die AWS Task Orchestrator and Executor Anwendung zur Verwaltung von Komponenten

run

Verwenden Sie den run Befehl, um die YAML Dokumentskripts für ein oder mehrere Komponentendokumente auszuführen.

validieren

Führen Sie den validate Befehl aus, um die YAML Dokumentsyntax für ein oder mehrere Komponentendokumente zu überprüfen.

Parameter

--config . /config-beispiel.json

Kurzform: -c . /config-beispiel.json

Die Konfigurationsdatei (bedingt). Dieser Parameter enthält den Dateispeicherort für die JSON Datei, die die Konfigurationseinstellungen für die Komponenten enthält, die dieser Befehl ausführt. Wenn Sie run Befehlseinstellungen in einer Konfigurationsdatei angeben, dürfen Sie den --documents Parameter nicht angeben. Weitere Hinweise zur Eingabekonfiguration finden Sie unterEingabe für den Befehl AWSTOE run konfigurieren.

Zu den gültigen Standorten gehören:

• Ein lokaler Dateipfad (. /config-beispiel.json)

• Ein S3 () URI s3://bucket/key

--cw-ignore-failures

Kurzform: N/A

Ignorieren Sie Fehler bei der Protokollierung in den CloudWatch Protokollen.

--cw-log-group

Kurzform: N/A

Der LogGroup Name für die CloudWatch Logs.

--cw-log-region

Kurzform: N/A

Die AWS Region, die für die CloudWatch Logs gilt.

--cw-log-stream

Kurzform: N/A

Der LogStream Name für die CloudWatch Logs, der angibt, AWSTOE wohin die console.log Datei gestreamt werden soll.

--document-s3-bucket-owner

Kurzform: N/A

Die Konto-ID des Bucket-Besitzers für URI S3-basierte Dokumente.

--Dokumente . /doc-1.yaml,. /doc-n.yaml

Kurzform: -d . /doc-1.yaml,. /doc-n

Die Komponentendokumente (bedingt). Dieser Parameter enthält eine durch Kommas getrennte Liste von Dateispeicherorten, an denen die YAML Komponentendokumente ausgeführt werden sollen. Wenn Sie YAML Dokumente für den run Befehl mithilfe des --documents Parameters angeben, dürfen Sie den --config Parameter nicht angeben.

Zu den gültigen Speicherorten gehören:

• lokale Dateipfade (./component-doc-example.yaml).

• S3 URIs (s3://bucket/key).

• Build-Version der Image Builder-Komponente ARNs (arn:aws:imagebuilder:us-west-2:123456789012w/my-example-component/2021.12.02/1).

Anmerkung

Es gibt keine Leerzeichen zwischen den Elementen in der Liste, nur Kommas.

--execution-id

Kurzform: -i

Dies ist die eindeutige ID, die für die Ausführung des aktuellen run Befehls gilt. Diese ID ist in den Namen der Ausgabe- und Protokolldateien enthalten, um diese Dateien eindeutig zu identifizieren und sie mit der aktuellen Befehlsausführung zu verknüpfen. Wenn diese Einstellung weggelassen wird, AWSTOE generiert eineGUID.

--log-Verzeichnis

Kurzform: -l

Das Zielverzeichnis, in dem alle Protokolldateien dieser Befehlsausführung AWSTOE gespeichert werden. Standardmäßig befindet sich dieses Verzeichnis im folgenden übergeordneten Verzeichnis:TOE_<DATETIME>_<EXECUTIONID>. Wenn Sie das Protokollverzeichnis nicht angeben, AWSTOE wird das aktuelle Arbeitsverzeichnis (.) verwendet.

--log-s3-Bucket-Name

Kurzform: -b

Wenn Komponentenprotokolle in Amazon S3 gespeichert sind (empfohlen), werden die Komponentenanwendungsprotokolle in den in diesem Parameter genannten S3-Bucket AWSTOE hochgeladen.

--log-s3-bucket-owner

Kurzform: N/A

Wenn Komponentenprotokolle in Amazon S3 gespeichert werden (empfohlen), ist dies die Eigentümerkonto-ID für den Bucket, in den die Protokolldateien AWSTOE geschrieben werden.

--log-s3-Schlüsselpräfix

Kurzform: -k

Wenn Komponentenprotokolle in Amazon S3 gespeichert werden (empfohlen), ist dies das S3-Objektschlüsselpräfix für den Protokollspeicherort im Bucket.

--parameters name1=value1,name2=value2...

Kurzform: N/A

Parameter sind veränderbare Variablen, die im Komponentendokument definiert sind und deren Einstellungen die aufrufende Anwendung zur Laufzeit bereitstellen kann.

--phasen

Kurzform: -p

Eine durch Kommas getrennte Liste, die angibt, welche Phasen von den Komponentendokumenten aus ausgeführt werden sollen. YAML Wenn ein Komponentendokument zusätzliche Phasen enthält, werden diese nicht ausgeführt.

--state-directory

Kurzform: -s

Der Dateipfad, in dem State-Tracking-Dateien gespeichert werden.

--version

Kurzform: -v

Gibt die Version der Komponentenanwendung an.

Optionen

-h

Kurzform: -h

Zeigt ein Hilfehandbuch zur Verwendung der Anwendungsoptionen für die Komponentenverwaltung an.

--trace

Kurzform: -t

Aktiviert die ausführliche Protokollierung auf der Konsole.

Parameter

--document-s3-bucket-owner

Kurzform: N/A

Quellkonto-ID der bereitgestellten URI S3-basierten Dokumente.

--Dokumente . /doc-1.yaml,. /doc-n.yaml

Kurzform: -d . /doc-1.yaml,. /doc-n

Die Komponentendokumente (erforderlich). Dieser Parameter enthält eine durch Kommas getrennte Liste von Dateispeicherorten, an denen die YAML Komponentendokumente ausgeführt werden sollen. Zu den gültigen Speicherorten gehören:

• lokale Dateipfade (./component-doc-example.yaml)

• S3 URIs (s3://bucket/key)

• Build-Version der Image Builder-Komponente ARNs (arn:aws:imagebuilder:us-west-2:123456789012w/my-example-component/2021.12.02/1)

Anmerkung

Zwischen den Einträgen in der Liste gibt es keine Leerzeichen, nur Kommas.

Optionen

-h

Kurzform: -h

Zeigt ein Hilfehandbuch zur Verwendung der Anwendungsoptionen für die Komponentenverwaltung an.

--trace

Kurzform: -t

Aktiviert die ausführliche Protokollierung auf der Konsole.