Migrar seu pipeline clássico para YAML

Azure DevOps Services

Comece a usar o Azure Pipelines convertendo seu pipeline Clássico existente para usar YAML. Com um pipeline baseado em YAML, você pode implementar sua estratégia de CI/CD como código e ver seu histórico, comparar versões, blame, anotar e assim por diante.

Quando você converte seu pipeline Classic, o produto final são dois pipelines. Você terá um novo pipeline YAML e um pipeline Classic que podem ser desativados. O histórico de execução do pipeline Classic permanece no pipeline Classic.

Pré-requisitos

Antes de começar, verifique se tem os itens a seguir.

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
• Uma organização ativa do Azure DevOps. Inscreva-se no Azure Pipelines.
• Um pipeline de trabalho que usa o editor de interface do usuário clássica.
• Um arquivo de pipeline YAML de exemplo no seu código. Crie um pipeline YAML de exemplo na seção a seguir.

Criar um pipeline YAML de exemplo

Execute as etapas a seguir para criar um pipeline YAML de exemplo, que você atualizará posteriormente com o código exportado do editor de interface do usuário clássica.

1. Entre na sua organização (https://dev.azure.com/{yourorganization}) e selecione seu projeto.

2. Selecione Pipelines e Novo pipeline.

   

3. Selecione o local do código-fonte como GitHub ou Azure Repos Git.

   

4. Selecione um repositório.

   

5. Na página Configurar seu pipeline, selecione Pipeline inicial.

   

6. Selecione Salvar e executar.

   

7. Insira sua mensagem de confirmação, selecione Confirmar diretamente na ramificação principal e escolha Salvar e executar novamente. Uma nova execução é iniciada e confirmada no repositório. Aguarde a conclusão da execução.

   

Exportar seu pipeline Clássico

Execute as etapas a seguir para exportar seu pipeline Clássico para um arquivo YAML que você pode usar no editor.

1. Vá para Pipelines>Pipelines.

2. Abra o pipeline Classic no designer de compilação clássico.

3. Selecione as reticências (...) e selecione Exportar para YAML.

   

4. Abra o arquivo YAML baixado no editor de código.

5. Se o pipeline YAML incluir variáveis definidas na interface do usuário clássica, defina as variáveis novamente na interface do usuário das configurações do pipeline ou no arquivo YAML. Para obter mais informações, confira Definir variáveis.

6. Examine qualquer agendamento cron no arquivo YAML. Por padrão, os agendamentos cron no YAML estão em UTC. Em pipelines clássicos, eles estão no fuso horário da organização. Para mais informações, consulte Configurar agendas para pipelines.

7. Use o Assistente de Tarefa para fazer outras alterações no arquivo YAML. O Assistente de Tarefa é um painel no lado direito da tela, que ajuda você a criar e modificar corretamente as etapas do YAML.

   

8. Salve e execute seu pipeline.

Limpar os recursos

Se você não for usar mais esse pipeline de exemplo, exclua-o do seu projeto. A exclusão é permanente e inclui todos os builds e artefatos associados.

1. Selecione as reticências (...) e selecione Excluir.

2. Insira o nome do pipeline para excluí-lo permanentemente e selecione Excluir.

Perguntas frequentes

Há uma tarefa em pipelines YAML para criar itens de trabalho quando há uma falha de compilação?

Os pipelines YAML não têm uma configuração Criar item de trabalho em caso de falha, como pipelines de build clássicos. Você tem algumas opções para criar essa funcionalidade por conta própria.

• Você pode usar um script ou uma tarefa do PowerShell e chamar a API REST.
• Você pode usar a CLI do Azure para chamar az boards work-item create em seu pipeline. Veja um exemplo de como usar a CLI para criar um bug em caso de falha.

Próximas etapas

Saiba mais sobre as diferenças de recursos entre pipelines YAML e Clássico.

Artigos relacionados

• Personalizar o pipeline
• Aprenda noções básicas do editor de pipeline YAML
• Definir aprovações e verificações