Ejecución de varios agentes de TeamCity en la misma máquina

En un caso común, recomendamos instalar un agente de compilación por máquina física o virtual: esto hace que el comportamiento de las compilaciones sea más predecible y permite evitar conflictos de datos entre ellos. Sin embargo, si desea ejecutar varias compilaciones paralelas en la misma máquina, puede configurar varios agentes de compilación en ella.

Para ello, instale el primer agente de compilación como de costumbre. Al instalar y configurar los siguientes agentes en la misma máquina, recuerde lo siguiente:

  • Utilice una cuenta de usuario del sistema operativo diferente para instalar cada nuevo agente. Esto evitará conflictos en los recursos del usuario, como las cachés de artefactos.
  • Instale cada agente en un directorio local diferente.
  • Ajuste el archivo de configuración (conf/buildAgent.properties) de cada agente:
    • Establezca valores arbitrarios y únicos para «name» y «port».
    • Especifique las rutas relativas al directorio de trabajo («workDir») y al directorio temporal («tempDir») del propio agente. Es importante que cada agente tenga su propia copia independiente de estos directorios.
    • Borre (elimine el valor) la propiedad «authorizationToken». Los agentes reciben estos tokens al conectarse al servidor.
    • Si su servidor TeamCity On-Premises está instalado tras un proxy inverso, recuerde ajustar «serverUrl» a la dirección del proxy.

    Si es usuario de TeamCity Cloud, puede generar un archivo de configuración de agente único de forma automática: vaya a Agents, abra el menú Install Build Agents en la esquina superior derecha de la pantalla y haga clic en Use authentication token. Seleccione la opción Download config e introduzca un nombre de agente (el atributo «nombre» en la configuración del agente de compilación) para descargar el archivo de configuración completo. Sitúelo como el archivo «buildAgent.properties» en el directorio del agente de compilación. Revíselo como se ha descrito anteriormente.

  • Asegúrese de que sus pasos y scripts de compilación utilizan rutas relativas a los archivos en el directorio de comprobación de la compilación, sin rutas absolutas en la máquina de los agentes. Si es necesario, puede activar la opción Clean Checkout para obtener siempre las fuentes directamente de un repositorio VCS justo antes de una compilación.

Este artículo de ayuda describe el proceso de instalación con más detalle y contiene notas importantes para las máquinas Windows y macOS.