Интеграция с Rational Build Forge

IBM® Rational Asset Manager и IBM Rational Build Forge обеспечивают доставку и отслеживание надежных операций компоновки программного обеспечения, а также управление ими.

Rational Asset Manager дополняет существующие системы компоновки приложений, такие как Rational Build Forge. С помощью Rational Build Forge можно создавать операции компоновки на основе ресурсов Rational Asset Manager. Кроме того, результаты компоновки можно опубликовать в качестве новых ресурсов Rational Asset Manager. Предусмотрены сценарии для загрузки ресурсов, проверки зависимостей, компиляции, компоновки и представления результатов в качестве новых ресурсов.

Процесс интеграции и применения Rational Asset Manager в качестве определяющей библиотеки программного обеспечения выглядит следующим образом:
Рисунок, на котором показан Rational Asset Manager с библиотекой Ant, инструментами компиляции, компонентами с открытым кодом и образом реализации. Кроме того, показаны Rational Build Forge, сервер компоновки и IBM Rational Team Concert. Стрелки соединяют компоненты Rational Asset Manager, Rational Team Concert, и Rational Build Forge с сервером компоновки, на котором выполняется компиляция и тестирование. Результат компоновки возвращается продукту Rational Asset Manager.
  1. Скопируйте требуемые сценарии Rational Asset Manager и связанные файлы JAR библиотек Ant на сервер компоновки.
  2. Загрузите инструменты компоновки из Rational Asset Manager (например компилятор, инструменты тестирования и общие сценарии).
  3. Извлеките исходный код из системы управления исходным кодом.
  4. Загрузите зависимые артефакты из Rational Asset Manager (например, открытый исходный код, модели, файлы wsdl, файлы xsd, указанные в исходных проектах).
  5. Выполните компиляцию и тестирование.
  6. Опубликуйте результаты компоновки в Rational Asset Manager вместе с зависимостями всех компонентов и требуемыми взаимосвязями.

В Rational Build Forge создайте новый проект для компоновки и публикации ресурсов. Компоновка выполняется на основе ресурсов и артефактов Rational Asset Manager. Результаты компоновки можно опубликовать в качестве ресурсов в Rational Asset Manager.

Например, результаты компоновки требуемых файлов (такие как файлы .ear) можно развернуть в качестве ресурсов в Rational Asset Manager. Кроме того, после сохранения результатов компоновки в качестве ресурсов Rational Asset Manager можно приступить к проверке новых ресурсов и связанных артефактов для утверждения с целью развертывания (например, перед публикацией вехи).

Тип компоновки Rational Build Forge (например Milestone или Golden Master) позволяет указать тип процесса проверки для новых ресурсов, созданных на основе результатов компоновки. После завершения компоновки Rational Build Forge опубликованные ресурсы отображаются в списке компоновки; в Rational Asset Manager все зависимости добавляются в новый ресурс.

Разработчики могут выполнить поиск ресурсов, артефактов и ссылок на артефакты Rational Asset Manager и добавить их в рабочую область. Они могут просмотреть взаимосвязи и зависимости ресурсов с помощью утилиты Визуальное представление. Сценарий загрузки ресурсов позволяет автоматизировать процесс поиска файлов для компоновки. После входа в систему Rational Build Forge и создания проекта разработчик может задать свойства процесса компоновки и выполнить другие действия для получения результатов компоновки.

Демонстрация интеграции, пример библиотеки и проект компоновки приведены на следующих веб-страницах: http://www.ibm.com/support/docview.wss?uid=swg27016509 и http://www.ibm.com/developerworks/offers/lp/demos/summary/r-assetmanagerrbf.html

Настройка интеграции

Прим.: Для интеграции требуется Ant версии 1.7.x и текущая версия API клиента. Файл ramclient.zip доступен на следующей странице веб-клиента: Справка > Расширения.
Rational Asset Manager предлагает следующие сценарии Ant, которые можно использовать в проектах Rational Build Forge:
  • ramDownloadAsset.xml - Загружает ресурсы в Rational Asset Manager для применения в проекте компоновки.
  • ramDownloadArtifactLinks.xml - Загружает связанные артефакты, необходимые для загруженных ресурсов в проекте компоновки.
  • ramPublishAsset.xml - Публикует результаты компоновки (например файл .ear) в качестве новых ресурсов Rational Asset Manager.
Эти сценарии необходимо скопировать из файла ramclient.zip на сервер компоновки вместе с зависимыми файлами JAR библиотеки Ant. См. Настройка сценариев для интеграции. Если все инструменты, библиотеки и зависимые компоненты доступны в качестве ресурсов Rational Asset Manager, то компоновку можно выполнить на основе этих ресурсов с помощью стандартных сценариев Ant. Кроме того, эти сценарии можно использовать с другими утилитами и решениями компоновки.
После копирования и настройки сценариев в среде выполните следующие действия:
  1. Загрузите необходимые инструменты, такие как компилятор, инструменты тестирования и общие сценарии.

    С помощью соответствующей библиотеки команд извлеките исходные файлы из системы управления конфигурацией программного обеспечения (SCM), такой как Rational ClearCase или Rational Team Concert. Из системы SCM необходимо загрузить файлы с исходным кодом для компоновки; например, библиотека клиента Rational Asset Manager необходима для применения сценариев DownloadAsset и Ant на сервере Rational Build Forge. Для проекта компоновки необходимо указать информацию о системе SCM, такую как URL сервера, ИД пользователя и пароль.

  2. Загрузите библиотеку клиента Rational Asset Manager с сервера Rational Asset Manager и извлеките ее содержимое, чтобы сценарии Ant можно было использовать на сервере компоновки.
  3. Загрузите зависимые артефакты, такие как открытый исходный код, модели, файлы wsdl и файлы xsd, указанные в качестве ссылок в исходных проектах. Если ссылки на требуемые артефакты Rational Asset Manager существуют, загрузите артефакты Rational Asset Manager и укажите расположение для их сохранения с помощью сценария DownloadArtifactLinks.

    AppScan позволяет выполнить поиск во всех исходных файлах и библиотеках проекта.

  4. Выполните компиляцию и тестирование.
  5. Опубликуйте результаты компоновки в Rational Asset Manager вместе с зависимостями всех компонентов и требуемыми взаимосвязями. В сценарии Ant PublishAsset укажите структуру каталогов ресурсов и другие свойства.

На основе примеров файлов можно создать новый проект с набором библиотек и данных конфигурации путем импорта содержимого файла .zip и файла eligibility.xml. Примеры файлов доступны по следующему адресу: http://www.ibm.com/developerworks/offers/lp/demos/summary/r-assetmanagerrbf.html. Rational Build Forge заново создает проект eligibility при загрузки файла eligibility.xml. Выберите Библиотеки, затем выберите библиотеку, такую как GetRamLibraries, для загрузки ramclient.zip. Затем измените эти файлы с учетом особенностей конкретной конфигурации. Дополнительно необходимо изменить сценарии Ant и добавить их в проект Rational Build Forge.

Дополнительная информация о требованиях Rational Build Forge для интеграции с Rational Asset Manager приведена в разделах Включение SSL для клиента API (Perl или Java), Порты по умолчанию, применяемые компонентами Rational Build Forge и Невозможно подключиться к серверу Build Forge в Rational Software Architect.

Выполнение проектов Rational Build Forge на отдельных этапах жизненного цикла ресурсов

В состав Rational Asset Manager входит стратегия, позволяющая запускать проект Rational Build Forge на конкретных этапах жизненного цикла ресурсов. Например, если ресурс программного обеспечения переходит из состояния разработки в промежуточное состояние в ходе подготовки к тестированию, то можно запустить проект Rational Build Forge, который автоматически компилирует программное обеспечение и развертывает его для просмотра другими пользователями.

Эта стратегия не устанавливается по умолчанию, однако входит в состав продукта. Для установки стратегии выполните следующие действия:
  1. В веб-клиенте щелкните на значке Справка и выберите Расширения.
  2. В разделе Стратегия Build Forge загрузите файл buildforge.zip. Не извлекайте содержимое файла.
  3. Нажмите Администрирование.
  4. На боковой панели Администрирование хранилища выберите Пользовательские расширения.
  5. В разделе Расширения стратегии выберите Создать расширение стратегии.
  6. В окне создания расширения введите com.ibm.ram.buildforge.policy.BuildGovernor в поле Имя класса
  7. В поле Файл .jar или .zip нажмите кнопку Обзор и выберите загруженный файл buildforge.zip. Затем нажмите кнопку ОК.

Дополнительная информация о стратегиях и жизненных циклах приведена в разделах Стратегии для жизненных циклов Rational Asset Manager, Разработка ресурсов и жизненные циклы и Создание пользовательских жизненных циклов.


Комментарии