Referência de esquema YAML para Pipelines do Azure
A referência de esquema YAML para Pipelines do Azure é uma referência detalhada para pipelines YAML que lista toda a sintaxe YAML suportada e suas opções disponíveis.
Para criar um pipeline YAML, comece com a definição pipeline. Para obter mais informações sobre como criar pipelines YAML, consulte Personalizar seu pipeline.
A referência de esquema YAML não abrange tarefas. Para obter mais informações sobre tarefas, consulte o índice de tarefas do Azure Pipelines.
Definições
pipeline
Um pipeline é um ou mais estágios que descrevem um processo de CI/CD. A definição de pipeline contém a documentação para propriedades de nível raiz como name
.
estende-se
Estende um pipeline usando um modelo.
empregos
Especifica os trabalhos que compõem o trabalho de um estágio.
jobs.deployment
Um trabalho de implantação é um tipo especial de trabalho. É uma coleção de etapas para executar sequencialmente no ambiente.
jobs.deployment.environment
Nome do ambiente de destino e, opcionalmente, um nome de recurso para registrar o histórico de implantação; formato: environment-name.resource-name.
jobs.deployment.strategy
Estratégia de execução para esta implantação.
jobs.deployment.strategy.canary
Estratégia de implantação das Canárias.
jobs.deployment.strategy.rolling
Estratégia de implantação contínua.
jobs.deployment.strategy.runOnce
estratégia de implantação do RunOnce.
jobs.job
Um trabalho é uma coleção de etapas executadas por um agente ou em um servidor.
jobs.job.container
Nome do recurso de contêiner.
jobs.job.strategy
Estratégia de execução para este trabalho.
jobs.job.uses
Todos os recursos exigidos por este trabalho que ainda não estejam referenciados.
jobs.template
Um conjunto de trabalhos definidos em um modelo.
parâmetros
Especifica os parâmetros de tempo de execução passados para um pipeline.
parameters.parameter
Parâmetros do modelo de pipeline.
piscina
Qual pool usar para um trabalho do pipeline.
pool.demands
Exigências (para uma piscina privada).
PR
Gatilho de solicitação pull.
recursos
Resources especifica compilações, repositórios, pipelines e outros recursos usados pelo pipeline.
resources.builds
Lista de recursos de compilação referenciados pelo pipeline.
resources.builds.build
Um recurso de compilação usado para fazer referência a artefatos de uma execução.
resources.containers
Lista de imagens de contêiner.
resources.containers.container
Um recurso de contêiner usado para fazer referência a uma imagem de contêiner.
resources.containers.container.trigger
Especifique nenhum para desabilitar, true para disparar em todas as tags de imagem ou use a sintaxe completa conforme descrito nos exemplos a seguir.
resources.packages
Lista de recursos do pacote.
resources.packages.package
Um recurso de pacote usado para fazer referência a um pacote NuGet ou npm GitHub.
resources.pipelines
Lista de recursos de pipeline.
resources.pipelines.pipeline
Um recurso de pipeline.
resources.pipelines.pipeline.trigger
Especifique nenhuma para desabilitar, true para incluir todas as ramificações ou use a sintaxe completa conforme descrito nos exemplos a seguir.
resources.pipelines.pipeline.trigger.branches
Ramificações a serem incluídas ou excluídas para acionar uma execução.
resources.repositories
Lista de recursos do repositório.
resources.repositories.repository
Um recurso de repositório é usado para fazer referência a um repositório adicional em seu pipeline.
resources.webhooks
Lista de webhooks.
resources.webhooks.webhook
Um recurso de webhook permite integrar seu pipeline com um serviço externo para automatizar o fluxo de trabalho.
resources.webhooks.webhook.filters
Lista de filtros de gatilho.
resources.webhooks.webhook.filters.filter
filtro de gatilho de recurso Webhook.
horários
A lista de agendas especifica os gatilhos agendados para o pipeline.
schedules.cron
Um gatilho agendado especifica uma agenda na qual as ramificações são criadas.
etapas
Estágios são uma coleção de trabalhos relacionados.
stages.stage
Um estágio é uma coleção de trabalhos relacionados.
stages.template
Você pode definir um conjunto de estágios em um arquivo e usá-lo várias vezes em outros arquivos.
passos
Etapas são uma sequência linear de operações que compõem um trabalho.
steps.bash
Executa um script em Bash no Windows, macOS e Linux.
steps.checkout
Configure como o pipeline faz check-out do código-fonte.
steps.download
Downloads de artefatos associados à execução atual ou de outro Pipeline do Azure associado como um recurso de pipeline.
steps.downloadBuild
Downloads criam artefatos.
steps.getPackage
Baixa um pacote de um feed de gerenciamento de pacotes no Azure Artifacts ou no Azure DevOps Server.
steps.powershell
Executa um script usando o Windows PowerShell (no Windows) ou o pwsh (Linux e macOS).
steps.publish
Publica (carrega) um arquivo ou pasta como um artefato de pipeline que outros trabalhos e pipelines podem consumir.
steps.pwsh
Executa um script no PowerShell Core no Windows, macOS e Linux.
steps.reviewApp
Downloads cria um recurso dinamicamente em um provedor de fase de implantação.
steps.task
Executa uma tarefa.
steps.template
Defina um conjunto de etapas em um arquivo e use-o várias vezes em outro arquivo.
alvo
As tarefas são executadas em um contexto de execução, que é o host do agente ou um contêiner.
target.settableVariables
Restrições sobre quais variáveis podem ser definidas.
gatilho
Gatilho de integração contínua (push).
variáveis
Definir variáveis usando pares nome/valor.
variáveis.grupo
Variáveis de referência de um grupo de variáveis.
variables.name
Defina variáveis usando nome e sintaxe completa.
variables.template
Definir variáveis em um modelo.
Definições de apoio
Observação
As definições de suporte não se destinam a ser usadas diretamente em um pipeline. As definições de suporte são usadas apenas como parte de outras definições e são incluídas aqui para referência.
deployHook
Usado para executar etapas que implantam seu aplicativo.
includeExcludeFilters
Listas de itens a incluir ou excluir.
includeExcludeStringFilters
Itens a incluir ou excluir.
mountReadOnly
Volumes para montar somente leitura, o padrão é todo falso.
onFailureHook
Usado para executar etapas para ações de reversão ou limpeza.
onSuccessHook
Usado para executar etapas para ações de reversão ou limpeza.
onSuccessOrFailureHook
Usado para executar etapas para ações de reversão ou limpeza.
postRouteTrafficHook
Usado para executar as etapas depois que o tráfego é roteado. Normalmente, essas tarefas monitoram a integridade da versão atualizada para um intervalo definido.
preDeployHook
Usado para executar etapas que inicializam recursos antes do início da implantação do aplicativo.
routeTrafficHook
Usado para executar etapas que servem o tráfego para a versão atualizada.
espaço de trabalho
Opções de espaço de trabalho no agente.
Convenções de documentação do esquema YAML
A referência de esquema YAML é um guia de referência detalhado para pipelines YAML do Azure Pipelines. Ele inclui um catálogo de todos os recursos YAML suportados e as opções disponíveis.
Aqui estão as convenções de sintaxe usadas na referência de esquema YAML.
- À esquerda de
:
está uma palavra-chave literal usada em definições de pipeline. - À direita de
:
, encontra-se um tipo de dados. O tipo de dados pode ser um tipo primitivo como cadeia de caracteres ou uma referência a uma estrutura rica definida em outro lugar nessa referência. - A notação
[
tipo de dados]
indica uma matriz do tipo de definição mencionado. Por exemplo,[ string ]
é uma matriz de cadeias de caracteres. - A notação
{
tipo de dados:
tipo de dados}
indica um mapeamento de um tipo de dados para outro. Por exemplo,{ string: string }
é um mapeamento de strings para strings. - O símbolo
|
indica que há vários tipos de dados disponíveis para a palavra-chave. Por exemplo,job | template
significa que uma definição de trabalho ou uma referência de modelo é permitida.
Ver também
Esta referência abrange o esquema de um arquivo YAML do Azure Pipelines.
Para aprender as noções básicas de YAML, consulte Aprenda YAML em Y Minutos.
O Azure Pipelines não dá suporte a todos os recursos do YAML.
Os recursos não suportados incluem âncoras, chaves complexas e conjuntos.
Além disso, ao contrário do YAML padrão, o Azure Pipelines depende de ver stage
, job
, task
ou um atalho de tarefa como script
como a primeira chave em um mapeamento.