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: de pipeline, resources.repositories.repository
| Implementação | Descrição |
|---|---|
| gatilho : nenhum | Desabilitar gatilhos de CI. |
| gatilho : de 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 : de lista de cadeias de caracteres | Lista de branches que disparam uma execução. |
| gatilho: lote, branches, caminhos | Sintaxe completa para controle completo. |
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 nenhum gatilho de push, enviará por 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 de Desabilitar gatilho DE CI YAML implícito esteja habilitada. A configuração Desabilitar o gatilho DE CI YAML implícito pode ser configurada no nível da organização ou no nível do projeto. Quando o Desabilitar o gatilho DE CI yaml implícito configuração estiver habilitada, os gatilhos de CI para pipelines YAML não serão habilitados se o pipeline YAML não tiver uma seção trigger. O valor padrão para Desabilitar o gatilho DE CI YAML implícito é false.
Há três opções de sintaxe distintas 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, tagsou paths, será equivalente a especificar * na cláusula include.
Importante
Quando você especifica um gatilho, somente branches configurados explicitamente para a 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 disparará.
Desabilitar gatilhos de CI.
trigger: none # Disable CI triggers.
trigger cadeia de caracteres. Valores permitidos: nenhum.
Desabilitar gatilhos de CI.
trigger: none # will disable CI builds entirely
Lista de branches que disparam uma execução.
trigger: [ string ] # List of branches that trigger a run.
| Tipo | Descrição |
|---|---|
| corda | Lista de branches que disparam uma execução. |
trigger:
- main
- develop
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.
batch
booliano.
Se as alterações por branch devem ser feitas em lote.
branches
includeExcludeFilters.
nomes de branch a serem incluídos ou excluídos para disparar uma execução.
paths
includeExcludeFilters.
caminhos de arquivo a serem incluídos ou excluídos para disparar uma execução.
tags
includeExcludeFilters.
nomes de marca a serem incluídos ou excluídos para disparar uma execução.
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.
batch
booliano.
Se as alterações por branch devem ser feitas em lote.
branches
includeExcludeFilters.
nomes de branch a serem incluídos ou excluídos para disparar uma execução.
paths
includeExcludeFilters.
caminhos de arquivo a serem incluídos ou excluídos para disparar uma execução.
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, em seguida, iniciará outra execução com todas as alterações que ainda não foram criadas. Por padrão, batch é false.
Ao especificar um branch, marca ou caminho, você pode usar um nome exato ou um curinga. Para obter mais informações, consulte curingas.
Importante
Para obter mais informações, consulte Triggers – gatilhos de CI e escolha seu tipo de repositório.
# specific branch build with batching
trigger:
batch: true
branches:
include:
- main
trigger:
batch: true
branches:
include:
- features/*
exclude:
- features/experimental/*
paths:
exclude:
- README.md
Saiba mais sobre gatilhos e como especificá-los.