Referência de buildspec de compilação em lote

Este tópico contém a referência de buildspec das propriedades da compilação em lote.

lote

Mapeamento opcional. As configurações de compilação em lote do projeto.

batch/fast-fail

Opcional. Especifica o comportamento da compilação em lote quando uma ou mais tarefas de compilação falham.

false

O valor padrão. Todas as compilações em execução serão concluídas.

true

Todas as compilações em execução serão interrompidas quando uma das tarefas de compilação falhar.

Por padrão, todas as tarefas de compilação em lote são executadas com as configurações de compilação, como env e phases, especificadas no arquivo buildspec. É possível substituir as configurações de compilação padrão especificando valores env diferentes ou outro arquivo buildspec no parâmetro batch/<batch-type>/buildspec.

O conteúdo da propriedade batch varia de acordo com o tipo de compilação em lote que está sendo especificado. Os tipos possíveis de compilação em lote são:

• batch/build-graph

• batch/build-list

• batch/build-matrix

batch/build-graph

Define um grafo de compilação. Um grafo de compilação define um conjunto de tarefas que dependem de outras tarefas no lote. Para obter mais informações, consulte Grafo de compilação.

Esse elemento contém uma matriz de tarefas de compilação. Cada etapa de compilação contém as propriedades a seguir.

Identifier

Obrigatório. O identificador da tarefa.

buildspec

Opcional. O caminho e o nome do arquivo buildspec a ser usado para essa tarefa. Se esse parâmetro não for especificado, o arquivo buildspec atual será usado.

debug-session

Opcional. Um valor booliano que indica se a depuração de sessão está habilitada para essa compilação em lote. Para obter mais informações sobre depuração de sessão, consulte Visualizar uma compilação em execução no Gerenciador de Sessões.

false

A depuração da sessão está desabilitada.

true

A depuração da sessão está habilitada.

depend-on

Opcional. Uma matriz de identificadores de tarefas dos quais essa tarefa depende. Essa tarefa não será executada até que essas tarefas sejam concluídas.

env

Opcional. O ambiente de compilação substitui a tarefa. Ele pode conter as seguintes propriedades:

compute-type

O identificador do tipo de computação a ser usado para a tarefa. Consulte computeType em Modos e tipos de computação do ambiente de compilação para ver os valores possíveis.

image

O identificador da imagem a ser usado para a tarefa. Consulte Identificador de imagem em Imagens do Docker fornecidas por CodeBuild para ver os valores possíveis.

privileged-mode

Valor booliano que indica se o daemon do Docker deve ser executado em um contêiner do Docker. Defina como true somente se o projeto de compilação for usado para criar imagens do Docker. Caso contrário, uma compilação que tente interagir com o daemon do Docker falhará. A configuração padrão é a false.

type

O identificador do tipo de ambiente a ser usado para a tarefa. Consulte Tipo de ambiente em Modos e tipos de computação do ambiente de compilação para ver os valores possíveis.

variables

As variáveis de ambiente que estarão presentes no ambiente de compilação. Consulte env/variables para obter mais informações.

ignore-failure

Opcional. Valor booliano que indica se uma falha dessa tarefa de compilação pode ser ignorada.

false

O valor padrão. Se essa tarefa de compilação falhar, ocorrerá um erro na compilação em lote.

true

Se essa tarefa de compilação falhar, a compilação em lote ainda poderá ser bem-sucedida.

Veja um exemplo de entrada de buildspec do grafo de compilação:

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

Define uma lista de compilações. Uma lista de compilação é usada para definir várias tarefas que são executadas paralelamente. Para obter mais informações, consulte Lista de compilações.

Esse elemento contém uma matriz de tarefas de compilação. Cada etapa de compilação contém as propriedades a seguir.

Identifier

Obrigatório. O identificador da tarefa.

buildspec

Opcional. O caminho e o nome do arquivo buildspec a ser usado para essa tarefa. Se esse parâmetro não for especificado, o arquivo buildspec atual será usado.

debug-session

Opcional. Um valor booliano que indica se a depuração de sessão está habilitada para essa compilação em lote. Para obter mais informações sobre depuração de sessão, consulte Visualizar uma compilação em execução no Gerenciador de Sessões.

false

A depuração da sessão está desabilitada.

true

A depuração da sessão está habilitada.

env

Opcional. O ambiente de compilação substitui a tarefa. Ele pode conter as seguintes propriedades:

compute-type

O identificador do tipo de computação a ser usado para a tarefa. Consulte computeType em Modos e tipos de computação do ambiente de compilação para ver os valores possíveis.

image

O identificador da imagem a ser usado para a tarefa. Consulte Identificador de imagem em Imagens do Docker fornecidas por CodeBuild para ver os valores possíveis.

privileged-mode

Valor booliano que indica se o daemon do Docker deve ser executado em um contêiner do Docker. Defina como true somente se o projeto de compilação for usado para criar imagens do Docker. Caso contrário, uma compilação que tente interagir com o daemon do Docker falhará. A configuração padrão é a false.

type

O identificador do tipo de ambiente a ser usado para a tarefa. Consulte Tipo de ambiente em Modos e tipos de computação do ambiente de compilação para ver os valores possíveis.

variables

As variáveis de ambiente que estarão presentes no ambiente de compilação. Consulte env/variables para obter mais informações.

ignore-failure

Opcional. Valor booliano que indica se uma falha dessa tarefa de compilação pode ser ignorada.

false

O valor padrão. Se essa tarefa de compilação falhar, ocorrerá um erro na compilação em lote.

true

Se essa tarefa de compilação falhar, a compilação em lote ainda poderá ser bem-sucedida.

Veja um exemplo de entrada de buildspec da lista de compilação:

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

Define uma matriz de compilação. Uma matriz de compilação define tarefas com configurações diferentes que são executadas paralelamente. O CodeBuild cria uma compilação separada para cada combinação de configuração possível. Para obter mais informações, consulte Matriz de compilações.

static

As propriedades estáticas se aplicam a todas as tarefas de compilação.

ignore-failure

Opcional. Valor booliano que indica se uma falha dessa tarefa de compilação pode ser ignorada.

false

O valor padrão. Se essa tarefa de compilação falhar, ocorrerá um erro na compilação em lote.

true

Se essa tarefa de compilação falhar, a compilação em lote ainda poderá ser bem-sucedida.

env

Opcional. O ambiente de compilação substitui todas as tarefas.

privileged-mode

Valor booliano que indica se o daemon do Docker deve ser executado em um contêiner do Docker. Defina como true somente se o projeto de compilação for usado para criar imagens do Docker. Caso contrário, uma compilação que tente interagir com o daemon do Docker falhará. A configuração padrão é a false.

type

O identificador do tipo de ambiente a ser usado para a tarefa. Consulte Tipo de ambiente em Modos e tipos de computação do ambiente de compilação para ver os valores possíveis.

dynamic

As propriedades dinâmicas definem a matriz de compilação.

buildspec

Opcional. Matriz que contém o caminho e os nomes dos arquivos buildspec a serem usados nessas tarefas. Se esse parâmetro não for especificado, o arquivo buildspec atual será usado.

env

Opcional. O ambiente de compilação substitui essas tarefas.

compute-type

Matriz que contém os identificadores dos tipos de computação a serem usados nessas tarefas. Consulte computeType em Modos e tipos de computação do ambiente de compilação para ver os valores possíveis.

image

Matriz que contém os identificadores das imagens a serem usados nessas tarefas. Consulte Identificador de imagem em Imagens do Docker fornecidas por CodeBuild para ver os valores possíveis.

variables

Matriz que contém as variáveis de ambiente que estarão presentes nos ambientes de compilação dessas tarefas. Consulte env/variables para obter mais informações.

Veja um exemplo de entrada de buildspec da matriz de compilação:

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

Para obter mais informações, consulte Matriz de compilações.