Описание: Узнайте, как реализовать систему управления сборкой, которая будет использовать и расширять имеющиеся в вашей среде автоматизированные технологии. В этом пошаговом учебном руководстве рассказывается о том, как установить и настроить IBM® Rational® Build Forge™ для управления сборками Jakarta Tomcat из исходного кода. Мы интегрируем Build Forge с используемой рабочей группой Tomcat системой управления версиями и создадим среду непрерывной интеграции, в которой Rational Build Forge будет выполнять повторные сборки и развертывания самой актуальной версии Tomcat при каждой фиксации изменений в репозитории Subversion. Инструмент Rational Build Forge стал легендой в смысле быстрого возврата инвестиций. Узнайте, как реализация, описываемая в данном учебном руководстве, способна многократно оправдать ваши инвестиции в имеющиеся скрипты автоматизации сборки. Изучение данной серии из двух статей позволит вам повысить показатели производительности с 0 до 96 bpd (builds per day, сборок в день) за два дня.
ПЕРЕД НАЧАЛОМ РАБОТЫ
В этом учебном руководстве мы установим и настроим инструмент IBM Rational® Build Forge® Мы создадим среду непрерывной интеграции для Tomcat, которая будет запускать процесс сборки при каждой фиксации изменений в репозитории Tomcat Subversion. Изучение данной серии из двух статей позволит вам повысить показатели производительности с 0 до 96 bpd (builds per day, сборок в день) за два дня. В данной статье рассматриваются задачи на первый день работы.
Если вы - разработчик, занимающийся автоматизацией создания сборок, или оператор, предоставляющий инфраструктуру поддержки для создания и развертывания функций, то эта серия статей - то, что вам нужно.
Во 2-й части серии (второй день) мы расскажем о предусмотренном в Build Forge многократном использовании существующих скриптов проекта и о том, как этот инструмент может дополнить элементарный процесс компиляции и пакетирования сборки за счет добавления средств настройки и развертывания.
Изучив это учебное руководство, вы узнаете:
- каковы основные концепции Build Forge;
- как установить и настроить инструмент Rational Forge;
- как создать объекты Build Forge, которые будут представлять серверы сборки для нашего учебного руководства;
- как сконфигурировать для запуска проект Hello World.
Предполагается, что вы имеете представление о сборке Java-приложений. Среда Build Forge не зависит от конкретного языка программирования, но проект Tomcat написан на языке программирования Java. Опыт работы с Apache Ant и Subversion полезен, но не обязателен.
Для выполнения шагов, описанных в данном учебном руководстве, у вас должен быть доступ к перечисленным ниже инструментам, которые можно получить, воспользовавшись контактной информацией в описании продукта Rational Build Forge:
|
IBM Rational Build Forge Console V7.0.1 |
Сервер Build Forge |
|---|---|
|
IBM Rational Build Forge, Agent V7.0.1 |
Для управления удаленным сервером сборки и развертывания в процессе сборки |
|
IBM Rational License Server V7.0 Windows |
Предоставляет лицензии на Build Forge |
Следующие лицензии:
|
|
|
MySQL 5.0.45 |
База данных для хранения параметров конфигурации и журналов Build Forge |
ВВЕДЕНИЕ
В данном учебном руководстве Tomcat используется в качестве проекта для демонстрации многократного использования реализацией Rational Build Forge имеющихся скриптов. В данном случае Tomcat является аналогом любого проекта, который вы могли бы включить в систему управления сборками, если нет возможности или желания изменять сборочные скрипты. В примере в данном учебном руководстве Tomcat символизирует любой внешний или внутренний проект, связанный с вашими проектами.
Связанные между собой проекты необходимо развертывать в интегрированной среде, чтобы можно было протестировать их совместно. Непрерывный запуск сборок в среде интеграции при изменении базового кода проекта (непрерывная интеграция) с последующим выполнением автоматизированных тестов - это оптимальный метод, позволяющий гарантировать сохранение работоспособности системных точек интеграции.
Реализуя управление сборками, мы стремимся избежать влияния на рабочие потоки текущей сборки или ограничения возможности рационализации процесса в будущем. Использование проектов с открытым исходным кодом является предпочтительным. Систему управления сборками следует оценивать по следующим показателям: она должна помочь организации добиться непрерывной интеграции, использовать настраиваемые уведомления, безопасный доступ, планирование и генерацию отчетов без внесения изменений в процессы разработки. Проект с открытым исходным кодом покажет способность Rational Build Forge автоматизировать эти основные задачи.
УСТАНАВЛИВАЕМ И НАСТРАИВАЕМ RATIONAL BUILD FORGE
В этом разделе рассказывается о том, как установить необходимые компоненты сервера в соответствии с приведенной ниже схемой.
В данном учебном руководстве все серверные процессы, в том числе процессы базы данных, выполняются на одной машине.
Устанавливаем Rational License Server v7.0 Windows
Консоль управления Build Forge Management Console при запуске проверяет наличие действующей лицензии. Поэтому необходимо установить сервер лицензирования Rational License Server и импортировать ознакомительную лицензию до установки консоли управления Build Forge Management Console.
- Распакуйте установочные файлы.
- Запустите программу установки setup.exe. Установите флажок Install Rational License Server.
- Согласитесь с остальными параметрами, выбранными для сервера лицензирования по умолчанию. По завершении установки нажмите кнопку Finish.
Импортируйте ознакомительные лицензии Build Forge на сервер лицензирования.
- Запустите компонент License Key Administrator, выбрав из меню All Programs (Все программы) команды > IBM Rational > IBM Rational License Key Administrator.
- Выберите опцию Import a Rational License File и нажмите кнопку Next.
- Перейдите к папке, содержащей файл ключа ознакомительной лицензии.
- Откройте этот файл и нажмите кнопку Import.
- Убедитесь, что лицензия является действующей, и нажмите кнопку Import.
- Подтвердите перезапуск сервера лицензирования.
Консоль управления Build Forge Management Console будет хранить информацию о конфигурации и файлы журнала сборки в базе данных. Для изучения нашего учебного руководства установите MySQL версии 5.0.45.
- Распакуйте установочный файл и запустите его.
- В соответствующем окне программы установки выберите полную (Complete) установку.
- Нажмите кнопку Install.
- Нажимайте кнопку Next, пока не увидите окно, показанное на следующем рисунке. Установите флажок Configure the MySQL Server now, а затем нажмите кнопку Finish.
- Нажмите кнопку Next, выберите вариант Standard Configuration и нажмите кнопку Next.
- Выберите следующие опции (или установите соответствующие флажки):
- Install As Windows Service,
- MySQL в поле Service Name,
- Launch the MySQL Server Automatically,
- Include Bin Directory in Windows PATH,
- Введите пароль учетной записи root, нажмите кнопку Next, а затем кнопку Execute.
- Нажмите Finish.
Создаем экземпляр базы данных MySQL для хранения данных Build Forge
Нам нужно создать в MySQL базу данных для хранения данных Build Forge. Кроме того, необходимо создать пользователя MySQL для установления подключения к Build Forge.
- Откройте окно командной строки и введите в нем команды
mysql -uroot -p<пароль, указанный в процессе инсталляции> - После приглашения mysql введите команду
create database build; - После приглашения mysql введите команду
grant all on build.* to build identified by 'build'; - После приглашения mysql введите команду
quit
Устанавливаем консоль управления Build Forge Management Console
Сервер лицензирования готов к использованию действующей лицензии Build Forge, база данных доступна и настроена; теперь можно перейти к установке консоли управления Build Forge Management Console.
- Распакуйте установочный файл и запустите его.
- Нажмите кнопку Next в панели Welcome мастера установки.
- Выберите папку, в которую будет установлена программа.
- В поле License Host укажите
localhost, а в поле Http Server Port оставьте значение по умолчанию за исключением тех случаев, когда ваша система в данный момент использует этот порт (например, для другого Web-сервера). - Введите
MC1в поле Location Name. Выберите опцию Connect to existing database и укажите следующие параметры:- в поле DB Name: build;
- в поле DB Type: MySQL;
- в поле DB Host: localhost;
- в поле Username: build
- в поле Password: build.
- Нажмите кнопку Install.
По завершении установки консоль управления Build Forge Management Console будет запущена в фоновом режиме как служба. После запуска и обнаружения пустой базы данных MySQL она приступит к созданию табличной структуры. Этот процесс может занять примерно минуту. Прежде чем продолжить работу, дождитесь перехода системы в режим ожидания.
- После остановки службы Build Forge (bfengine) скопируйте файл libmySQL.dll в каталог BuildForge \ Apache. В окне командной строки введите
net stop bfengine - Введите команду
copy "c:\Program Files\MySQL\MySQL Server 5.0\bin\libmySQL.dll" "c:\Program Files\BuildForge\Apache\bin" - Перезапустите службу Build Forge командой
net start bfengine - Закройте окно командной строки.
- Запустите консоль управления Management Console двойным щелчком на значке на рабочем столе.
- Введите в поле имя пользователя (User name)
rootи пароль (Password)root, а затем нажмите кнопку Login. - Перед вами должна открыться домашняя страница консоли управления Management Console для пользователя root.
Устанавливаем агент Rational Build Forge
Агенты Build Forge Agent можно установить на любой системе, которая будет использоваться в процессах сборки, развертывания и тестирования под управлением Build Forge. Для изучения данного учебного руководства установите агент на той же системе, на которой установлена консоль управления Management Console. Агентская система может (и обычно бывает) удаленной.
- Распакуйте установочный файл и запустите файл win-bfagent-7.0.1.211.exe.
- В панелях мастера установки согласитесь со всеми параметрами по умолчанию.
- Когда откроется соответствующее окно, нажмите кнопку Finish.
На этом установка Rational License Server, MySQL, консоли управления Rational Build Forge Management Console и агента Rational Build Forge Agent завершена. В следующем разделе мы расскажем о том, как настроить конфигурацию Build Forge и создать процесс сборки.
ПЕРВЫЕ ШАГИ - HELLO WORLD
В этом разделе мы создадим объекты Build Forge, которые будут представлять серверы сборки для нашего учебного руководства, а затем сконфигурируем проект Hello World, чтобы его можно было выполнить. Полное описание всех опций, доступных на этом этапе, можно найти в онлайновой справке по Rational Build Forge.
Настраиваем управление Build Forge сервером сборки через установленный агент
При изучении раздела Установка и настройка Rational Build Forge мы установили агент Build Forge. Первое, что необходимо сделать - это настроить Management Console на взаимодействие с процессом агента. Эта конфигурация будет использовать функции из навигационной панели Servers в панели управления Management console.
Создаем объект Server authentication
Объект содержит учетные данные, которые консоль управления Management Console использует для входа в систему сервера, на котором выполняется компонент Agent. Используемая учетная запись должна иметь привилегии, позволяющие выполнять задачи в процессе сборки.
- Нажмите левой кнопкой мыши на элементе Server Auth в категории Servers.
- Введите
localhost authв поле Name, а затем укажите параметры входа в систему для учетной записи Administrator (или другой учетной записи, имеющей соответствующие привилегии). - Нажмите кнопку Save Server Authentication.
Build Forge предоставляет эффективные средства для динамического выбора сервера во время сборки. В этом учебном руководстве мы не будем описывать данную функцию, поэтому просто жестко ассоциируем сборки с конкретным сервером. Сначала необходимо создать объект Selector, который будет выбирать сервер по указанному имени.
- Нажмите левой кнопкой мыши на элементе Selectors в категории Servers.
- Введите
build selectorв поле Name. - Нажмите кнопку Save.
Указываем критерии для объекта Selector
Build Forge позволяет использовать несколько критериев, например, свободное дисковое пространство, число ЦПУ и т.д. В данном учебном руководстве используются следующие параметры:
- Имя по умолчанию BF_NAME.
- Оператор == .
- Введите
build_serverв поле Value. - Yes в поле Required.
- Нажмите кнопку Save.
Объект Server хранит информацию о подключении (host) и ссылку на объект Server Authentication, который мы создали в разделе Создаем объект Server authentication. На сервере сборки рабочие каталоги для сборок задаются путем ввода значения Path в этой панели. Build Forge также позволяет ассоциировать сервер со специфической для него переменной окружения.
- Нажмите левой кнопкой мыши на элементе Servers.
- Введите
build_serverв поле Name,c:\buildв поле Path и выберите из списка localhost auth в поле Authentication. В остальных полях оставьте значения по умолчанию. - Нажмите кнопку Save.
Build Forge не сможет вести запись в каталоге, указанном в поле path, пока этот каталог не будет создан. В окне командной строки введите md c:\build.
Тестируем подключение к агенту
Чтобы протестировать подключение к агенту:
- Выделите build_server.
- Нажмите кнопку Test Connection.
На экран будет выведена вкладка Test Results.. После того как подключение консоли управления Management Console к агенту будет установлено и протестировано, на вкладке будут отображены результаты тестирования, а индикатор на значке сервера станет зеленым.
Создаем и запускаем проект Hello World
Теперь, когда консоль управления Management Console может управлять сборками при помощи агента, можно создать проект Hello World, который будет использовать агент для вывода на экран какого-либо значения. Проект Build Forge включает несколько шагов, представляющих команды, которые выполняют процесс сборки.
- Чтобы создать проект сборки, его надо сконфигурировать, выбрав имя и объект Selector. Описание остальных полей конфигурации проекта можно найти в онлайновой справке:
- нажмите левой кнопкой мыши на категории Projects;
- введите в поле Name
Hello Worldи убедитесь, что объект Selector по умолчанию указан в поле build selector; - нажмите кнопку Save Project.
- Откройте проект, нажав и отпустив левую кнопку мыши на Hello World в списке проектов.
- В проекте для выполнения процесса сборки используются настраиваемые шаги. На вкладке Details создайте отдельный шаг, который будет возвращать и выводить на экран значение:
- введите
Echo Valueв поле Name; - введите команду
echo Hello Worldв секции Command; - в остальных полях пока оставьте значения по умолчанию;
- нажмите кнопку Save Step.
- введите
- Запустите проект на выполнение, нажав кнопку Start Project.
- Оставьте показанные на рисунке значения по умолчанию и нажмите кнопку Execute.
- На экран будет выведено окно выполнения сборки, демонстрирующее ход выполнения всех шагов проекта по мере их выполнения. Кроме того, отображается также результат каждого шага.
- Нажмите левой кнопкой мыши на имени шага Echo value, чтобы просмотреть информацию в журнале о выполнении этого шага.
- Прокрутите вывод до конца. Вы увидите ожидаемое сообщение Hello World .
ЗАКЛЮЧЕНИЕ
Мы уже сделали довольно много. Консоль управления Build Forge Management запущена и подключена к "удаленному" серверу. Мы изучили ряд базовых концепций Build Forge и познакомились с архитектурой и базовой конфигурацией Build Forge. Эта архитектура может управлять стандартным процессом сборки на удаленном сервере.
Теперь отдохните немного и подготовьтесь ко второму дню: мы используем все, что создали до сих пор, чтобы приступить к созданию реального проекта Jakarta Tomcat. Во 2-й части рассказывается о предусмотренной в Build Forge функции многократного использования имеющихся скриптов проекта. Кроме того, в ней рассказывается о том, каким образом Build Forge расширяет стандартный процесс компиляции и сборки за счет добавления средств пользовательской настройки и развертывания.