Запуск скриптов командной строки

В TeamCity конфигурация сборки представляет собой задание. При настройке проекта TeamCity сканирует файлы в репозитории и автоматически определяет шаги сборки.

В этом уроке мы не будем использовать шаги сборки, определенные автоматически, поскольку нам надо запустить собственный скрипт командной строки. Но все же отметим, что TeamCity может сканировать исходный репозиторий проекта в системе контроля версий и автоматически определить подходящие шаги сборки в файлах решений Node.js, Kotlin, Python, Ant, NAnt, Gradle, Maven, MSBuild, Visual Studio, в файлах проектов PowerShell и Xcode, а также в проектах Rake и IntelliJ IDEA.

Чтобы настроить шаги сборки вручную, перейдите по ссылке:

Поскольку мы собираемся запустить скрипт командной строки, в раскрывающемся списке выбираем Command Line.

На следующем шаге надо выбрать в раскрывающемся списке вариант Run Custom Script и вставить наш скрипт сборки в соответствующее поле. Мы выполним команду mvn clean package. Как и у многих других инструментов, у наших билд-агентов этот пакет установлен по умолчанию.

mvn clean package компилирует исходный код Java, выполняет ряд тестов и создает файл .jar.

На шаге развертывания мы запускаем инструмент командной строки AWS и копируем этот файл .jar в частную корзину S3. После этого надо просто нажать Save.

Прежде чем нажать кнопку Run, необходимо указать учетные данные для корзины AWS S3: ID и секрет ключа доступа. Это можно сделать, например, в меню Parameters в TeamCity.

Нажмите Parameters | Add New Parameter. Сейчас мы просто добавим одну переменную окружения. Введите имя, то есть AWS_ACCESS_KEY_ID. Нужно также выбрать вид нового параметра — в нашем случае это Environment variable (env.) — и вставить ID ключа доступа.

Обратите внимание: наш ключ доступа предназначен исключительно для демонстрации, вы не сможете его использовать.

Кроме того, нам нужно изменить параметр и установить для него тип Password. После этого TeamCity скроет значение параметра не только в интерфейсе, но и в любых других местах, например в записях журналов.

Вы увидите, что ID ключа доступа уже спрятан.

Точно так же можно добавить еще одну переменную окружения — секрет ключа доступа. После этого можно запускать сборку.

Для этого нажмите кнопку Run — откроется страница с обзором информации. По мере выполнения сборки TeamCity будет выводить здесь логи сборки, подробно описывая выполняемые действия.

По завершении сборки TeamCity покажет ее статус и данные: когда и кто запустил сборку, сколько времени она выполнялась, какой билд-агент использовался.

Мы используем скрипты командной строки, поэтому на выходе получаем только журнал сборки. Если бы вместо этого мы использовали какой-то из билд-раннеров TeamCity (например, раннер Maven), то получили бы также отчеты о тестировании и о покрытии кода и могли воспользоваться другими функциями, такими как параллельное тестирование, которые доступны «из коробки».

Посмотреть журналы сборки можно на вкладке Build Log на странице результатов сборки. Читать журналы в TeamCity очень удобно. Вам не придется скачивать весь журнал на свой компьютер (хотя вы можете это сделать) и открывать его в Notepad++: TeamCity свернет журнал сборки, а нужное место легко найти, нажав Ctrl+F.

На сегодня все! Чтобы узнать, как пользоваться другими возможностями TeamCity, например отчетами о тестировании или о покрытии кода, посмотрите другие обучающие материалы.

Удачных сборок!

Подробнее — в документации по командной строке TeamCity.