Criando um Pipeline de CI com o Azure Pipelines

Integração contínua (CI) é a prática de mesclar frequentemente alterações de código em uma branch compartilhada, fazendo com que cada mesclagem acione automaticamente uma compilação e uma execução de testes. O objetivo é detectar falhas de integração antecipadamente — antes que elas se acumulem e se transformem em problemas grandes e difíceis de corrigir. Um bom pipeline de CI compila o código, executa testes unitários, mede a cobertura de código, realiza análise estática e produz um artefato implantável em poucos minutos. O Azure Pipelines fornece o mecanismo de automação para essa prática.

Os pipelines de CI do Azure Pipelines são definidos em um arquivo azure-pipelines.yml na raiz do seu repositório. O arquivo YAML especifica gatilhos (quando executar), um pool (qual tipo de agente usar) e uma hierarquia de estágios, tarefas e etapas. Por padrão, os estágios são executados sequencialmente. As tarefas dentro de um estágio são executadas em paralelo por padrão. As etapas dentro de uma tarefa são executadas sequencialmente. Essa estrutura proporciona um controle detalhado sobre o fluxo de execução do pipeline.

O Azure Pipelines oferece suporte a vários tipos de gatilho. Gatilhos de branch executam o pipeline quando o código é enviado para branches especificadas. Gatilhos de solicitação de pull (gatilhos de PR) são executados quando uma PR é aberta ou atualizada tendo branches de destino como referência — algo essencial para validar o código antes da mesclagem. Gatilhos agendados são executados em um horário fixo (por exemplo, compilações noturnas). Gatilhos de pipeline encadeiam pipelines. Especifique trigger: none para desabilitar as execuções automáticas e permitir somente a execução manual.

As etapas do pipeline são scripts (comandos bash ou PowerShell) ou tarefas (unidades pré-criadas e parametrizadas do marketplace do Azure DevOps). Tarefas como NodeTool@0, DotNetCoreCLI@2 e Maven@3 encapsulam operações comuns de compilação. Use displayName em cada etapa para tornar os registros do pipeline legíveis. Cada etapa é executada em sequência, e o pipeline falha se alguma etapa terminar com um código diferente de zero, a menos que você defina continueOnError: true.

Depois de executar os testes, publique os resultados no Azure DevOps usando a tarefa PublishTestResults. O Azure Pipelines analisa arquivos de resultados nos formatos JUnit, NUnit, XUnit ou VSTest e exibe as contagens de aprovações e reprovações, a duração da execução dos testes e os detalhes individuais dos testes na interface da execução do pipeline. O histórico de testes é acompanhado ao longo do tempo, permitindo identificar testes instáveis e regressões. Isso é essencial para dar visibilidade à qualidade do código em toda a equipe.

Publique relatórios de cobertura de código para que o Azure Pipelines exiba percentuais e tendências de cobertura na interface do pipeline. A tarefa PublishCodeCoverageResults aceita relatórios nos formatos Cobertura ou JaCoCo. Combine isso com portões de cobertura de branch — configure um limite mínimo de cobertura e faça a compilação falhar se a cobertura ficar abaixo dele. As tendências de cobertura ajudam a identificar quando um novo código está sendo adicionado sem os testes correspondentes.

Armazene a configuração do pipeline em variáveis definidas no nível do pipeline, do estágio ou da tarefa no YAML. Para valores confidenciais (chaves de API, senhas), use variáveis secretas — defina-as na biblioteca do pipeline (interface do usuário) ou em grupos de variáveis e faça referência a elas no YAML. Grupos de variáveis são coleções reutilizáveis de variáveis compartilhadas entre vários pipelines. Vincule um grupo de variáveis ao Azure Key Vault para sincronizar automaticamente os segredos do Key Vault com as variáveis do pipeline.

Depois de uma compilação bem-sucedida, empacote a saída em um artefato do pipeline para que os estágios posteriores (como a implantação) possam acessá-la. Use PublishPipelineArtifact para carregar arquivos do agente de compilação no armazenamento de artefatos do Azure DevOps. Em um estágio ou tarefa posterior, use DownloadPipelineArtifact para recuperar o artefato. Isso desacopla a tarefa de compilação das tarefas de implantação, que podem ser executadas em agentes diferentes ou em estágios diferentes.

Execute tarefas independentes em paralelo definindo várias tarefas dentro de um estágio. Por exemplo, execute testes unitários e a verificação de segurança simultaneamente, em vez de sequencialmente. As tarefas paralelas exigem minutos de compilação separados, mas podem reduzir consideravelmente a duração total do pipeline. Use a propriedade dependsOn para fazer uma tarefa aguardar a conclusão de uma ou mais outras tarefas antes de começar, criando um grafo de dependências dentro de um estágio.

Vincule seu pipeline de CI a uma política de branch no Azure Repos para que ele seja executado automaticamente como uma verificação de validação da compilação em solicitações de pull direcionadas à main. A mesclagem é bloqueada até que o pipeline seja aprovado. Combine várias verificações: o pipeline de CI deve ser bem-sucedido, pelo menos 2 revisores devem aprovar, todos os comentários devem ser resolvidos e deve existir um item de trabalho vinculado. Isso cria um portão de qualidade que torna impossível mesclar código com falhas na branch principal.

Depois que uma execução do pipeline for concluída, analise os resultados no portal do Azure DevOps. A guia Resumo mostra o resultado geral, aprovado ou reprovado, e os tempos. A guia Testes lista todos os resultados dos testes, com filtragem por resultado. A guia Cobertura de código mostra o percentual de cobertura e destaca as linhas não cobertas. Clique em qualquer tarefa para ver a saída do registro etapa por etapa. Os pipelines reprovados exibem a etapa com falha destacada em vermelho, com a saída completa do erro para facilitar o diagnóstico.

Teste sua compreensão dos conceitos do Microsoft Azure Fundamentals (AZ-900) abordados nesta lição.

Nesta lição, você aprendeu que o Azure Pipelines YAML define pipelines de CI com estágios, tarefas e etapas para compilação, testes e criação de artefatos; que gatilhos de PR e políticas de branch impõem portões de qualidade que bloqueiam a mesclagem de código com falhas; e que as tarefas PublishTestResults e PublishCodeCoverageResults tornam a qualidade dos testes visível em toda a equipe. Em seguida, exploraremos a implantação contínua no Azure.