Compartilhar via

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: de pipeline, resources.repositories.repository

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

Implementações

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.

Observações

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

gatilho: nenhum

Desabilitar gatilhos de CI.

trigger: none # Disable CI triggers.

trigger cadeia de caracteres. 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
corda 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

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.

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

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.

Observações

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

não tem suporte em gatilhos de de recursos de repositório .

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

Exemplos

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

Consulte também

Saiba mais sobre gatilhos e como especificá-los.