Crie seu primeiro pipeline

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

Este é um guia passo a passo para usar o Azure Pipelines para criar um aplicativo de exemplo. Este guia usa pipelines YAML configurados com o editor de pipeline YAML. Se você quiser usar pipelines clássicos em vez disso, consulte Definir seu pipeline Clássico.

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. Você pode comprar um trabalho paralelo ou solicitar uma camada gratuita.

Crie seu primeiro pipeline

Java

Obter o código de exemplo java

Para começar, crie um fork do repositório a seguir em sua conta do GitHub.

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

Criar seu primeiro pipeline java

1. Entre em sua organização do Azure DevOps e acesse seu projeto.

2. Acesse Pipelines e selecione Novo pipeline.

3. Percorra as etapas do assistente selecionando primeiro o GitHub como o local do código-fonte.

4. Você pode ser redirecionado para o GitHub para então entrar. Nesse caso, insira suas credenciais do GitHub.

5. Quando a lista de repositórios for exibida, selecione o repositório.

6. Você poderá ser redirecionado ao GitHub para instalar o aplicativo do Azure Pipelines. Nesse caso, selecione Aprovar & instalar.

7. O Azure Pipelines analisará seu repositório e recomendará o modelo de pipeline do Maven .

8. Quando o novo pipeline for exibido, observe o YAML para ver o que ele faz. Ao final, selecione Salvar e executar.

9. Você será solicitado a confirmar um novo azure-pipelines.yml arquivo em seu repositório. Depois de ficar satisfeito com a mensagem, selecione Salvar e executar novamente.

   Se você quiser observar o pipeline em ação, selecione o trabalho de build.

   Você acabou de criar e executar um pipeline que criamos automaticamente para você, pois seu código parecia ser uma boa correspondência para o modelo do Maven .

   Agora você tem um pipeline YAML funcional (azure-pipelines.yml) em seu repositório que está pronto para personalizar!

10. Quando estiver pronto para fazer alterações no pipeline, selecione-o na página Pipelines e, em seguida, Edite o azure-pipelines.yml arquivo.

Saiba mais sobre como trabalhar com Java em seu pipeline.

.NET

Obter o código de exemplo do .NET

Para começar, crie um fork do repositório a seguir em sua conta do GitHub.

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

Criar seu primeiro pipeline do .NET Core

1. Entre em sua organização do Azure DevOps e acesse seu projeto.

2. Acesse Pipelines e selecione Novo pipeline.

3. Percorra as etapas do assistente selecionando primeiro o GitHub como o local do código-fonte.

4. Você pode ser redirecionado para o GitHub para então entrar. Nesse caso, insira suas credenciais do GitHub.

5. Quando a lista de repositórios for exibida, selecione o repositório.

6. Você poderá ser redirecionado ao GitHub para instalar o aplicativo do Azure Pipelines. Nesse caso, selecione Aprovar & instalar.

7. O Azure Pipelines analisará seu repositório e recomendará o modelo de pipeline ASP.NET Core.

8. Quando o novo pipeline for exibido, observe o YAML para ver o que ele faz. Ao final, selecione Salvar e executar.

9. Você será solicitado a confirmar um novo azure-pipelines.yml arquivo em seu repositório. Depois de ficar satisfeito com a mensagem, selecione Salvar e executar novamente.

   Se você quiser observar o pipeline em ação, selecione o trabalho de build.

   Você acabou de criar e executar um pipeline que criamos automaticamente para você, pois seu código parecia ser uma boa correspondência para o modelo de ASP.NET Core.

   Agora você tem um pipeline YAML funcional (azure-pipelines.yml) em seu repositório que está pronto para personalizar!

10. Quando estiver pronto para fazer alterações no pipeline, selecione-o na página Pipelines e, em seguida, Edite o azure-pipelines.yml arquivo.

Saiba mais sobre como trabalhar com o .NET Core em seu pipeline.

Python

Obter o código de exemplo do Python

Para começar, crie um fork do repositório a seguir em sua conta do GitHub.

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

Criar seu primeiro pipeline do Python

1. Entre em sua organização do Azure DevOps e acesse seu projeto.

2. Acesse Pipelines e selecione Novo pipeline.

3. Percorra as etapas do assistente selecionando primeiro o GitHub como o local do código-fonte.

4. Você pode ser redirecionado para o GitHub para então entrar. Nesse caso, insira suas credenciais do GitHub.

5. Quando a lista de repositórios for exibida, selecione o repositório.

6. Você poderá ser redirecionado ao GitHub para instalar o aplicativo do Azure Pipelines. Nesse caso, selecione Aprovar & instalar.

7. O Azure Pipelines analisará seu repositório e recomendará o modelo de pipeline de pacote do Python .

8. Quando o novo pipeline for exibido, observe o YAML para ver o que ele faz. Ao final, selecione Salvar e executar.

9. Você será solicitado a confirmar um novo azure-pipelines.yml arquivo em seu repositório. Depois de ficar satisfeito com a mensagem, selecione Salvar e executar novamente.

   Se você quiser observar o pipeline em ação, selecione o trabalho de build.

   Você acabou de criar e executar um pipeline que criamos automaticamente para você, pois seu código parecia ser uma boa correspondência para o modelo de pacote do Python .

   Agora você tem um pipeline YAML funcional (azure-pipelines.yml) em seu repositório que está pronto para personalizar!

10. Quando estiver pronto para fazer alterações no pipeline, selecione-o na página Pipelines e, em seguida, Edite o azure-pipelines.yml arquivo.

Saiba mais sobre como trabalhar com o Python em seu pipeline.

JavaScript

Obter o código de exemplo do JavaScript

Para começar, crie um fork do repositório a seguir em sua conta do GitHub.

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

Criar seu primeiro pipeline do JavaScript

1. Entre em sua organização do Azure DevOps e acesse seu projeto.

2. Acesse Pipelines e selecione Novo pipeline.

3. Percorra as etapas do assistente selecionando primeiro o GitHub como o local do código-fonte.

4. Você pode ser redirecionado para o GitHub para então entrar. Nesse caso, insira suas credenciais do GitHub.

5. Quando a lista de repositórios for exibida, selecione o repositório.

6. Você poderá ser redirecionado ao GitHub para instalar o aplicativo do Azure Pipelines. Nesse caso, selecione Aprovar & instalar.

7. O Azure Pipelines analisará seu repositório e recomendará o modelo de pipelineNode.js .

8. Quando o novo pipeline for exibido, observe o YAML para ver o que ele faz. Ao final, selecione Salvar e executar.

9. Você será solicitado a confirmar um novo azure-pipelines.yml arquivo em seu repositório. Depois de ficar satisfeito com a mensagem, selecione Salvar e executar novamente.

   Se você quiser assistir ao pipeline em ação, selecione o trabalho de build.

   Você acabou de criar e executou um pipeline que criamos automaticamente para você, pois seu código parecia ser uma boa correspondência para o modelo deNode.js .

   Agora você tem um pipeline YAML em funcionamento (azure-pipelines.yml) em seu repositório pronto para personalizar!

10. Quando estiver pronto para fazer alterações no pipeline, selecione-o na página Pipelines e edite o azure-pipelines.yml arquivo.

Saiba mais sobre como trabalhar com JavaScript em seu pipeline.

CLI do Azure (Java)

1. Em um prompt de comando, entre na CLI do Azure.

   az login
   

2. Bifurque o seguinte repositório em sua conta do GitHub:

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

   Depois de bifurcar, clone-o no computador de desenvolvimento. Saiba como: bifurcar um repositório.

3. Navegue até o diretório clonado.

4. Crie um novo pipeline:

   az pipelines create --name "First-Java.CI"
   

   Os detalhes do repositório e do branch são obtidos na configuração do git disponível no diretório clonado.

5. Se solicitado, insira o nome de usuário e a senha do GitHub para autenticar o Azure Pipelines.

   Enter your GitHub username (Leave blank for using already generated PAT): 
   Enter your GitHub password:
   

6. Adicione um nome, ContosoPipelineServiceConnection, para a conexão de serviço criada para permitir que o Azure Pipelines se comunique com o Repositório GitHub.

   Enter a service connection name to create? ContosoPipelineServiceConnection
   

7. Selecione o modelo de pipeline do Maven na lista de modelos recomendados.

   Which template do you want to use for this pipeline?
   [1] Maven
   [2] Maven package Java project Web App to Linux on Azure
   [3] Android
   [4] Ant
   [5] ASP.NET
   [6] ASP.NET Core
   [7] ASP .NET Core (.NET Framework)
   [8] Starter pipeline
   [9] C/C++ with GCC
   [10] Go
   [11] Gradle
   [12] HTML
   [13] Jekyll site
   [14] .NET Desktop
   [15] Node.js
   [16] Node.js with Angular
   [17] Node.js with Grunt
   [18] Node.js with gulp
   [19] Node.js with React
   [20] Node.js with Vue
   [21] Node.js with webpack
   [22] PHP
   [23] Python Django
   [24] Python package
   [25] Ruby
   [26] Universal Windows Platform
   [27] Xamarin.Android
   [28] Xamarin.iOS
   [29] Xcode
   Please enter a choice [Default choice(1)]:
   

8. Selecione 2 para exibir o YAML no editor padrão e fazer alterações.

   Do you want to view/edit the template yaml before proceeding?
   [1] Continue with the generated yaml
   [2] View or edit the yaml
   Please enter a choice [Default choice(1)]:2
   

9. Selecione 1 para confirmar o arquivo YAML no branch principal.

   How do you want to commit the files to the repository?
   [1] Commit directly to the main branch.
   [2] Create a new branch for this commit and start a pull request.
   Please enter a choice [Default choice(1)]:
   

10. O Azure DevOps iniciará automaticamente uma execução de pipeline. Aguarde a conclusão da execução.

Exibir e gerenciar seus pipelines

Você pode exibir e gerenciar seus pipelines escolhendo Pipelines no menu à esquerda para ir para 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 em pipeline e executar detalhes.

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 a 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, consulte Editor de pipeline yaml.

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 de trabalho e estágio, baixar artefatos e navegar até confirmações vinculadas, resultados de teste e itens de trabalho.

Trabalhos e fases

O painel trabalhos exibe uma visão geral do status de seus estágios e trabalhos. Esse painel pode ter várias guias dependendo se o pipeline tem estágios e trabalhos ou apenas trabalhos. Neste exemplo, o pipeline tem dois estágios chamados Compilar e Implantar. Você pode detalhar as etapas do pipeline escolhendo o trabalho no painel Estágios 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 novo.

Menu Executar mais ações do pipeline

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

Observação

Você não poderá excluir uma execução se a execução for mantida. Se você não vir Excluir, escolha Parar de manter a execução e exclua a execução. Se você vir as versões Excluir e Exibir retenção, uma ou mais políticas de retenção configuradas ainda se aplicam à sua execução. Escolha Exibir versões de retenção, exclua as políticas (somente as políticas para a execução selecionada são removidas) e exclua a execução.

Adicionar um selo de status ao seu 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 sua área de transferência:

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

2. Selecione e, em seguida, selecione 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 em sua área de transferência, execute as seguintes etapas no GitHub:

1. Vá para a lista de arquivos e selecione Readme.md. Selecione o ícone de lápis a ser editado.

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

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

4. Observe que o selo de 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

2. Abra a guia Configurações em Pipelines

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

Observação

Mesmo em um projeto privado, o acesso anônimo a selos é habilitado por padrão. Com o acesso de selo anônimo habilitado, os usuários fora da sua organização podem consultar informações como nomes de projeto, nomes de ramificação, nomes de trabalho e status de build por meio da API de status de selo.

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

Observação

Em Microsoft Team Foundation Server (TFS) 2018 e versões anteriores, pipelines de build e lançamento são chamados de definições, execuções são chamadas de builds, conexões de serviço são chamadas de pontos de extremidade de serviço, estágios são chamados de ambientes e trabalhos são chamados de fases.

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

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

Pré-requisitos

• Um agente do Windows auto-hospedado.

Inicializar seu repositório

Se você já tiver um repositório em seu projeto, poderá pular para a próxima etapa: Ignorar para adicionar um script ao repositório

1. Vá para Azure Repos. (O hub de código na navegação anterior)

   

2. Se o projeto estiver vazio, você será recebido 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 readme arquivo:

   

1. Navegue até o repositório clicando em Código na navegação superior.

2. Se o projeto estiver vazio, você será recebido 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 readme arquivo:

   

Adicionar um script ao repositório

Crie um script do PowerShell que imprime Hello world.

1. Vá para 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. Vá para o Hub de código .

2. Adicione um arquivo.

TFS 2018.2

TFS 2018 RTM

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

   HelloWorld.ps1
   

2. Copie e cole este script.

   Write-Host "Hello world"
   

3. Confirme (salve) o arquivo.

Neste tutorial, nosso foco está na CI/CD, portanto, estamos mantendo a parte de código simples. Estamos trabalhando em um repositório Git Azure Repos diretamente no navegador da Web.

Quando estiver pronto para começar a criar e implantar um aplicativo real, você poderá usar uma ampla variedade de clientes e serviços de controle de versão com builds de CI do Azure Pipelines. Saiba mais.

Criar um pipeline de build

Crie um pipeline de build que imprime "Olá, mundo".

1. Selecione Azure Pipelines, ele deve levá-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 o recurso de visualização 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 em que você criou o script.

4. Comece com 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 & colocar na fila e, em seguida, selecione Salvar.

10. Selecione Compilar e Liberar e, em seguida, escolha Builds.

    

11. Criar um pipeline.

    

12. Começar com um pipeline vazio

13. Selecione Pipeline e especifique o Nome que você deseja usar. Para o pool de agentes, selecione Padrão.

14. No lado esquerdo, selecione + Adicionar Tarefa para adicionar uma tarefa ao trabalho e, no lado direito, selecione a categoria Utilitário , selecione a tarefa do PowerShell e escolha Adicionar.

    

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

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

    

17. Selecione Salvar & colocar na fila e, em seguida, selecione Salvar.

Um pipeline de build é a entidade por meio da qual você define seu pipeline de build automatizado. No pipeline de build, você compõe um conjunto de tarefas, cada uma delas executando uma etapa em seu build. O catálogo de tarefas fornece um conjunto avançado de tarefas para você começar. Você também pode adicionar scripts do PowerShell ou do shell ao pipeline de build.

Publicar um artefato de sua compilação

Um build típico produz um artefato que pode ser implantado em vários estágios em uma versão. Aqui, para demonstrar a funcionalidade de maneira simples, simplesmente publicaremos o script como o artefato.

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

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

   

   Caminho a ser publicado: selecione o botão para navegar e selecione o script que você criou.

   Nome do artefato: insira drop.

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

1. Na guia Tarefas , selecione Adicionar Tarefa.

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

   

   Caminho para Publicar: selecione o botão para navegar e selecione o script que você criou.

   Nome do artefato: insira drop.

   Tipo de artefato: selecione Servidor.

Artefatos são os arquivos que você deseja que seu build produza. Artefatos podem ser quase tudo o que sua equipe precisa para testar ou implantar seu aplicativo. Por exemplo, você tem um .DLL e .EXE arquivos executáveis e . Arquivo de símbolos PDB de um aplicativo C# ou C++ .NET do Windows.

Para permitir que você produza artefatos, fornecemos ferramentas como copiar com correspondência de padrões e um diretório de preparo no qual você pode coletar seus artefatos antes de publicá-los. Confira Artefatos no Azure Pipelines.

Habilitar a CI (integração contínua)

1. Selecione a guia Gatilhos.

2. Habilitar a integração contínua.

Um gatilho de integração contínua em um pipeline de build indica que o sistema deve enfileirar automaticamente um novo build sempre que uma alteração de código for confirmada. Você pode tornar o gatilho mais geral ou mais específico e também agendar seu build (por exemplo, à noite). Confira Gatilhos de build.

Salvar e enfileirar o build

Salve e enfileira um build manualmente e teste o pipeline de build.

1. Selecione Salvar & fila e, em seguida, selecione Salvar & fila.

2. Na caixa de diálogo, selecione Salvar & 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 assistir ao novo build como ele acontece. Depois 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. Vá para o resumo do build. Na guia Artefatos do build, observe que o script é publicado como um artefato.

   

1. Selecione Salvar & fila e, em seguida, selecione Salvar & fila.

2. Na caixa de diálogo, selecione Salvar & 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 assistir ao novo build como ele acontece. Depois 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.

   TFS 2018.2

   

   TFS 2018 RTM

   

---

4. Vá para o resumo do build.

   

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

   

Você pode exibir um resumo de todos os builds ou detalhar os logs de cada build a qualquer momento navegando até a guia Builds no Azure Pipelines. Para cada build, você também pode exibir uma lista de commits que foram criados e os itens de trabalho associados a cada commit. Você também pode executar testes em cada build e analisar as falhas de teste.

Adicionar algumas variáveis e confirmar uma alteração no script

Passaremos algumas variáveis de build para o script para tornar nosso pipeline um pouco mais interessante. Em seguida, confirmaremos uma alteração em um script e veremos o pipeline de CI ser executado automaticamente para validar a alteração.

1. Edite o pipeline de build.

2. Na guia Tarefas , selecione a tarefa de script do PowerShell.

3. Adicione esses argumentos.

TFS 2018.2

TFS 2018 RTM

Argumentos

-greeter "$(Build.RequestedFor)" -trigger "$(Build.Reason)"

Por fim, salve o pipeline de build.

Em seguida, você adicionará os argumentos ao script.

1. Vá para seus Arquivos em Azure Repos (o Hub de código na navegação anterior e TFS).

2. Selecione o arquivo HelloWorld.ps1 e edite o arquivo.

3. Altere o script da seguinte maneira:

   Param(
   [string]$greeter,
   [string]$trigger
   )
   Write-Host "Hello world" from $greeter
   Write-Host Trigger: $trigger
   

4. Confirme (salve) o script.

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

Agora você pode ver os resultados de suas alterações. Vá para a página Compilar e Liberar e selecione Enfileirado. Observe na seção Enfileirado ou em execução que um build é disparado automaticamente pela alteração confirmada.

1. Selecione o novo build que foi criado e exiba seu log.

2. Observe que a pessoa que alterou o código tem seu nome impresso na mensagem de saudação. Você também vê impresso que esse era um build de CI.

Acabamos de introduzir o conceito de variáveis de build nestas etapas. Imprimimos o valor de uma variável que é automaticamente predefinida e inicializada pelo sistema. Você também pode definir variáveis personalizadas e usá-las em argumentos para suas tarefas ou como variáveis de ambiente em seus scripts. Para saber mais sobre variáveis, consulte Criar variáveis.

Você tem um pipeline de build. O que vem a seguir?

Você criou um pipeline de build que compila e valida automaticamente qualquer código que seja verificado pela sua equipe. Neste ponto, você pode continuar para a próxima seção para saber mais sobre pipelines de lançamento. Ou, se preferir, você pode pular para criar um pipeline de build para seu aplicativo.

Criar um pipeline de lançamento

Defina o processo para executar o script em dois estágios.

1. Vá para a guia Pipelines e selecione Versões.

2. Selecione a ação para criar um novo pipeline. Se um pipeline de lançamento já estiver 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 o estágio QA.

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 selecione o estágio de QA .

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

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 seus artefatos e selecione o script que você criou.

12. Adicione estes argumentos:

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

13. Na guia Pipeline , selecione o estágio de QA e selecione Clonar.

    

14. Renomeie o estágio clonado Produção.

15. Renomeie o pipeline de lançamento Hello world.

    

16. Salve o pipeline de lançamento.

1. Vá para a guia Compilar e Liberar 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 uma definição de versão.

3. Selecione a ação para começar com uma definição Vazia.

4. Nomeie o estágio QA.

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.

   TFS 2018.2

   

   TFS 2018 RTM

   

---

7. Selecione a guia Tarefas e selecione o estágio de PR .

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

9. Na caixa de diálogo Adicionar tarefas , selecione Utilitário, localize a tarefa do PowerShell e 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 seus artefatos e selecione o script que você criou.

12. Adicione estes argumentos:

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

13. Na guia Pipeline , selecione o estágio qa e selecione Clonar.

    

14. Renomeie o estágio clonado Produção.

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

    

16. Salve o pipeline de lançamento.

Um pipeline de lançamento é uma coleção de estágios nos quais os artefatos de build do aplicativo são implantados. Ele também define o pipeline de implantação real para cada estágio, bem como como os artefatos são promovidos de um estágio para outro.

Além disso, observe que usamos algumas variáveis em nossos argumentos de script. Nesse caso, usamos variáveis de versão em vez das variáveis de build que usamos para o pipeline de build.

Implantar uma versão

Execute o script em cada estágio.

1. Crie uma nova versão.

   

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

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

   

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

   

4. Crie uma nova versão.

   

   Quando Criar nova versão for exibida, selecione Criar (TFS 2018.2) ou Fila (TFS 2018 RTM).

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

   

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

   

Você pode acompanhar o progresso de cada versão para ver se ela foi implantada em todos os estágios. Você pode acompanhar os commits que fazem parte de cada versão, os itens de trabalho associados e os resultados de todas as execuções de teste que você adicionou ao pipeline de lançamento.

Alterar o código e vê-lo ser implantado automaticamente na produção

Faremos mais uma alteração no script. Desta vez, ele será compilado automaticamente e, em seguida, será implantado até o estágio de produção.

1. Acesse o Hub de código , a guia Arquivos , edite o arquivo HelloWorld.ps1 e altere-o da seguinte maneira:

   Param(
   [string]$greeter,
   [string]$trigger
   )
   Write-Host "Hello world" from $greeter
   Write-Host Trigger: $trigger
   Write-Host "Now that you've got CI/CD, you can automatically deploy your app every time your team checks in code."
   

2. Confirme (salve) o script.

3. Selecione a guia Builds para ver o build enfileirado e executado.

4. Depois que o build for concluído, selecione a guia Versões , abra a nova versão e vá para Os Logs.

Seu novo código é implantado automaticamente no estágio de QA e, em seguida, no estágio produção .

Em muitos casos, você provavelmente gostaria de editar o pipeline de lançamento para que a implantação de produção ocorra somente depois que alguns testes e aprovações estiverem em vigor. Confira Visão geral de aprovações e portões.

Próximas etapas

Você acabou de aprender a criar seu primeiro pipeline no Azure. Saiba mais sobre como configurar pipelines na linguagem de sua escolha:

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

Ou você pode continuar a personalizar o pipeline que acabou de criar.

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

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

Para saber como publicar seus artefatos de pipeline, consulte Publicar artefatos de pipeline.

Para descobrir o que mais você pode fazer em pipelines YAML, confira Referência de esquema YAML.

Limpar

Se você criou pipelines de teste, eles serão fáceis de excluir quando você terminar de usá-los.

Navegador

Para excluir um pipeline, navegue até a página de resumo desse pipeline e escolha Excluir no menu ... no canto superior direito da página. Digite o nome do pipeline para confirmar e escolha Excluir.

CLI do Azure DevOps

Para excluir um pipeline usando a CLI do Azure, você pode usar o comando az pipeline delete . Esse comando requer que o id do pipeline seja excluído, o que você pode obter usando o comando az pipeline list .

Listar pipelines | Excluir pipeline | Exemplo

Observação

Se esta for a primeira vez que você usa comandos az pipelines , consulte Introdução à CLI do Azure DevOps.

Listar pipelines

Você pode listar seus pipelines usando o comando az pipelines list .

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]

Parâmetros

• detect: detectar automaticamente a organização. Valores aceitos: false, true
• folder-path: se especificado, filtra as definições nessa pasta.
• name: limite os resultados a pipelines com esse nome ou começando com esse nome. Exemplos: "FabCI" ou "Fab*".
• organização ou organização: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. Exemplo: https://dev.azure.com/MyOrganizationName/.
• project ou p: nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git.
• query-order: Ordem dos resultados. Valores aceitos: ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None
• repositório: limite os resultados a pipelines associados a esse repositório.
• repositório-type: limite os resultados a pipelines associados a esse tipo de repositório. É obrigatório passar o argumento do repositório junto com esse argumento. Valores aceitos: bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol
• top: número máximo de pipelines a serem listados.

Excluir pipeline

Você pode excluir um pipeline usando o comando az pipelines delete .

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

Parâmetros

• id: (Obrigatório) ID do pipeline.
• detect: detectar automaticamente a organização. Valores aceitos: false, true
• organização ou organização: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. Exemplo: https://dev.azure.com/MyOrganizationName/.
• project ou p: nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git.
• sim ou y: não solicite confirmação.

Exemplo

O exemplo a seguir lista pipelines no formato de tabela e exclui o pipeline com uma ID de 6. Este exemplo usa a seguinte configuração padrão: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

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.

Você aprendeu os conceitos básicos de criação e execução de um pipeline. Agora você está pronto para configurar seu pipeline de build para a linguagem de programação que está usando. Vá em frente e crie um pipeline de build e, desta vez, use um dos modelos a seguir.

Idioma	Modelo a ser usado
.NET	ASP.NET
.NET Core	ASP.NET Core
C++	Área de trabalho do .NET
Go	Go
Java	Gradle
JavaScript	Node.js
Xcode	Xcode

Perguntas frequentes

Onde posso ler artigos sobre DevOps e CI/CD?

O que é a Integração Contínua?

O que é Entrega Contínua?

O que é DevOps?

Qual sistema de controle de versão posso usar?

Quando estiver pronto para começar a usar CI/CD para seu aplicativo, você poderá usar o sistema de controle de versão de sua escolha:

• 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 GitHub e Bitbucket Cloud
  • Subversion

• Clientes

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

• Serviços

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

Como fazer 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.

Dica

Se você estiver usando o Novo Editor de Build, seus modelos personalizados serão mostrados na parte inferior da lista.

Como fazer trabalhar 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, poderá salvá-lo como um rascunho.

Você pode editar e testar seu rascunho conforme necessário.

Quando estiver pronto, você poderá publicar o rascunho para mesclar as alterações no pipeline de build.

Ou, se você decidir descartar o rascunho, poderá excluí-lo da guia Todos os Pipelines mostrada acima.

Como posso excluir um pipeline?

Para excluir um pipeline, navegue até a página de resumo desse pipeline e escolha Excluir no menu ... no canto superior direito da página. Digite o nome do pipeline para confirmar e escolha Excluir.

O que mais posso fazer quando enfileirar um build?

Você pode enfileirar builds automaticamente ou manualmente.

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

• Especifique o pool no qual o build vai.

• Adicione e modifique algumas variáveis.

• Adicionar demandas.

• Em um repositório Git

  • Crie um branch ou uma marca.

  • Crie um commit.

• Em um repositório TFVC

  • Especifique a versão de origem como um rótulo ou conjunto de alterações.

  • Execute uma compilação privada de um conjunto de prateleiras. (Você pode usar essa opção em um agente hospedado pela Microsoft ou em um agente auto-hospedado.)

Você pode enfileirar builds automaticamente ou manualmente.

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

• Especifique o pool no qual o build vai.

• Adicione e modifique algumas variáveis.

• Adicionar demandas.

• Em um repositório Git

  • Crie um branch ou uma marca.

  • Crie um commit.

Onde posso saber mais sobre as configurações de pipeline?

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

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

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

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

Como fazer criar programaticamente um pipeline de build?

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

Observação

Você também pode gerenciar builds e pipelines de build na linha de comando ou scripts usando a CLI do Azure Pipelines.