Especificar as exigências

Azure DevOps Services | Azure DevOps Server | 2020 Azure DevOps Server | 2019 TFS 2018

Nota

No Microsoft Team Foundation Server (TFS) 2018 e nas versões anteriores, os oleodutos de construção e libertação são chamados definições, as corridas são chamadas de construções, as ligações de serviço são chamadas pontos finais de serviço, as fases são chamadas de ambientes, e os empregos são chamados de fases.

Utilize as exigências para garantir que as capacidades que o seu pipeline necessita estão presentes nos agentes que o executam. As exigências são afirmadas automaticamente por tarefas ou manualmente por si.

Nota

As exigências e capacidades são concebidas para serem utilizadas com agentes auto-hospedados para que os postos de trabalho possam ser acompanhados por um agente que satisfaça os requisitos do trabalho. Ao utilizar agentes hospedados pela Microsoft, seleciona uma imagem para o agente que corresponde aos requisitos do trabalho, por isso, embora seja possível adicionar capacidades a um agente hospedado pela Microsoft, não precisa de utilizar capacidades com agentes hospedados pela Microsoft.

Exigências de tarefa

Algumas tarefas não serão executadas a menos que uma ou mais exigências sejam satisfeitas pelo agente. Por exemplo, a tarefa Visual Studio Build exige isso msbuild e visualstudio são instalados no agente.

Exigências inseridas manualmente

Talvez precises de usar agentes auto-hospedados com capacidades especiais. Por exemplo, o seu pipeline pode necessitar de SpecialSoftware em agentes na Default piscina. Ou, se tiver vários agentes com diferentes sistemas operativos na mesma piscina, pode ter um oleoduto que requer um agente Linux.

Para adicionar uma única exigência ao seu oleoduto de construção YAML, adicione a demands: linha à pool secção.

pool:
  name: Default
  demands: SpecialSoftware # exists check for SpecialSoftware

Ou se precisar de adicionar várias exigências, adicione uma por linha.

pool:
  name: MyPool
  demands:
  - myCustomCapability   # exists check for myCustomCapability
  - Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Nota

Verificar a existência de uma capacidade (existe) e verificar se existe uma cadeia específica numa capacidade (igual) são as duas únicas operações apoiadas para as exigências.

Para obter mais informações e exemplos, consulte o esquema YAML - Demandas.

Os oleodutos YAML são suportados em Azure DevOps Server 2019 e superiores.

Registe cada agente que tenha a capacidade.

  1. No seu navegador, navegue para piscinas de agente:

    1. Escolha Azure DevOps, configurações da Organização.

      Choose Organization settings.

    2. Escolha piscinas de agente.

      Choose Agent pools tab.

    1. Escolha Azure DevOps, configurações de coleção.

      Choose Collection settings.

    2. Escolha piscinas de agente.

      Choose Agent pools.

    1. Escolha Azure DevOps, configurações de coleção.

      Collection settings, 2019.

    2. Escolha piscinas de agente.

      Choose Agent pools, 2019.

    1. Navegue para o seu projeto e escolha Definições (ícone de engrenagem) >Filas de agentes.

      Choose Settings, Agent Queues, 2018.

    2. Escolha Gerir piscinas.

      Choose Manage pools, 2018.

  2. Navegue para o separador de capacidades para o agente:

    1. A partir do separador de piscinas do Agente , selecione a piscina de agente desejada.

      From Agent pools, select the desired agent pool.

    2. Selecione agentes e escolha o agente pretendido.

      Select Agents and choose the agent.

    3. Escolha o separador Capabilites .

      Choose the Capabilities tab.

      Nota

      Os agentes hospedados pela Microsoft não exibem capacidades do sistema. Para obter uma lista de software instalado em agentes hospedados pela Microsoft, consulte Utilize um agente hospedado pela Microsoft.

    1. A partir do separador de piscinas agent , selecione a piscina desejada.

      Select the desired pool.

    2. Selecione agentes e escolha o agente pretendido.

      Select Agents and choose the desired agent.

    3. Escolha o separador Capabilites .

      Agent capabilities tab.

    1. A partir do separador de piscinas agent , selecione a piscina desejada.

      Select the desired tab, 2019.

    2. Selecione agentes e escolha o agente pretendido.

      Choose the desired agent, 2019.

    3. Escolha o separador Capabilites .

      Choose the Capabilities tab, 2019.

    Selecione o agente pretendido e escolha o separador Capabilites .

    Agent capabilities tab, 2018.

  3. Adicione algo como a seguinte entrada:

Primeira caixa Segunda caixa
SpecialSoftware C:\Ficheiros de programas (x86)\SpecialSoftware

Dica

Para definições clássicas não-YAML, quando você faz fila manual de uma construção pode alterar as exigências nessa execução.