Riferimento buildspec per la compilazione in batch - AWS CodeBuild

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Riferimento buildspec per la compilazione in batch

Questo argomento contiene il riferimento buildspec per le proprietà di compilazione in batch.

batch

Mappatura opzionale. Le impostazioni di compilazione in batch per il progetto.

batch/ fast-fail

Facoltativo. Specifica il comportamento della compilazione in batch quando una o più attività di compilazione falliscono.

false

Il valore predefinito. Tutte le build in esecuzione verranno completate.

true

Tutte le build in esecuzione verranno interrotte quando una delle attività di compilazione fallisce.

Per impostazione predefinita, tutte le attività di compilazione in batch vengono eseguite con le impostazioni di compilazione come env ephases, specificate nel file buildspec. È possibile sovrascrivere le impostazioni di build predefinite specificando env valori diversi o un file buildspec diverso nel parametro. batch/<batch-type>/buildspec

Il contenuto della batch proprietà varia in base al tipo di build batch specificato. I possibili tipi di build in batch sono:

batch/build-graph

Definisce un grafico di costruzione. Un grafico di compilazione definisce un insieme di attività che dipendono da altre attività del batch. Per ulteriori informazioni, consulta Crea un grafico.

Questo elemento contiene una serie di attività di compilazione. Ogni attività di compilazione contiene le seguenti proprietà.

identificatore

Obbligatorio. L'identificatore dell'attività.

buildspec

Facoltativo. Il percorso e il nome del file buildspec da utilizzare per questa attività. Se questo parametro non è specificato, viene utilizzato il file buildspec corrente.

sessione di debug

Facoltativo. Un valore booleano che indica se il debug della sessione è abilitato per questa build in batch. Per ulteriori informazioni sul debug delle sessioni, vedere. Visualizza una build in esecuzione in Session Manager

false

Il debug della sessione è disabilitato.

true

Il debug della sessione è abilitato.

dipende da

Facoltativo. Una serie di identificatori di attività da cui dipende questa attività. Questa attività non verrà eseguita fino al completamento di tali attività.

env

Facoltativo. L'ambiente di compilazione sostituisce l'attività. Questo può contenere le seguenti proprietà:

tipo di calcolo

L'identificatore del tipo di calcolo da utilizzare per l'attività. Vedere ComputeType Modi e tipi di calcolo dell'ambiente di creazione in per i valori possibili.

flotta

L'identificatore della flotta da utilizzare per l'attività. Per ulteriori informazioni, consulta Run si basa su flotte a capacità riservata.

image

L'identificatore dell'immagine da utilizzare per l'attività. Vedi Identificatore di immagine in Immagini Docker fornite da CodeBuild per i valori possibili.

modalità privilegiata

Un valore booleano che indica se eseguire il demone Docker all'interno di un contenitore Docker. Imposta su true solo se il progetto di compilazione viene utilizzato per creare immagini Docker. In caso contrario, una build che tenta di interagire con il daemon Docker fallisce. L'impostazione predefinita è false.

tipo

L'identificatore del tipo di ambiente da utilizzare per l'attività. Vedi Environment type in Modi e tipi di calcolo dell'ambiente di creazione per i valori possibili.

variabili

Le variabili di ambiente che saranno presenti nell'ambiente di compilazione. Per ulteriori informazioni, consulta env/variables.

Nota

Tieni presente che il tipo di calcolo e il parco macchine non possono essere forniti nello stesso identificatore di una singola build.

ignore-failure

Facoltativo. Un valore booleano che indica se un errore di questa operazione di compilazione può essere ignorato.

false

Il valore predefinito. Se questa operazione di compilazione fallisce, la compilazione in batch avrà esito negativo.

true

Se questa operazione di compilazione fallisce, la compilazione in batch può comunque avere successo.

Di seguito è riportato un esempio di una voce buildspec del grafico build:

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-list

Definisce un elenco di build. Un elenco di compilazione viene utilizzato per definire una serie di attività eseguite in parallelo. Per ulteriori informazioni, consulta Crea un elenco.

Questo elemento contiene una serie di attività di compilazione. Ogni attività di compilazione contiene le seguenti proprietà.

identificatore

Obbligatorio. L'identificatore dell'attività.

buildspec

Facoltativo. Il percorso e il nome del file buildspec da utilizzare per questa attività. Se questo parametro non è specificato, viene utilizzato il file buildspec corrente.

sessione di debug

Facoltativo. Un valore booleano che indica se il debug della sessione è abilitato per questa build in batch. Per ulteriori informazioni sul debug delle sessioni, vedere. Visualizza una build in esecuzione in Session Manager

false

Il debug della sessione è disabilitato.

true

Il debug della sessione è abilitato.

env

Facoltativo. L'ambiente di compilazione sostituisce l'attività. Questo può contenere le seguenti proprietà:

tipo di calcolo

L'identificatore del tipo di calcolo da utilizzare per l'attività. Vedere ComputeType Modi e tipi di calcolo dell'ambiente di creazione in per i valori possibili.

flotta

L'identificatore della flotta da utilizzare per l'attività. Per ulteriori informazioni, consulta Run si basa su flotte a capacità riservata.

image

L'identificatore dell'immagine da utilizzare per l'attività. Vedi Identificatore di immagine in Immagini Docker fornite da CodeBuild per i valori possibili.

modalità privilegiata

Un valore booleano che indica se eseguire il demone Docker all'interno di un contenitore Docker. Imposta su true solo se il progetto di compilazione viene utilizzato per creare immagini Docker. In caso contrario, una build che tenta di interagire con il daemon Docker fallisce. L'impostazione predefinita è false.

tipo

L'identificatore del tipo di ambiente da utilizzare per l'attività. Vedi Environment type in Modi e tipi di calcolo dell'ambiente di creazione per i valori possibili.

variabili

Le variabili di ambiente che saranno presenti nell'ambiente di compilazione. Per ulteriori informazioni, consulta env/variables.

Nota

Tieni presente che il tipo di calcolo e il parco macchine non possono essere forniti nello stesso identificatore di una singola build.

ignore-failure

Facoltativo. Un valore booleano che indica se un errore di questa operazione di compilazione può essere ignorato.

false

Il valore predefinito. Se questa operazione di compilazione fallisce, la compilazione in batch avrà esito negativo.

true

Se questa operazione di compilazione fallisce, la compilazione in batch può comunque avere successo.

Di seguito è riportato un esempio di voce buildspec dell'elenco di compilazione:

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

Definisce una matrice di compilazione. Una matrice di compilazione definisce le attività con diverse configurazioni eseguite in parallelo. CodeBuild crea una build separata per ogni possibile combinazione di configurazione. Per ulteriori informazioni, consulta Costruisci una matrice.

statico

Le proprietà statiche si applicano a tutte le attività di compilazione.

ignore-failure

Facoltativo. Un valore booleano che indica se un errore di questa operazione di compilazione può essere ignorato.

false

Il valore predefinito. Se questa operazione di compilazione fallisce, la compilazione in batch avrà esito negativo.

true

Se questa operazione di compilazione fallisce, la compilazione in batch può comunque avere successo.

env

Facoltativo. L'ambiente di compilazione ha la precedenza su tutte le attività.

modalità privilegiata

Un valore booleano che indica se eseguire il demone Docker all'interno di un contenitore Docker. Imposta su true solo se il progetto di compilazione viene utilizzato per creare immagini Docker. In caso contrario, una build che tenta di interagire con il daemon Docker fallisce. L'impostazione predefinita è false.

tipo

L'identificatore del tipo di ambiente da utilizzare per l'attività. Vedi Environment type in Modi e tipi di calcolo dell'ambiente di creazione per i valori possibili.

dinamico

Le proprietà dinamiche definiscono la matrice di costruzione.

buildspec

Facoltativo. Un array che contiene il percorso e i nomi dei file buildspec da utilizzare per queste attività. Se questo parametro non è specificato, viene utilizzato il file buildspec corrente.

env

Facoltativo. L'ambiente di compilazione ha la precedenza su queste attività.

tipo di calcolo

Un array che contiene gli identificatori dei tipi di calcolo da utilizzare per queste attività. Vedere ComputeType Modi e tipi di calcolo dell'ambiente di creazione in per i valori possibili.

image

Un array che contiene gli identificatori delle immagini da utilizzare per queste attività. Vedi Image identifier in Immagini Docker fornite da CodeBuild per i possibili valori.

variabili

Un array che contiene le variabili di ambiente che saranno presenti negli ambienti di compilazione per queste attività. Per ulteriori informazioni, consulta env/variables.

Di seguito è riportato un esempio di una voce buildspec della matrice di compilazione:

batch: build-matrix: static: ignore-failure: false dynamic: buildspec: - matrix1.yml - matrix2.yml env: variables: MY_VAR: - VALUE1 - VALUE2 - VALUE3

Per ulteriori informazioni, consulta Costruisci una matrice.

batch/build-fanout

Definisce un fanout di build. Un build fanout viene utilizzato per definire un'attività suddivisa in più build eseguite in parallelo. Per ulteriori informazioni, consulta Esegui test paralleli in build in batch.

Questo elemento contiene un'attività di compilazione che può essere suddivisa in più build. La build-fanout sezione contiene le seguenti proprietà.

parallelismo

Obbligatorio. Il numero di build che eseguiranno i test in parallelo.

ignore-failure

Facoltativo. Un valore booleano che indica se un errore in una qualsiasi delle attività di compilazione di fanout può essere ignorato. Questo valore di ignore-failure verrà applicato a tutte le build di fanout.

false

Il valore predefinito. Se un'operazione di compilazione di fanout fallisce, la compilazione in batch avrà esito negativo.

true

Se un'operazione di compilazione di fanout fallisce, la compilazione in batch può comunque avere successo.

Di seguito è riportato un esempio di una voce build fanout buildspec:

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'

Per ulteriori informazioni, consulta Crea fanout e Usa il comando codebuild-tests-run CLI.