Запуск нескольких билд-агентов TeamCity на одном устройстве

Обычно мы рекомендуем устанавливать один билд-агент на одно физическое или виртуальное устройство — это делает поведение сборок более предсказуемым и позволяет избежать конфликтов данных. Однако вы можете настроить несколько билд-агентов на одном устройстве и запускать сборки параллельно.

Для этого установите первый билд-агент как обычно. При установке и настройке последующих агентов на этом же устройстве важно:

• Используйте разные учетные записи ОС для установки каждого билд-агента — так вы предотвратите конфликты в ресурсах, ассоциированных с учетными записями (например с кэшами артефактов).
• Установите каждый агент в отдельную локальную директорию.
• Настройте конфигурационный файл (conf/buildAgent.properties) на каждом агенте:
  • присвойте полям «name» и «port» уникальные произвольные значения;
  • укажите относительный путь к рабочей («workDir») и временной («tempDir») директории каждого агента: важно, чтобы у каждого агента был свой набор таких директорий;
  • удалите свойство «authorizationToken» или очистите его значение (агенты получают эти токены при подключении к серверу);
  • если ваш локальный сервер TeamCity защищен обратным прокси, укажите адрес прокси в свойстве «serverUrl».

  В TeamCity Cloud можно автоматически сгенерировать для агентов уникальные конфигурационные файлы. Для этого перейдите в Agents, откройте меню Install Build Agents в правом верхнем углу экрана и нажмите Use authentication token. Выберите опцию Download config и укажите имя агента (значение атрибута «name» в конфигурации билд-агента), чтобы скачать конфигурационный файл, затем переименуйте его в «buildAgent.properties», поместите в директорию билд-агента и отредактируйте в соответствии с пунктом выше.

• Проверьте шаги и скрипты сборки: пути к файлам в директории выгрузки репозитория должны быть относительными (не абсолютными на устройстве агента). При необходимости включите очистку при выгрузке — тогда исходники будут загружаться напрямую из VCS-репозитория перед каждой сборкой.

В документации вы найдете более подробное описание процесса установки и важные замечания для пользователей Windows и macOS.