Любой проект за годы разработки обрастает большой и сложной инфраструктурой. Множество скриптов сборки, хуков и самописных утилиток со временем превращаются в целый ворох проблем. Этого сложно избежать полностью, но вполне реально сократить количество возможных неприятностей. Об одном инструменте, который может Вам в этом помочь, я сегодня и расскажу.
Buildbot? Не, не слышал.
На хабре почти нет упоминаний об этом замечательном тулките. Значит ли это, что им никто не пользуется? Отнюдь.
Сhromium, python, blender и множество других больших проектов собираются и даже релизятся с помощью buildbot.
Большой и страшный waterfall проекта chromium
Что за зверь такой?
Стоит отметить главную особенность: buildbot — это фреймворк. Кто-то может посчитать это минусом, но для серьезных проектов это несомненный плюс. Ведь давно известно, что если хочешь сделать что-то годное, то лучше сделать это самому.
Конфиг, содержащий в себе инструкции что как и где собирать, представляет из себя код на python. Оттого я надеюсь, что Вы с этим языком знакомы.
В бой!
Лучше один раз увидеть, чем сто раз услышать, так что давайте сразу перейдем к действию.
Нам потребуется:
- Python в купе с его dev пакетами(для сборки twisted)
- Virtualenv для создания виртуального окружения
- Git
Создадим виртуальное окружение
mkdir -p buildbot
cd buildbot
virtualenv --no-site-packages sandbox
source sandbox/bin/activate
easy_install sqlalchemy==0.7.10
easy_install buildbot buildbot-slave
Создадим мастер-сервер
buildbot create-master master
Переименуем дефолтный конфиг
mv master/master.cfg.sample master/master.cfg
А теперь запустим мастер
buildbot start master
Можно проверить хорошо ли все работает посмотрев лог
tail -f master/twistd.log
А теперь, не отходя от кассы, создадим слейв
Размещение слейва рядом с мастером нельзя назвать хорошей практикой, но в нашем случае это позволительно
buildslave create-slave slave localhost:9989 example-slave pass
Запускаем
buildslave start slave
Слейв ругнется на развернутый по-соседству твистедовский сервер мастера. Не обращаем внимания.
Если есть особое желание, то можем проверить, как все прошло, заглянув в лог
tail -f slave/twistd.log
Если мы сделали все правильно, то на 8010 порту нашего localhost'а будет красоваться вот такая приветственная страничка:
Проверяем
Логинимся. user: pyflakes, password: pyflakes.
Идем на localhost:8010/builders/runtests и видим примерно следующее:
Смело жмякаем «Force Build»
Наш первый билд готов. Нажимаем F5 и переходим на страницу сборки. Все шаги зеленые? Значит, тесты прошли успешно.
Нажав на stdout конкретного шага сборки, можно увидеть вывод консоли с подробным описанием того что, как и где запускалось.
Конец
Вот и все, на этом я закончу введение в buildbot. Если у хабрасообщества есть желание, то я с удовольствием продолжу повествование, расскажу о тонкостях и граблях на которые я наступил при внедрении билдбота.
Автор: HgeN