Crie o seu primeiro pipeline

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

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

Se preferir usar pipelines Clássicos, consulte Definir o seu pipeline Clássico. Para obter orientação sobre como usar o TFVC, consulte Criar repositórios TFVC.

Pré-requisitos - Azure DevOps

Certifique-se de que tem os itens seguintes:

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

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

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

Crie o 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

Visualize e gerencie seus pipelines

Você pode visualizar e gerenciar seus pipelines escolhendo Pipelines no menu à esquerda para ir para a página inicial de pipelines.

Na página inicial de pipelines, você pode visualizar pipelines e execuções de pipeline, criar e importar pipelines, gerenciar a segurança e detalhar os 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 compilação para a última execução para exibir os resultados dessa compilação, selecione o nome da ramificação para exibir a ramificação 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. Pode, opcionalmente, filtrar as corridas exibidas.

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

Você pode optar por Manter 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 compilação e lançamento.

Ver detalhes do pipeline

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

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

Ver detalhes da execução do pipeline

No resumo da execução do pipeline, é possível visualizar o estado da execução tanto enquanto está em curso quanto quando está 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 estágios

O painel de trabalhos exibe uma visão geral do status de seus estágios e trabalhos. Este painel pode ter várias abas, dependendo de o seu pipeline ter estágios e trabalhos, ou apenas trabalhos. Neste exemplo, o pipeline tem dois estágios chamados Build e Deploy. 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 visualização de etapas, você pode revisar o status e os detalhes de cada etapa. Mais ações, pode alternar timestamps ou exibir um registo bruto de todas as etapas no pipeline.

Cancelar e executar novamente uma linha de processamento

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.

Pipeline executar mais ações menu

No menu Mais ações, você pode baixar logs, adicionar tags, editar o pipeline, excluir a execução e configurar a retenção para a 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 um selo de status no repositório.

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

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

2. Selecione e, em seguida, selecione Emblema de status.

3. Selecione Emblema de status.

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

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

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

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

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

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 no canto inferior esquerdo da página

2. Abra a guia Configurações em Pipelines

3. Alterne o alternador Desativar acesso anónimo a selos na secção Geral

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

Mostraremos como usar o editor clássico no Azure DevOps Server 2019 para criar uma compilação e uma versão que imprime "Hello world".

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

   

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

   

1. Vá para Azure Repos.

2. Adicione um arquivo.

   

3. Na caixa de diálogo, nomeie seu 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, isso deve levá-lo automaticamente para a página de Compilações.

   

2. Criar um novo canal de processamento.

   

   Para novos utilizadores do Azure DevOps, isso levará você automaticamente para a experiência de criação do pipeline YAML. Para aceder ao editor clássico e concluir este guia, deve desativar a funcionalidade de pré-visualização para a nova experiência de criação de pipelines YAML:

   

   

3. Verifique se o código-fonte, o projeto, o repositório e a ramificação padrão correspondem ao local no qual você criou o script.

4. Comece com um trabalho vazio.

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

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 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, para navegar no seu repositório, selecione o botão e escolha o script que criou.

   

9. Selecione Guardar e adicionar à fila, e, em seguida, selecione Guardar.

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 Compilação e, em seguida, selecione Adicionar.

   

   Caminho para publicação: Selecione o botão para navegar e selecione o script que você criou.

   Nome do artefato: Digite drop.

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

1. Selecione Guardar e colocar em fila e, em seguida, selecione Guardar e colocar em fila.

2. Na caixa de diálogo, selecione Salvar e enfileirar mais uma vez.

   Isso enfileira uma nova compilação no agente hospedado pela Microsoft.

3. Você verá um link para a nova compilação na parte superior da página.

   

   Escolha o link para assistir à nova versão em tempo real. Depois que o agente estiver alocado, você começará a ver os logs dinâmicos da compilação. Observe que o script do PowerShell é executado como parte da compilação e que "Hello world" é impresso no console.

   

4. Vá para o resumo da compilação. Na guia Artefatos da compilação, observe que o script é publicado como um artefato.

   

Agora você pode ver os resultados de suas alterações. Vá para Azure Pipelines e selecione Fila. Note na seção Em fila ou em execução que uma compilação é acionada automaticamente pela alteração confirmada.

1. Vá para a guia Pipelines e selecione Releases.

2. Selecione a ação para criar um novo pipeline. Se um pipeline de liberação já estiver criado, selecione o sinal de adição ( + ) e, em seguida, selecione Criar um pipeline de liberação.

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

4. Nomeie o estágio QA.

5. No painel Artefatos, selecione + Adicionar e especifique uma Origem (pipeline de compilação). Selecione Adicionar.

6. Selecione o raio para acionar a implantação contínua e, em seguida, habilite o gatilho de implantação contínua à direita.

   

7. Selecione o separador Tarefas e selecione a sua etapa de QA.

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

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

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

11. Para o Script Path argumento, selecione o botão para procurar os 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 Clone.

    

14. Renomeie a fase clonada para Produção.

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

    

16. Salve o pipeline de liberação.

1. Crie uma nova versão.

   

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

2. Abre o lançamento que criaste.

   

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

   

Você aprendeu como criar seu primeiro pipeline no Azure. Agora, saiba mais sobre como configurar pipelines no idioma de sua escolha:

• Núcleo do .NET
• Vá
• Java
• Node.js
• Python
• Contentores

Ou, você pode continuar a personalizar o pipeline que você criou.

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

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

Para saber como publicar os seus Pipeline Artifacts, consulte Publicar Pipeline Artifacts.

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

Limpeza

Se criaste pipelines de teste, são fáceis de eliminar quando terminares com eles.

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

  • Código do Visual Studio para Windows, macOS e Linux
  • Visual Studio com Git para Windows ou Visual Studio para Mac
  • Eclipse
  • XCode
  • IntelliJ
  • Linha de comandos

• Serviços

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

Como faço para 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 clonares um pipeline, podes fazer alterações e depois guardá-lo.

Depois de exportares um pipeline, podes importá-lo do separador Todos os pipelines.

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

Como posso trabalhar com rascunhos?

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

O que mais posso fazer quando enfileirar uma compilação?

Você pode enfileirar compilações automaticamente ou manualmente.

Quando enfileiras manualmente uma compilação, podes, numa execução única da compilação:

• Especifique o pool em que a compilação será incluída.

• Adicione e modifique algumas variáveis.

• Adicione exigências.

• Em um repositório Git

  • Crie uma ramificação ou uma tag.

  • Crie uma confirmação.

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

• Obter fontes de informação
• Tarefas
• Variáveis
• Acionadores
• Retenção
• História

Como faço para criar programaticamente um pipeline de compilação?

Referência da API REST: Criar um pipeline de compilação