Riferimento buildspec per la compilazione Batch

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

batch

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

batch/fast-fail

Facoltativo. Specifica il comportamento della compilazione 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 batch vengono eseguite con le impostazioni di compilazione comeenvephases, specificato nel file buildspec. Puoi sovrascrivere le impostazioni di compilazione predefinite specificando diverseenvvalori o un diverso file buildspec nelbatch/<batch-type>/buildspecParametro .

Contenuti dibatchLa proprietà varia in base al tipo di compilazione batch specificata. I possibili tipi di compilazione batch sono:

• batch/build-graph

• batch/build-list

• batch/build-matrix

batch/build-graph

Definisce ungrafico di compilazione. Un grafico di compilazione definisce un insieme di attività che hanno dipendenze da altre attività del batch. Per ulteriori informazioni, consultare Costruisci un grafico.

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

identificatore

Campo obbligatorio. L'identificatore dell'attività.

buildspec

Facoltativo. Percorso e 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 di sessione è abilitato per questa compilazione batch. Per ulteriori informazioni sul debug di sessione, consultaVisualizza una build in esecuzione in Session Manager.

false

Il debug della sessione è disabilitato.

true

Il debug della sessione è abilitato.

dipend-da

Facoltativo. Un array di identificatori di attività da cui dipende questa attività. Questa attività non verrà eseguita fino al completamento di queste attività.

env

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

tipo di calcolo

Identificatore del tipo di calcolo da utilizzare per l'attività. Consulta .computeTypenelModi e tipi di calcolo dell'ambiente di creazioneper valori possibili.

image

L'identificatore dell'immagine da utilizzare per l'attività. Consulta .Identificatore dell'immaginenelImmagini Docker fornite da CodeBuildper valori possibili.

modalità privilegiata

Un valore booleano che indica se eseguire il demone Docker all'interno di un container Docker. Impostare sutruesolo 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

Identificatore del tipo di ambiente da utilizzare per l'attività. Consulta .Tipo di ambientenelModi e tipi di calcolo dell'ambiente di creazioneper valori possibili.

variabili

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

ignorare il fallimento

Facoltativo. Valore booleano che indica se un errore di questa attività di compilazione può essere ignorato.

false

Il valore predefinito. Se l'attività di compilazione ha esito negativo, la compilazione batch non riuscirà.

true

Se l'attività di compilazione ha esito negativo, la compilazione batch può comunque avere esito positivo.

Nell'esempio seguente viene mostrata una voce di buildspec del grafico di compilazione:

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

batch/build-list

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

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

identificatore

Campo obbligatorio. L'identificatore dell'attività.

buildspec

Facoltativo. Percorso e 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 di sessione è abilitato per questa compilazione batch. Per ulteriori informazioni sul debug di sessione, consultaVisualizza 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à. Può contenere le seguenti proprietà:

tipo di calcolo

Identificatore del tipo di calcolo da utilizzare per l'attività. Consulta .computeTypenelModi e tipi di calcolo dell'ambiente di creazioneper valori possibili.

image

L'identificatore dell'immagine da utilizzare per l'attività. Consulta .Identificatore dell'immaginenelImmagini Docker fornite da CodeBuildper valori possibili.

modalità privilegiata

Un valore booleano che indica se eseguire il demone Docker all'interno di un container Docker. Impostare sutruesolo 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

Identificatore del tipo di ambiente da utilizzare per l'attività. Consulta .Tipo di ambientenelModi e tipi di calcolo dell'ambiente di creazioneper valori possibili.

variabili

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

ignorare il fallimento

Facoltativo. Valore booleano che indica se un errore di questa attività di compilazione può essere ignorato.

false

Il valore predefinito. Se l'attività di compilazione ha esito negativo, la compilazione batch non riuscirà.

true

Se l'attività di compilazione ha esito negativo, la compilazione batch può comunque avere esito positivo.

Nell'esempio seguente viene mostrata una voce di build list buildspec:

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

batch/build-matrix

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

statico

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

ignorare il fallimento

Facoltativo. Valore booleano che indica se un errore di questa attività di compilazione può essere ignorato.

false

Il valore predefinito. Se l'attività di compilazione ha esito negativo, la compilazione batch non riuscirà.

true

Se l'attività di compilazione ha esito negativo, la compilazione batch può comunque avere esito positivo.

env

Facoltativo. L'ambiente di compilazione è sovrascritto per tutte le attività.

modalità privilegiata

Un valore booleano che indica se eseguire il demone Docker all'interno di un container Docker. Impostare sutruesolo 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

Identificatore del tipo di ambiente da utilizzare per l'attività. Consulta .Tipo di ambientenelModi e tipi di calcolo dell'ambiente di creazioneper valori possibili.

dinamico

Le proprietà dinamiche definiscono la matrice di compilazione.

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 per queste attività.

tipo di calcolo

Un array che contiene gli identificatori dei tipi di calcolo da utilizzare per queste attività. Consulta .computeTypenelModi e tipi di calcolo dell'ambiente di creazioneper valori possibili.

image

Un array che contiene gli identificatori delle immagini da utilizzare per queste attività. Consulta .Identificatore dell'immaginenelImmagini Docker fornite da CodeBuildper valori possibili.

variabili

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

Nell'esempio seguente viene mostrata 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, consultare Costruisci una matrice.