Definição de gatilho

Um gatilho push especifica quais ramificações fazem com que uma compilação de integração contínua seja executada.

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

Implementações

Execução	Descrição
gatilho: nenhum	Desative os gatilhos de CI.
trigger: lista de cadeias de caracteres	Lista de ramificações que acionam uma execução.
gatilho: lote, ramificações, caminhos, tags	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 suportados.

Os pipelines YAML são configurados por padrão com um gatilho de CI em todas as ramificações, a menos que a configuração Desativar gatilho de CI YAML implícito esteja habilitada. A configuração Desabilitar de gatilho YAML CI implícito pode ser configurada no nível da organização ou no nível do projeto. Quando a configuração Desabilitar de gatilho YAML implícito está habilitada, os gatilhos de CI para pipelines YAML não são habilitados se o pipeline YAML não tiver uma seção trigger. O valor padrão para de gatilho YAML CI implícito Disable é false.

Há três opções de sintaxe distintas para a palavra-chave trigger: uma lista de ramificações a serem incluídas, 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, tagsou paths, isso equivale a especificar * na cláusula include.

Gatilho: Nenhum

Desative os gatilhos de CI.

trigger: none # Disable CI triggers.

trigger string. Valores permitidos: nenhum.

Desative os gatilhos de CI.

Exemplos

trigger: none # will disable CI builds entirely

gatilho: lista de cadeias de caracteres

Lista de ramificações que acionam uma execução.

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

Tipos de lista

Tipo	Descrição
string	Lista de ramificações que acionam uma execução.

Exemplos

trigger:
- main
- develop

gatilho: lote, ramificações, caminhos, tags

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

batch booleano.
Se as alterações em lote devem ser feitas por ramo.

branches includeExcludeFilters.
Nomes de ramificações a serem incluídos ou excluídos para acionar uma execução.

paths includeExcludeFilters.
Caminhos de arquivo a serem incluídos ou excluídos para acionar uma execução.

tags includeExcludeFilters.
Nomes de tags a serem incluídos ou excluídos para acionar uma execução.

Comentários

Se você tiver muitos membros da equipe carregando alterações com frequência, convém 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, em seguida, iniciará outra execução com todas as alterações que ainda não foram criadas. Por padrão, batch é false.

Ao especificar uma ramificação, marca ou caminho, você pode usar um nome exato ou um curinga. Para obter mais informações, consulte curingas.

Importante

batch não é suportado em acionadores de de recursos do repositório.

Para obter mais informações, consulte Triggers - CI triggers 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

Ver também

Saiba mais sobre gatilhos e como especificá-los.