Configuração de pipelines clássicos

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Os pipelines clássicos tornam mais fácil para os desenvolvedores projetar seus fluxos de trabalho de pipeline usando a interface do usuário para adicionar tarefas e condições personalizadas ao cenário. Este artigo explica as opções disponíveis para configurar o trabalho do agente e explora as diferentes propriedades de build para o pipeline clássico.

Trabalho do agente

  1. Entre na sua organização do Azure DevOps e vá para o projeto.

  2. Selecione Pipelines, selecione sua definição de pipeline e depois selecione Editar.

  3. Selecione Tarefas e, em seguida, selecione Trabalho do agente.

Pool de agentes padrão:

Quando você enfileira uma compilação, ela é executada em um agente do pool selecionado. Você pode escolher um pool hospedado pela Microsoft ou um pool auto-hospedado que você gerencia. Selecione o pool associado aos agentes nos quais você deseja executar esse pipeline.

Paralelismo

Define como as tarefas do trabalho são executadas em paralelo:

  • Nenhum: as tarefas são executadas em um único agente.

  • Multiconfiguração: as tarefas são executadas em várias configurações, conforme especificado nos multiplicadores. As configurações são executadas em paralelo, cada uma usando um único agente. O número total de agentes depende do número de configurações e pode ser limitado pela definição de um número máximo de agentes.

  • Multiagente: as tarefas são executadas em vários agentes usando o número especificado de agentes.

Timeout

Especifica o tempo máximo, em minutos, que uma implantação pode ser executada em um agente antes de ser cancelada pelo servidor. A duração é medida após a conclusão da pré-aprovação e antes da solicitação da pós-aprovação. Um valor zero fará com que o tempo limite do pipeline pai seja usado.

Tempo limite de cancelamento do trabalho

Especifica o tempo máximo de espera para que um trabalho de implantação responda a uma solicitação de cancelamento antes de ser encerrado pelo servidor. Um valor zero fará com que o tempo limite do pipeline pai seja usado.

Permitir que scripts acessem o token OAuth

Permite que scripts e outros processos acessem o token OAuth por meio da System.AccessToken variável. Consulte o script de exemplo para acessar a API REST para obter mais detalhes.

Uma captura de tela exibindo como configurar o trabalho do agente em um pipeline clássico.

Compilar propriedades

  1. Entre na sua organização do Azure DevOps e vá para o projeto.

  2. Selecione Pipelines, selecione sua definição de pipeline, selecione Editar e, em seguida, selecione a guia Opções .

Formato de número da versão

Defina o formato para dar nomes significativos às compilações concluídas. Deixe em branco para dar às compilações um inteiro exclusivo como nome. Consulte Configurar números de execução de compilação para obter mais detalhes.

Criar itens de trabalho em caso de falha

Quando habilitado, se o pipeline falhar, um item de trabalho será criado automaticamente para rastrear o problema. Você pode especificar o tipo de item de trabalho e escolher se deseja atribuí-lo ao solicitante.

  • Campos adicionais: defina campos adicionais ao criar o item de trabalho.

Por exemplo, "System.Title" = "Build $(build.buildNumber) failed" formata o título do Item de Trabalho e "System.Reason" = "Build failure" define o motivo. Consulte Índice de campo de item de trabalho para outros campos disponíveis.

Criar o trabalho

Defina as configurações de autorização e tempo limite do trabalho de build.

  • Escopo de autorização do trabalho de compilação: especifique o escopo de autorização para um trabalho de compilação. Selecione:

    • Coleção de projetos: se o pipeline precisar de acesso a vários projetos.
    • Projeto atual: se você quiser restringir esse pipeline para acessar apenas os recursos no projeto atual.

Consulte Entender os tokens de acesso ao trabalho para obter mais detalhes.

  • Tempo limite do trabalho de compilação em minutos: especifica o tempo máximo que um trabalho de compilação pode ser executado em um agente antes de ser cancelado pelo servidor. Um valor vazio ou zero indica que não há limite de tempo limite.

  • Tempo limite de cancelamento do trabalho de compilação em minutos: especifica o tempo máximo de espera para que um trabalho de compilação responda a uma solicitação de cancelamento antes de ser encerrado pelo servidor.

Demandas

Especifique os recursos que o agente deve ter para executar esse pipeline. Consulte Recursos e demandas do agente para obter mais detalhes.

Uma captura de tela exibindo como configurar as diferentes propriedades de build em um pipeline clássico.