Partilhar via


definição do acionador

Um acionador push especifica quais os ramos que fazem com que uma compilação de integração contínua seja executada.

Definições que referenciam esta definição: pipeline, resources.repositories.repository

Definições que referenciam esta definição: pipeline

Implementações

Implementação Descrição
acionador: nenhum Desative os acionadores de CI.
acionador: lista de cadeias Lista de ramos que acionam uma execução.
acionador: lote, ramos, caminhos, etiquetas Sintaxe completa para controlo total.
Implementação Descrição
acionador: nenhum Desative os acionadores de CI.
acionador: lista de cadeias Lista de ramos que acionam uma execução.
acionador: lote, ramos, caminhos Sintaxe completa para controlo total.

Observações

Para obter mais informações sobre como utilizar acionadores com um tipo de repositório específico, veja Repositórios de origem suportados.

Se não especificar nenhum acionador push, envia para qualquer ramo acionar uma compilação.

Os pipelines YAML são configurados por predefinição com um acionador CI em todos os ramos, a menos que a definição Desativar o acionador YAML CI implícita esteja ativada. A definição Desativar o acionador YAML CI implícito pode ser configurada ao nível da organização ou ao nível do projeto. Quando a definição Desativar o acionador YAML CI implícito estiver ativada, os acionadores CI para pipelines YAML não serão ativados se o pipeline YAML não tiver uma trigger secção. O valor predefinido para Desativar o acionador CI YAML implícito é false.

Existem três opções de sintaxe distintas para a trigger palavra-chave: uma lista de ramos a incluir, uma forma de desativar os acionadores de CI e a sintaxe completa para um controlo completo.

Se especificar uma exclude cláusula sem uma include cláusula para branches, tagsou paths, é equivalente a especificar * na include cláusula .

Importante

Quando especifica um acionador, apenas os ramos que configura explicitamente para inclusão acionam um pipeline. As inclusões são processadas primeiro e, em seguida, as exclusões são removidas dessa lista. Se especificar uma exclusão, mas sem inclusão, nada é acionado.

acionador: nenhum

Desative os acionadores de CI.

trigger: none # Disable CI triggers.

trigger cadeia. Valores permitidos: nenhum.

Desative os acionadores de CI.

Exemplos

trigger: none # will disable CI builds entirely

acionador: lista de cadeias

Lista de ramos que acionam uma execução.

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

Tipos de lista

Tipo Description
cadeia (de carateres) Lista de ramos que acionam uma execução.

Exemplos

trigger:
- main
- develop

acionador: lote, ramos, caminhos, etiquetas

Utilize o controlo de sintaxe completo para controlo total sobre o acionador 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

batchbooleano.
Se pretende efetuar alterações em lotes por ramo.

branchesincludeExcludeFilters.
Nomes de ramo a incluir ou excluir para acionar uma execução.

pathsincludeExcludeFilters.
Caminhos de ficheiro a incluir ou excluir para acionar uma execução.

tagsincludeExcludeFilters.
Nomes de etiquetas a incluir ou excluir para acionar uma execução.

acionador: lote, ramos, caminhos

Utilize o controlo de sintaxe completo para controlo total sobre o acionador 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

batchbooleano.
Se pretende efetuar alterações em lotes por ramo.

branchesincludeExcludeFilters.
Nomes de ramo a incluir ou excluir para acionar uma execução.

pathsincludeExcludeFilters.
Caminhos de ficheiro a incluir ou excluir para acionar uma execução.

Observações

Se tiver muitos membros da equipa a carregar alterações com frequência, poderá querer reduzir o número de execuções iniciadas. Se definir batch como true, quando um pipeline está em execução, o sistema aguarda até que a execução seja concluída e, em seguida, inicia outra execução com todas as alterações que ainda não foram criadas. Por predefinição, batch é false.

Importante

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

Para obter mais informações, veja Triggers - CI triggers (Acionadores – Acionadores de CI ) e escolha o 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

Ver também

Saiba mais sobre os acionadores e como especificá-los.