Mehrere TeamCity-Agents auf demselben System ausführen

In der Regel empfehlen wir, einen Build-Agent je physisches oder virtuelles System zu installieren. Dadurch wird das Verhalten der Builds berechenbarer und Datenkonflikte zwischen ihnen können vermieden werden. Wenn Sie trotzdem mehrere parallele Builds auf demselben System ausführen möchten, haben Sie die Möglichkeit, mehrere Build-Agents auf dem System einzurichten.

Installieren Sie dazu den ersten Build-Agent auf die übliche Art und Weise. Beim Installieren und Konfigurieren weiterer Agents auf demselben System beachten Sie Folgendes:

  • Verwenden Sie für die Installation jedes neuen Agents einen anderen Betriebssystem-Benutzeraccount. Dadurch vermeiden Sie Konflikte bei der Verwendung von Benutzerressourcen wie z. B. Artefakt-Caches.
  • Installieren Sie jeden Agent in einem unterschiedlichen lokalen Verzeichnis.
  • Passen Sie die Konfigurationsdatei (conf/buildAgent.properties) jedes Agents an:
    • Stellen Sie einzigartige Werte für Name und Port ein.
    • Geben Sie ein eigenes Arbeitsverzeichnis (workDir) und Temp-Verzeichnis (tempDir) für den Agent als relativen Pfad an. Es ist wichtig, für jeden Agent eigene, unabhängige Verzeichnisse festzulegen.
    • Löschen Sie die Eigenschaft authorizationToken (oder ihren Wert). Agents erhalten diese Token beim Verbinden mit dem Server.
    • Wenn Ihr lokaler TeamCity-Server hinter einem Reverse-Proxy installiert ist, denken Sie daran, `serverUrl` auf die Proxy-Adresse einzustellen.

    Wenn Sie TeamCity Cloud nutzen, können Sie automatisch eine einzigartige Agent-Konfigurationsdatei erzeugen: Gehen Sie zu Agents, öffnen Sie das Menü Install Build Agents in der oberen rechten Ecke des Bildschirms und klicken Sie auf Use authentication token. Wählen Sie die Option Download config und geben Sie einen Agent-Namen ein (das Attribut „Name“ in der Build-Agent-Konfiguration), um die gesamte Konfigurationsdatei herunterzuladen. Legen Sie die Datei unter dem Namen „buildAgent.properties“ im Verzeichnis des Build-Agents ab. Überarbeiten Sie die Datei wie oben beschrieben.

  • Stellen Sie sicher, dass Ihre Build-Schritte und -Skripte auf das Build-Checkout-Verzeichnis bezogene relative Pfade verwenden, und nicht absolute Pfade auf dem Agent-System. Falls benötigt, können Sie die Option Clean checkout aktivieren, um den Quellcode immer direkt vor einem Build aus einem VCS-Repository herunterzuladen.

Dieser Hilfeartikel enthält eine ausführlichere Beschreibung des Installationsvorgangs mit wichtigen Hinweisen für Windows- und macOS-Systeme.