Executando vários agentes do TeamCity na mesma máquina

Em um caso comum, recomendamos a instalação de um agente de build por máquina física ou virtual: isso torna o comportamento dos builds mais previsível e permite evitar conflitos de dados entre eles. No entanto, se você quiser executar múltiplos builds paralelos na mesma máquina, poderá configurar vários agentes de build nela.

Para fazer isso, instale o primeiro agente de build como de costume. Ao instalar e configurar os agentes seguintes na mesma máquina, lembre-se de:

  • Usar uma conta de usuário do sistema operacional diferente para instalar cada novo agente. Isto evitará conflitos nos recursos do usuário, como caches de artefatos.
  • Instalar cada agente em um diretório local diferente.
  • Ajustar o arquivo de configuração (conf/buildAgent.properties) de cada agente:
    • Defina valores arbitrários exclusivos para `name` e `port`.
    • Especifique os caminhos relativos para o próprio diretório de trabalho do agente (`workDir`) e o diretório temporário (`tempDir`). É importante que cada agente tenha sua própria cópia independente desses diretórios.
    • Limpe (exclua ou remova o valor) a propriedade `authorizationToken`. Os agentes recebem esses tokens quando se conectam ao servidor.
    • Se o seu servidor do TeamCity On-Premises estiver instalado atrás de um proxy reverso, lembre-se de definir `serverUrl` como o endereço do proxy.

    Se você for um usuário do TeamCity Cloud, poderá gerar automaticamente um arquivo de configuração de agente exclusivo: acesse Agents, abra o menu Install Build Agents no canto superior direito da tela e clique em Use authentication token. Escolha a opção Download config e digite um nome de agente (o atributo `name` na configuração do agente de build) para baixar o arquivo de configuração inteiro. Coloque-o como o arquivo `buildAgent.properties` no diretório do agente de build. Revise-o conforme descrito acima.

  • Certifique-se de que suas etapas de build e scripts usem caminhos relativos para arquivos no diretório de check-out do build, e não caminhos absolutos na máquina dos agentes. Se necessário, você pode habilitar a opção clean checkout para sempre buscar fontes diretamente de um repositório VCS antes de um build.

Este artigo de ajuda descreve o processo de instalação com mais detalhes e contém notas importantes para máquinas Windows e macOS.