definição de gatilho

  • Artigo

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

Definições que fazem referência a essa definição: pipeline

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

Se você não especificar um gatilho de push, efetuará push para qualquer branch que dispare um build.

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.

Importante

Quando você especifica um gatilho, somente os branches configurados explicitamente para inclusão disparam um pipeline. As inclusões são processadas primeiro e, em seguida, as exclusões são removidas dessa lista. Se você especificar uma exclusão, mas sem inclusões, nada será disparado.

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.

gatilho: lote, branches, caminhos

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.

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.

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.