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.
Buildspec-Referenz für Batch-Builds
Dieses Thema enthält die Buildspec-Referenz für Batch-Build-Eigenschaften.
Batch
Optionale Zuweisung. Die Batch-Build-Einstellungen für das Projekt.
- Batch/Fast-Fail
-
Optional. Gibt das Verhalten der Batch-Erstellung an, wenn eine oder mehrere Build-Aufgaben fehlschlagen.
false-
Der Standardwert. Alle laufenden Builds werden abgeschlossen.
true-
Alle laufenden Builds werden gestoppt, wenn eine der Build-Aufgaben fehlschlägt.
Standardmäßig werden alle Batch-Build-Aufgaben mit den Build-Einstellungen wie env und ausgeführtphases, die in der Buildspec-Datei angegeben sind. Sie können die Standard-Build-Einstellungen überschreiben, indem Sie im Parameter andere env Werte oder eine andere Buildspec-Datei angeben. batch/<batch-type>/buildspec
Der Inhalt der batch Eigenschaft variiert je nach Art des angegebenen Batch-Builds. Die möglichen Batch-Build-Typen sind:
batch/build-Diagramm
Definiert ein Build-Diagramm. Ein Build-Diagramm definiert eine Reihe von Aufgaben, die von anderen Aufgaben im Batch abhängig sind. Weitere Informationen finden Sie unter Diagramm erstellen.
Dieses Element enthält eine Reihe von Build-Aufgaben. Jede Build-Aufgabe enthält die folgenden Eigenschaften.
- Bezeichner
-
Erforderlich Der Bezeichner der Aufgabe.
- buildspec
Optional. Der Pfad und der Dateiname der Buildspec-Datei, die für diese Aufgabe verwendet werden soll. Wenn dieser Parameter nicht angegeben ist, wird die aktuelle Buildspec-Datei verwendet.
- Debug-Sitzung
-
Optional. Ein boolescher Wert, der angibt, ob das Sitzungsdebugging für diesen Batch-Build aktiviert ist. Weitere Hinweise zum Sitzungsdebuggen finden Sie unter. Builds mit Session Manager debuggen
false-
Das Sitzungsdebugging ist deaktiviert.
true-
Das Sitzungsdebugging ist aktiviert.
- hängt davon ab
-
Optional. Eine Reihe von Task-Identifikatoren, von denen diese Aufgabe abhängt. Diese Aufgabe wird erst ausgeführt, wenn diese Aufgaben abgeschlossen sind.
- env
-
Optional. Die Build-Umgebung überschreibt die Aufgabe. Dies kann die folgenden Eigenschaften enthalten:
- Typ berechnen
-
Der Bezeichner des Berechnungstyps, der für die Aufgabe verwendet werden soll. Mögliche Werte finden Sie unter ComputeType inBerechnungsmodi und -typen für die Build-Umgebung.
- Flotte
-
Die Kennung der Flotte, die für die Aufgabe verwendet werden soll. Weitere Informationen finden Sie unter Führen Sie Builds auf Flotten mit reservierter Kapazität aus.
- Abbild
-
Die Kennung des Bilds, das für die Aufgabe verwendet werden soll. Mögliche Werte finden Sie unter Bildbezeichner unter. Docker-Images bereitgestellt von CodeBuild
- privilegierter Modus
-
Ein boolescher Wert, der angibt, ob der Docker-Daemon in einem Docker-Container ausgeführt werden soll.
trueNur auf gesetzt, wenn das Build-Projekt zum Erstellen von Docker-Images verwendet wird. Andernfalls schlägt ein Build fehl, der versucht, mit dem Docker-Daemon zu interagieren. Die Standardeinstellung lautetfalse. - Typ
-
Der Bezeichner des Umgebungstyps, der für die Aufgabe verwendet werden soll. Mögliche Werte finden Sie unter Berechnungsmodi und -typen für die Build-Umgebung Umgebungseingabe.
- Variablen
-
Die Umgebungsvariablen, die in der Build-Umgebung vorhanden sein werden. Weitere Informationen finden Sie unter env/variables.
Anmerkung
Beachten Sie, dass Rechnertyp und Flotte nicht in derselben ID eines einzelnen Builds angegeben werden können.
- Fehler ignorieren
-
Optional. Ein boolescher Wert, der angibt, ob ein Fehler dieser Build-Aufgabe ignoriert werden kann.
false-
Der Standardwert. Wenn diese Build-Aufgabe fehlschlägt, schlägt die Batch-Erstellung fehl.
true-
Wenn diese Build-Aufgabe fehlschlägt, kann der Batch-Build trotzdem erfolgreich sein.
Das Folgende ist ein Beispiel für einen Buildspec-Eintrag in einem Build-Graph:
batch: fast-fail: false build-graph: - identifier: build1 env: variables: BUILD_ID: build1 ignore-failure: false - identifier: build2 buildspec: build2.yml env: variables: BUILD_ID: build2 depend-on: - build1 - identifier: build3 env: variables: BUILD_ID: build3 depend-on: - build2 - identifier: build4 env: compute-type: ARM_LAMBDA_1GB - identifier: build5 env: fleet: fleet_name
batch/build-Liste
Definiert eine Build-Liste. Eine Build-Liste wird verwendet, um eine Reihe von Aufgaben zu definieren, die parallel ausgeführt werden. Weitere Informationen finden Sie unter Liste erstellen.
Dieses Element enthält eine Reihe von Build-Aufgaben. Jede Build-Aufgabe enthält die folgenden Eigenschaften.
- Bezeichner
-
Erforderlich Der Bezeichner der Aufgabe.
- buildspec
Optional. Der Pfad und der Dateiname der Buildspec-Datei, die für diese Aufgabe verwendet werden soll. Wenn dieser Parameter nicht angegeben ist, wird die aktuelle Buildspec-Datei verwendet.
- Debug-Sitzung
-
Optional. Ein boolescher Wert, der angibt, ob das Sitzungsdebugging für diesen Batch-Build aktiviert ist. Weitere Hinweise zum Sitzungsdebuggen finden Sie unter. Builds mit Session Manager debuggen
false-
Das Sitzungsdebugging ist deaktiviert.
true-
Das Sitzungsdebugging ist aktiviert.
- env
-
Optional. Die Build-Umgebung überschreibt die Aufgabe. Dies kann die folgenden Eigenschaften enthalten:
- Typ berechnen
-
Der Bezeichner des Berechnungstyps, der für die Aufgabe verwendet werden soll. Mögliche Werte finden Sie unter ComputeType inBerechnungsmodi und -typen für die Build-Umgebung.
- Flotte
-
Die Kennung der Flotte, die für die Aufgabe verwendet werden soll. Weitere Informationen finden Sie unter Führen Sie Builds auf Flotten mit reservierter Kapazität aus.
- Abbild
-
Die Kennung des Bilds, das für die Aufgabe verwendet werden soll. Mögliche Werte finden Sie unter Bildbezeichner unter. Docker-Images bereitgestellt von CodeBuild
- privilegierter Modus
-
Ein boolescher Wert, der angibt, ob der Docker-Daemon in einem Docker-Container ausgeführt werden soll.
trueNur auf gesetzt, wenn das Build-Projekt zum Erstellen von Docker-Images verwendet wird. Andernfalls schlägt ein Build fehl, der versucht, mit dem Docker-Daemon zu interagieren. Die Standardeinstellung lautetfalse. - Typ
-
Der Bezeichner des Umgebungstyps, der für die Aufgabe verwendet werden soll. Mögliche Werte finden Sie unter Berechnungsmodi und -typen für die Build-Umgebung Umgebungseingabe.
- Variablen
-
Die Umgebungsvariablen, die in der Build-Umgebung vorhanden sein werden. Weitere Informationen finden Sie unter env/variables.
Anmerkung
Beachten Sie, dass Rechnertyp und Flotte nicht in derselben ID eines einzelnen Builds angegeben werden können.
- Fehler ignorieren
-
Optional. Ein boolescher Wert, der angibt, ob ein Fehler dieser Build-Aufgabe ignoriert werden kann.
false-
Der Standardwert. Wenn diese Build-Aufgabe fehlschlägt, schlägt die Batch-Erstellung fehl.
true-
Wenn diese Build-Aufgabe fehlschlägt, kann der Batch-Build trotzdem erfolgreich sein.
Das Folgende ist ein Beispiel für einen Buildspec-Eintrag in der Build-Liste:
batch: fast-fail: false build-list: - identifier: build1 env: variables: BUILD_ID: build1 ignore-failure: false - identifier: build2 buildspec: build2.yml env: variables: BUILD_ID: build2 ignore-failure: true - identifier: build3 env: compute-type: ARM_LAMBDA_1GB - identifier: build4 env: fleet: fleet_name - identifier: build5 env: compute-type: GENERAL_LINUX_XLAGRE
batch/build-Matrix
Definiert eine Build-Matrix. Eine Buildmatrix definiert Aufgaben mit unterschiedlichen Konfigurationen, die parallel ausgeführt werden. CodeBuild erstellt einen separaten Build für jede mögliche Konfigurationskombination. Weitere Informationen finden Sie unter Matrix erstellen.
- statisch
-
Die statischen Eigenschaften gelten für alle Build-Aufgaben.
- Fehler ignorieren
-
Optional. Ein boolescher Wert, der angibt, ob ein Fehler dieser Build-Aufgabe ignoriert werden kann.
false-
Der Standardwert. Wenn diese Build-Aufgabe fehlschlägt, schlägt die Batch-Erstellung fehl.
true-
Wenn diese Build-Aufgabe fehlschlägt, kann der Batch-Build trotzdem erfolgreich sein.
- env
-
Optional. Die Build-Umgebung überschreibt alle Aufgaben.
- privilegierter Modus
-
Ein boolescher Wert, der angibt, ob der Docker-Daemon in einem Docker-Container ausgeführt werden soll.
trueNur auf gesetzt, wenn das Build-Projekt zum Erstellen von Docker-Images verwendet wird. Andernfalls schlägt ein Build fehl, der versucht, mit dem Docker-Daemon zu interagieren. Die Standardeinstellung lautetfalse. - Typ
-
Der Bezeichner des Umgebungstyps, der für die Aufgabe verwendet werden soll. Mögliche Werte finden Sie unter Umgebungstyp eingeben. Berechnungsmodi und -typen für die Build-Umgebung
- dynamisch
-
Die dynamischen Eigenschaften definieren die Build-Matrix.
- Buildspec
-
Optional. Ein Array, das den Pfad und die Dateinamen der Buildspec-Dateien enthält, die für diese Aufgaben verwendet werden sollen. Wenn dieser Parameter nicht angegeben ist, wird die aktuelle Buildspec-Datei verwendet.
- env
-
Optional. Die Build-Umgebung überschreibt diese Aufgaben.
- Typ berechnen
-
Ein Array, das die Identifikatoren der Berechnungstypen enthält, die für diese Aufgaben verwendet werden sollen. Mögliche Werte finden Sie unter ComputeType inBerechnungsmodi und -typen für die Build-Umgebung.
- Abbild
-
Ein Array, das die Identifikatoren der Bilder enthält, die für diese Aufgaben verwendet werden sollen. Mögliche Werte finden Sie unter Docker-Images bereitgestellt von CodeBuild Bildbezeichner unter.
- Variablen
-
Ein Array, das die Umgebungsvariablen enthält, die in den Build-Umgebungen für diese Aufgaben vorhanden sein werden. Weitere Informationen finden Sie unter env/variables.
Das Folgende ist ein Beispiel für einen Buildspec-Eintrag in der Buildmatrix:
batch: build-matrix: static: ignore-failure: false dynamic: buildspec: - matrix1.yml - matrix2.yml env: variables: MY_VAR: - VALUE1 - VALUE2 - VALUE3
Weitere Informationen finden Sie unter Matrix erstellen.
batch/build-Fanout
Definiert ein Build-Fanout. Ein Build-Fanout wird verwendet, um eine Aufgabe zu definieren, die in mehrere Builds aufgeteilt ist, die parallel ausgeführt werden. Weitere Informationen finden Sie unter Führen Sie parallele Tests in Batch-Builds aus.
Dieses Element enthält eine Build-Aufgabe, die in mehrere Builds aufgeteilt werden kann. Der build-fanout Abschnitt enthält die folgenden Eigenschaften.
- Parallelität
-
Erforderlich Die Anzahl der Builds, die Tests parallel ausführen.
- Fehler ignorieren
-
Optional. Ein boolescher Wert, der angibt, ob ein Fehler bei einer der Fanout-Build-Aufgaben ignoriert werden kann. Dieser Wert von ignore-failure wird auf alle Fanout-Builds angewendet.
- false
-
Der Standardwert. Wenn eine Fanout-Build-Aufgabe fehlschlägt, schlägt der Batch-Build fehl.
- true
-
Wenn eine Fanout-Build-Aufgabe fehlschlägt, kann der Batch-Build trotzdem erfolgreich sein.
Das Folgende ist ein Beispiel für einen Build-Fanout-Buildspec-Eintrag:
version: 0.2 batch: fast-fail: false build-fanout: parallelism: 5 ignore-failure: false phases: install: commands: - npm install build: commands: - mkdir -p test-results - cd test-results - | codebuild-tests-run \ --test-command 'npx jest --runInBand --coverage' \ --files-search "codebuild-glob-search '**/test/**/*.test.js'" \ --sharding-strategy 'equal-distribution'
Weitere Informationen erhalten Sie unter Fanout erstellen und Verwenden Sie den CLI-Befehl codebuild-tests-run.