definição de gatilho

Um gatilho de push especifica quais branches fazem com que um build de integração contínua seja executado.

Definições que fazem referência a essa definição: pipeline, resources.repositories.repository

Implementações

Implementação	Descrição
gatilho: nenhum	Desabilitar gatilhos de CI.
gatilho: lista de cadeias de caracteres	Lista de branches que disparam uma execução.
gatilho: lote, branches, caminhos, marcas	Sintaxe completa para controle completo.

Comentários

Para obter mais informações sobre como usar gatilhos com um tipo de repositório específico, consulte Repositórios de origem com suporte.

Os pipelines YAML são configurados por padrão com um gatilho de CI em todos os branches, a menos que a configuração Desabilitar gatilho de CI YAML implícita esteja habilitada. A configuração Desabilitar gatilho de CI YAML implícita pode ser definida no nível da organização ou no nível do projeto. Quando a configuração Desabilitar gatilho de CI YAML implícita estiver habilitada, os gatilhos de CI para pipelines YAML não serão habilitados se o pipeline YAML não tiver uma trigger seção. O valor padrão para Desabilitar o gatilho DE CI YAML implícito é false.

Há três opções de sintaxe diferentes para a palavra-chave trigger: uma lista de branches a serem incluídos, uma maneira de desabilitar gatilhos de CI e a sintaxe completa para controle completo.

Se você especificar uma cláusula exclude sem uma cláusula include para branches, tags ou paths, isso será equivalente a especificar * na cláusula include.

gatilho: nenhum

Desabilitar gatilhos de CI.

trigger: none # Disable CI triggers.

trigger String. Valores permitidos: nenhum.

Desabilitar gatilhos de CI.

Exemplos

trigger: none # will disable CI builds entirely

gatilho: lista de cadeias de caracteres

Lista de branches que disparam uma execução.

trigger: [ string ] # List of branches that trigger a run.

Tipos de lista

Tipo	Descrição
string	Lista de branches que disparam uma execução.

Exemplos

trigger:
- main
- develop

gatilho: lote, branches, caminhos, marcas

Use o controle de sintaxe completo para controle total sobre o gatilho de CI.

trigger:
  batch: boolean # Whether to batch changes per branch.
  branches: # Branch names to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.
  paths: # File paths to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.
  tags: # Tag names to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.

Propriedades

batchbooliano.
Se as alterações devem ser feitas em lote por branch.

branchesincludeExcludeFilters.
Nomes de branch a serem incluídos ou excluídos para disparar uma execução.

pathsincludeExcludeFilters.
Caminhos de arquivo a serem incluídos ou excluídos para disparar uma execução.

tagsincludeExcludeFilters.
Nomes de marca a serem incluídos ou excluídos para disparar uma execução.

Comentários

Se você tiver muitos membros da equipe carregando alterações com frequência, talvez queira reduzir o número de execuções iniciadas. Se você definir batch como true, quando um pipeline estiver em execução, o sistema aguardará até que a execução seja concluída e iniciará outra execução com todas as alterações que ainda não foram criadas. Por padrão, batch é false.

Importante

batch não há suporte em gatilhos de recursos do repositório .

Para obter mais informações, consulte Gatilhos – gatilhos de CI e escolha o tipo de repositório.

# specific branch build with batching
trigger:
  batch: true
  branches:
    include:
    - main

Exemplos

trigger:
  batch: true
  branches:
    include:
    - features/*
    exclude:
    - features/experimental/*
  paths:
    exclude:
    - README.md

Confira também

Saiba mais sobre gatilhos e como especificá-los.