Editor de pipeline YAML

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

O Azure Pipelines oferece um editor de pipelines do YAML que pode utilizar para criar e editar os pipelines. O editor YAML é baseado no editor de Mônaco. O editor disponibiliza ferramentas como o suporte para IntelliSense e um assistente de tarefas para dar orientações enquanto edita um pipeline.

Este artigo mostra como editar seus pipelines usando o editor de pipeline YAML, mas você também pode editar pipelines modificando o arquivo azure-pipelines.yml diretamente no repositório do pipeline usando um editor de texto de sua escolha ou usando uma ferramenta como o Visual Studio Code e a extensão Azure Pipelines for VS Code .

Editar um pipeline YAML

Para acessar o editor de pipeline YAML, execute as etapas a seguir.

1. Inicie sessão na sua organização (https://dev.azure.com/{yourorganization}).

2. Selecione seu projeto, escolha Pipelines e, em seguida, selecione o pipeline que deseja editar. Você pode procurar pipelines por Recente, Todos e Execuções. Para obter mais informações, consulte Exibir e gerenciar seus pipelines.

   

3. Escolha Editar.

   

4. Faça edições no seu pipeline usando o Intellisense e o assistente de tarefas para obter orientação.

   

5. Escolha Validar e salvar. Você pode se comprometer diretamente com sua ramificação ou criar uma nova ramificação e, opcionalmente, iniciar uma solicitação pull.

   

Utilizar atalhos de teclado

O editor de pipeline YAML fornece vários atalhos de teclado, que mostramos nos exemplos a seguir.

• Escolha Ctrl+Space para suporte ao Intellisense enquanto edita o pipeline YAML.

  

• Escolha F1 (Fn+F1 no Mac) para exibir a paleta de comandos e visualizar os atalhos de teclado disponíveis.

  

Usar o assistente de tarefas

O assistente de tarefas fornece um método para adicionar tarefas ao seu pipeline YAML.

• Para exibir o assistente de tarefas, edite seu pipeline YAML e escolha Mostrar assistente.

  

• Para ocultar o assistente de tarefas, escolha Ocultar assistente.

  

• Para utilizar o assistente de tarefas, procure ou procure tarefas no painel Tarefas .

  

• Selecione a tarefa desejada e configure suas entradas.

  

• Escolha Adicionar para inserir a tarefa YAML em seu pipeline.

• Você pode editar o YAML para fazer mais alterações de configuração na tarefa ou pode escolher Configurações acima da tarefa no editor de pipeline do YAML para configurar a tarefa inserida no assistente de tarefas.

Validar

Valide as alterações para detetar erros de sintaxe no pipeline que impeçam o início. Escolha Mais ações>Validar.

O Azure Pipelines valida seus pipelines sempre que você salva. Escolha Validar e salvar para validar seu pipeline antes de salvar. Se houver algum erro, você pode cancelar ou salvar de qualquer maneira. Para salvar seu pipeline sem validar, escolha Salvar sem validar.

O Azure Pipelines deteta definições de variáveis incorretas definidas no pipeline, estágio e nível de trabalho e deteta condições YAML incorretas definidas no pipeline, estágio e nível de trabalho.

Baixar YAML completo

Você pode visualizar o documento YAML totalmente analisado sem confirmar ou executar o pipeline. Escolha Mais ações>Baixar YAML completo.

Baixar YAMLcompleto Executa a API REST do Azure DevOps para Pipelines do Azure e inicia um download do YAML renderizado do editor.

Gerenciar variáveis de pipeline

Você pode gerenciar variáveis de pipeline de dentro do pipeline do YAML e da interface do usuário de configurações do pipeline.

Para gerenciar variáveis de pipeline, execute as etapas a seguir.

1. Edite seu pipeline YAML e escolha Variáveis para gerenciar variáveis de pipeline.

   

2. Escolha entre as seguintes funções:

   • Nova variável: para adicionar a sua primeira variável.
   • Adicionar : para adicionar variáveis subsequentes.
   • Nome da variável para editar uma variável.
   • Delete : para excluir uma variável.

   

Para gerenciar variáveis de pipelines na interface do usuário de configurações de pipeline, execute as etapas a seguir.

1. Edite o pipeline e escolha Mais ações>Triggers.

   

2. Escolha Variáveis.

   

Para obter mais informações sobre como trabalhar com variáveis de pipeline, consulte Definir variáveis.

Configurar o pool de agentes padrão

Se um pipeline YAML não especificar um pool de agentes, o pool de agentes configurado na configuração Pool de agentes padrão para YAML será usado. Esse pool também é usado para tarefas de limpeza pós-execução.

Para exibir e configurar a configuração do pool de agentes padrão para YAML:

1. Edite o pipeline e escolha Mais ações>Triggers.

   

2. Escolha YAML e selecione o pool de agentes desejado usando a lista suspensa Pool de agentes padrão para YAML .

   

O pool de agentes padrão para YAML é configurado por pipeline.

Gerenciar configurações usando a interface do usuário de configurações de pipeline

Algumas configurações de pipeline YAML são definidas usando a interface do usuário de configurações de pipeline em vez de no arquivo YAML.

1. Edite o pipeline e escolha Mais ações>Triggers.

   

2. Na interface do usuário de configurações do pipeline, escolha a guia da configuração a ser configurada.

   

Ver e editar modelos

Os modelos são um recurso comumente usado em pipelines YAML. Eles são uma maneira fácil de compartilhar trechos de pipeline e são um mecanismo poderoso para verificar e aplicar a segurança e a governança em seu pipeline. Anteriormente, o editor não suportava modelos, então os autores de pipelines YAML não podiam obter assistência intellisense. Agora, o Azure Pipelines dá suporte a um editor YAML, para o qual estamos visualizando o suporte. Para habilitar essa visualização, vá para Visualizar recursos em sua organização do Azure DevOps e habilite o editor de modelos YAML.

Importante

Este recurso tem as seguintes limitações.

• Se o modelo tiver parâmetros necessários que não são fornecidos como entradas no arquivo YAML principal, a validação falhará e solicitará que você forneça essas entradas.

• Não é possível criar um novo modelo a partir do editor. Você só pode usar ou editar modelos existentes.

Ao editar seu arquivo YAML principal do Azure Pipelines, você pode incluir ou estender um modelo. À medida que você insere o nome do modelo, você pode ser solicitado a validar o modelo. Uma vez validado, o editor YAML entende o esquema do modelo, incluindo os parâmetros de entrada.

Após a validação, você pode entrar no modelo escolhendo Exibir modelo, que abre o modelo em uma nova guia do navegador. Você pode fazer alterações no modelo usando todos os recursos do editor YAML.

Próximos passos

Personalizar o pipeline

Artigos relacionados

• Saiba como navegar e visualizar seus pipelines
• Create your first pipeline (Criar o primeiro pipeline)