Exécution de plusieurs agents TeamCity sur la même machine

Dans un cas courant, nous recommandons d'installer un agent de build par machine physique ou virtuelle. Cela améliore la prévisibilité du comportement des builds et permet d'éviter les conflits de données entre ces dernières. Toutefois, si vous souhaitez exécuter plusieurs builds en parallèle sur la même machine, vous pouvez y configurer plusieurs agents de build.

Pour ce faire, installez le premier agent de build comme d'habitude. Lorsque vous installez et configurez les agents suivants sur la même machine, n'oubliez pas les points ci-dessous :

• Utilisez un autre compte utilisateur du système d'exploitation pour installer chaque nouvel agent. Cela permettra d'éviter les conflits dans les ressources des utilisateurs, comme les caches d'artefacts.
• Installez chaque agent dans un répertoire local différent.
• Ajustez le fichier de configuration (conf/buildAgent.properties) de chaque agent :
  • Définissez des valeurs uniques arbitraires pour « name » et « port ».
  • Spécifiez les chemins relatifs vers le répertoire de travail (« workDir ») et le répertoire temporaire (« tempDir ») de l'agent. Il est important que chaque agent dispose de sa propre copie indépendante de ces répertoires.
  • Effacez (supprimez ou enlevez la valeur) la propriété « authorizationToken ». Les agents reçoivent ces jetons lors de leur connexion au serveur.
  • Si votre serveur TeamCity sur site est installé derrière un proxy inverse, n'oubliez pas d'indiquer l'adresse du proxy dans « serverUrl ».

  Si vous utilisez TeamCity Cloud, vous pouvez générer automatiquement un fichier de configuration d'agent unique : cliquez sur Agents, ouvrez le menu Install Build Agents en haut à droite de l'écran et cliquez sur Use authentication token. Choisissez l'option Download config et indiquez un nom d'agent (l'attribut « name » dans la configuration de l'agent de build) pour télécharger le fichier de configuration complet. Placez-le en tant que fichier « buildAgent.properties » dans le répertoire de l'agent de build. Révisez-le comme décrit ci-dessus.

• Assurez-vous que vos étapes de build et vos scripts utilisent des chemins relatifs vers les fichiers dans le répertoire de vérification de la build, et non des chemins absolus sur la machine des agents. Si nécessaire, vous pouvez activer l'option Clean Checkout pour toujours récupérer les sources directement à partir d'un référentiel VCS juste avant une build.

Cet article d'aide détaille le processus d'installation et contient des remarques importantes pour les machines Windows et macOS.