Crie seu primeiro pipeline

Este é um guia passo a passo para usar o Azure Pipelines para criar um aplicativo de exemplo de um repositório Git. Este guia usa pipelines YAML configurados com o editor de pipeline YAML.

Para obter mais informações sobre as diferentes seções em um pipeline YAML, consulte o pipeline no esquema YAML do Azure Pipelines e personalize seu pipeline YAML.

Se você quiser usar pipelines clássicos, confira Definir seu pipeline Clássico. Para obter orientação sobre como usar o TFVC, consulte Criar repositórios do TFVC.

Pré-requisitos – Azure DevOps

Verifique se você tem o seguinte:

• Uma conta do GitHub, na qual você pode criar um repositório. Crie um gratuitamente.

• Uma organização do Azure DevOps. Crie um gratuitamente. Se sua equipe já tiver uma, verifique se você é um administrador do projeto do Azure DevOps que deseja usar.

• Uma capacidade de executar pipelines em agentes hospedados pela Microsoft. Para usar agentes hospedados pela Microsoft, sua organização do Azure DevOps precisa ter acesso a trabalhos paralelos hospedados pela Microsoft. Você pode comprar um trabalho paralelo ou solicitar uma concessão gratuita.

Crie seu primeiro pipeline

https://github.com/MicrosoftDocs/pipelines-java

https://github.com/MicrosoftDocs/pipelines-dotnet-core

https://github.com/Microsoft/python-sample-vscode-flask-tutorial

https://github.com/Azure-Samples/js-e2e-express-server

Exibir e gerenciar seus pipelines

Você pode exibir e gerenciar seus pipelines escolhendo Pipelines no menu à esquerda para acessar a página de aterrissagem de pipelines.

Na página de aterrissagem de pipelines, você pode exibir pipelines e execuções de pipeline, criar e importar pipelines, gerenciar a segurança e fazer drill down nos detalhes do pipeline e da execução.

Escolha Recente para exibir pipelines executados recentemente (o modo de exibição padrão) ou escolha Todos para exibir todos os pipelines.

Selecione um pipeline para gerenciar esse pipeline e exibir as execuções. Selecione o número de build da última execução para exibir os resultados desse build, selecione o nome do branch para exibir o branch para essa execução ou selecione o menu de contexto para executar o pipeline e executar outras ações de gerenciamento.

Selecione Execuções para exibir todas as execuções de pipeline. Opcionalmente, você pode filtrar as execuções exibidas.

Selecione uma execução de pipeline para exibir informações sobre essa execução.

Você pode optar por Reter ou Excluir uma execução no menu de contexto. Para obter mais informações sobre retenção de execução, consulte Políticas de retenção de build e versão.

Exibir detalhes do pipeline

A página de detalhes de um pipeline permite que você exiba e gerencie esse pipeline.

Escolha Editar para editar o pipeline. Para obter mais informações, confira o editor de pipeline do YAML. Você também pode editar seu pipeline modificando o arquivo azure-pipelines.yml diretamente no repositório que hospeda o pipeline.

Exibir detalhes da execução do pipeline

No resumo da execução do pipeline, você pode exibir o status da sua execução tanto durante a execução quanto quando ela estiver concluída.

No painel de resumo, você pode exibir detalhes do trabalho e do estágio, baixar artefatos e navegar até confirmações vinculadas, resultados de teste e itens de trabalho.

Trabalhos e fases

O painel de trabalhos exibe uma visão geral do status de suas fases e trabalhos. Esse painel pode ter várias guias dependendo de o pipeline ter fases e trabalhos ou apenas trabalhos. Neste exemplo, o pipeline tem dois estágios chamados Build e Implantar. Você pode detalhar as etapas do pipeline escolhendo o trabalho no painel Fases ou Trabalhos.

Escolha um trabalho para ver as etapas desse trabalho.

Na exibição de etapas, você pode examinar o status e os detalhes de cada etapa. Em Mais ações, você pode alternar carimbos de data/hora ou exibir um log bruto de todas as etapas no pipeline.

Cancelar e executar novamente um pipeline

Se o pipeline estiver em execução, você poderá cancelá-lo escolhendo Cancelar. Se a execução tiver sido concluída, você poderá executar novamente o pipeline escolhendo Executar novamente.

Menu Mais ações da execução de pipeline

No menu Mais ações, você pode baixar logs, adicionar marcas, editar o pipeline, excluir a execução e configurar retenção na execução.

Adicionar um selo de status ao repositório

Muitos desenvolvedores gostam de mostrar que estão mantendo a qualidade do código alta exibindo uma notificação de status em seu repositório.

Para copiar o selo de status para a área de transferência:

1. No Azure Pipelines, acesse a página Pipelines para exibir a lista de pipelines. Selecione o pipeline criado na seção anterior.

2. Selecione e, em seguida, Selo de status.

3. Selecione Selo de status.

4. Copie o Markdown de exemplo da seção Markdown de exemplo.

Agora, com o selo Markdown na área de transferência, execute as seguintes etapas no GitHub:

1. Acesse a lista de arquivos e selecione Readme.md. Selecione o ícone de lápis para editar.

2. Cole o selo de status Markdown no início do arquivo.

3. Confirme a alteração no branch main.

4. Observe que o selo status aparece na descrição do repositório.

Para configurar o acesso anônimo a selos para projetos privados:

1. Navegue até Configurações do projeto no canto inferior esquerdo da página

2. Abra a guia Configurações em Pipelines

3. Alterne o controle deslizante Desabilitar acesso anônimo a selos em Geral

Como você acabou de alterar o arquivo Readme.md nesse repositório, o Azure Pipelines compila automaticamente seu código, de acordo com a configuração no arquivo azure-pipelines.yml na raiz do repositório. No Azure Pipelines, observe que uma nova execução é exibida. Sempre que você fizer uma edição, o Azure Pipelines iniciará uma nova execução.

Mostraremos como usar o editor clássico no Azure DevOps Server 2019 para criar um build e uma versão que imprime "Olá, mundo".

1. Acesse Azure Repos. (O hub de Códigos na navegação anterior)

   

2. Se o projeto estiver vazio, você será saudado com uma tela para ajudá-lo a adicionar código ao repositório. Escolha a opção inferior para inicializar seu repositório com um arquivo readme:

   

1. Acesse Azure Repos.

2. Adicione um arquivo.

   

3. Na caixa de diálogo, nomeie o novo arquivo e crie-o.

   HelloWorld.ps1
   

4. Copie e cole este script.

   Write-Host "Hello world"
   

5. Confirme (salve) o arquivo.

1. Selecione Azure Pipelines, o que deve direcioná-lo automaticamente para a página Builds.

   

2. Criar um pipeline.

   

   Para novos usuários do Azure DevOps, isso levará você automaticamente à experiência de criação do pipeline YAML. Para acessar o editor clássico e concluir este guia, você deve desativar a versão prévia do recurso para a Nova experiência de criação de pipeline YAML:

   

   

3. Verifique se a origem, o projeto, o repositório e o branch padrão correspondem ao local onde você criou o script.

4. Começar um Trabalho vazio.

5. No lado esquerdo, selecione Pipeline e especifique o Nome que você deseja usar. Para o pool de agentes, selecione VS2017 hospedado.

6. No lado esquerdo, selecione o sinal de adição ( + ) para adicionar uma tarefa ao Trabalho 1. No lado direito, selecione a categoria Utilitário, selecione a tarefa do PowerShell na lista e escolha Adicionar.

   

7. No lado esquerdo, selecione sua nova tarefa de script do PowerShell.

8. Para o argumento Caminho do Script, selecione o botão para procurar o repositório e selecione o script que você criou.

   

9. Selecione Salvar e colocar na fila selecione Salvar.

1. Na guia Tarefas, selecione o sinal de adição ( + ) para adicionar uma tarefa ao Trabalho 1.

2. Selecione a categoria Utilitário, a tarefa Publicar Artefatos de Build e, em seguida, Adicionar.

   

   Caminho para publicar: selecione o botão para navegar e selecionar o script criado.

   Nome do artefato: insira drop.

   Local de publicação do artefato: selecione Azure Artifacts/TFS.

1. Selecione Salvar e colocar na fila e, em seguida, selecione Salvar e colocar na fila.

2. Na caixa de diálogo, selecione Salvar e colocar na fila mais uma vez.

   Isso enfileira um novo build no agente hospedado pela Microsoft.

3. Você verá um link para o novo build na parte superior da página.

   

   Escolha o link para ver o novo build em ação. Assim que o agente for alocado, você começará a ver os logs dinâmicos do build. Observe que o script do PowerShell é executado como parte do build e que "Olá, mundo" é impresso no console.

   

4. Acesse o resumo do build. Na guia Artefatos do build, observe que o script é publicado como um artefato.

   

Agora você pode ver os resultados de suas alterações. Acesse Azure Pipelines e selecione Na fila. Observe na seção Na fila ou em execução que um build é disparado automaticamente pela alteração confirmada.

1. Acesse a guia Pipelines e selecione Versões.

2. Selecione a ação para criar um Novo pipeline. Se um pipeline de lançamento já tiver sido criado, selecione o sinal de adição ( + ) e, em seguida, selecione Criar um pipeline de lançamento.

3. Selecione a ação para começar com um Trabalho vazio.

4. Nomeie a fase garantia de qualidade.

5. No painel Artefatos, selecione + Adicionar e especifique uma Origem (pipeline de build). Selecione Adicionar.

6. Selecione o Raio para disparar a implantação contínua e habilite o Gatilho de implantação contínua à direita.

   

7. Selecione a guia Tarefas e a fase garantia de qualidade.

8. Selecione o sinal de adição ( + ) do trabalho para adicionar uma tarefa a ele.

9. Na caixa de diálogo Adicionar tarefas, selecione Utilitário, localize a tarefa do PowerShell e, em seguida, selecione o botão Adicionar.

10. No lado esquerdo, selecione sua nova tarefa de script do PowerShell.

11. Para o argumento Caminho do Script, selecione o botão para procurar os artefatos e selecione o script que você criou.

12. Adicione estes Argumentos:

    -greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"
    

13. Na guia Pipeline, selecione a fase garantia de qualidade e Clonar.

    

14. Renomeie a fase clonado como Produção.

15. Renomeie o pipeline de lançamento Olá, Mundo.

    

16. Salve o pipeline de lançamento.

1. Crie uma versão.

   

   Quando Criar nova versão for exibido, selecione Criar.

2. Abra a versão que você criou.

   

3. Exiba os logs para obter dados em tempo real sobre a versão.

   

Você aprendeu a criar seu primeiro pipeline no Azure. Agora, saiba mais sobre como configurar pipelines na sua linguagem preferida:

• .NET Core
• Go
• Java
• Node.js
• Python
• Contêineres

Ou você pode prosseguir para personalizar o pipeline que você acabou de criar.

Para executar o pipeline em um contêiner, confira Trabalhos de contêiner.

Para obter detalhes sobre como criar repositórios do GitHub, consulte Compilar repositórios do GitHub.

Para saber como publicar seus Artefatos de Pipeline, confira Publicar Artefatos de Pipeline.

Para saber o que mais você pode fazer em pipelines do YAML, confira referência de esquema do YAML.

Limpar

Se você tiver criado pipelines de teste, eles podem ser facilmente excluídos quando você terminar de usá-los.

az pipelines list [--detect {false, true}]
                  [--folder-path]
                  [--name]
                  [--org]
                  [--project]
                  [--query-order {ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None}]
                  [--repository]
                  [--repository-type {bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol}]
                  [--top]

az pipelines delete --id
                    [--detect {false, true}]
                    [--org]
                    [--project]
                    [--yes]

az pipelines list --output table

ID    Path    Name           Status    Default Queue
----  ------  -------------  --------  ------------------
6     \       FabrikamFiber  enabled   Hosted Ubuntu 1604

az pipelines delete --id 6

Are you sure you want to delete this pipeline? (y/n): y
Pipeline 6 was deleted successfully.

• Clientes

  • Visual Studio Code para Windows, macOS e Linux
  • Visual Studio com Git para Windows ou Visual Studio para Mac
  • Eclipse
  • Xcode
  • IntelliJ
  • Linha de comando

• Serviços

  • Azure Pipelines
  • Provedores de serviços Git, como Azure Repos Git, GitHub e Bitbucket Cloud
  • Subversion

Como replicar um pipeline?

Se o pipeline tiver um padrão que você deseja replicar em outros pipelines, clone-o, exporte-o ou salve-o como um modelo.

Depois de clonar um pipeline, você pode fazer alterações e salvá-lo.

Depois de exportar um pipeline, você pode importá-lo da guia Todos os pipelines.

Depois de criar um modelo, os membros da equipe podem usá-lo para seguir o padrão em novos pipelines.

Como eu trabalho com rascunhos?

Se você estiver editando um pipeline de build e quiser testar algumas alterações que ainda não estão prontas para produção, salve-o como um rascunho.

O que mais posso fazer quando colocar um build em fila?

Você pode colocar builds automaticamente ou manualmente na fila.

Ao colocar manualmente um build na fila, você pode, para uma única execução do build:

• Especificar o pool para o qual o build será direcionado.

• Adicionar e modificar algumas variáveis.

• Adicionar demandas.

• Em um repositório Git

  • Criar um branch ou uma marca.

  • Criar um commit.

Para saber mais sobre as configurações do pipeline, confira:

• Obtendo fontes
• Tarefas
• Variáveis
• Gatilhos
• Retenção
• Histórico

Como criar um pipeline de build programaticamente?

Referência da API REST: criar um pipeline de build