Migrar o pipeline Clássico para o YAML

Azure DevOps Services

Introdução aos Pipelines do Azure ao converter o pipeline Clássico existente para utilizar o YAML. Com um pipeline baseado em YAML, pode implementar a sua estratégia ci/CD como código e ver o histórico, comparar versões, culpar, anotar, etc.

Quando converte o pipeline Clássico, o produto final é dois pipelines. Terá um novo pipeline YAML e um pipeline Clássico que pode ser descontinuado. O histórico de execuções do pipeline clássico permanecerá no pipeline Clássico.

Pré-requisitos

Certifique-se de que tem os seguintes itens antes de começar.

• Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
• Uma organização ativa do Azure DevOps. Inscreva-se nos Pipelines do Azure.
• Um pipeline de trabalho que utiliza o editor da interface de utilizador clássica (IU).
• Um ficheiro de pipeline YAML de exemplo no seu código. Crie um pipeline YAML de exemplo na secção seguinte.

Criar um pipeline YAML de exemplo

Efetue os seguintes passos para criar um pipeline YAML de exemplo, que irá atualizar mais tarde com o código exportado do editor de IU Clássica.

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

2. Selecione Pipelines e, em seguida , Novo pipeline.

   

3. Selecione a localização do seu código fonte como GitHub ou Git de Repositórios do Azure.

   

4. Selecione um repositório.

   

5. Na página Configurar o pipeline, selecione Pipeline de arranque.

   

6. Selecione Guardar e executar.

   

7. Introduza a sua mensagem de consolidação, selecione Consolidar diretamente no ramo principal e, em seguida, selecione Guardar e executar novamente. É iniciada uma nova execução e está consolidada no repositório. Aguarde a conclusão da execução.

   

Exportar o pipeline Clássico

Efetue os seguintes passos para exportar o pipeline Clássico para um ficheiro YAML que pode utilizar no editor.

1. Abra o pipeline Clássico.

2. Selecione as reticências (...) e, em seguida, selecione Exportar para YAML.

   

3. Abra o ficheiro YAML transferido no editor de código.

4. Se o pipeline YAML incluir variáveis definidas na IU Clássica, defina as variáveis novamente na IU das definições do pipeline ou no ficheiro YAML. Para obter mais informações, veja Definir variáveis.

5. Reveja quaisquer cron agendas no seu ficheiro YAML. Por predefinição, cron os agendamentos no YAML estão em UTC. Nos pipelines clássicos, estão no fuso horário da organização. Para obter mais informações, veja Configurar agendas para pipelines.

6. Utilize o Assistente de Tarefas para efetuar quaisquer outras alterações ao ficheiro YAML. O Assistente de Tarefas é um painel no lado direito do ecrã, que o ajuda a criar e modificar corretamente os passos do YAML.

   

7. Guarde e execute o pipeline.

Limpar os recursos

Se já não vai utilizar este pipeline de exemplo, elimine-o do seu projeto. A eliminação é permanente e inclui todas as compilações e artefactos associados.

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

2. Introduza o nome do pipeline para eliminá-lo permanentemente e, em seguida, selecione Eliminar.

FAQ

Existe alguma tarefa nos pipelines YAML para criar itens de trabalho quando existe uma falha de compilação?

Os pipelines YAML não têm um item criar trabalho na definição de falha , como pipelines de compilação clássicos. Tem algumas opções para criar esta funcionalidade.

• Pode utilizar um script ou uma tarefa do PowerShell e chamar a API REST.
• Pode utilizar a CLI do Azure para chamar az boards work-item create no seu pipeline. Veja um exemplo de utilização da CLI para criar um erro na falha.

Passos seguintes

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

Utilizar Pipelines do Azure

Artigos relacionados

• Personalizar o pipeline
• Noções básicas do editor de pipelines YAML
• Biblioteca de recursos
• Definir aprovações e verificações