Связывание С Использованием Содержимого Описания Списка Изменений

Связывание списков изменений и заметок о выпуске, собранных из Bugzilla и JIRA выполняются путем извлечения ключей проблем из дескрипторов списка изменений с помощью регулярных выражений. Чтобы иметь возможность настроить связывание вы должны понимать регулярные выражения в целом и захват групп в частности. Подробное Обсуждение регулярных выражений выходит за рамки данного руководства. При необходимости обратитесь к обширным ресурсам регулярных выражений, доступным в Интернете.

Чтобы включить связывание для конфигураций JIRA и Bugzilla, заполните многострочную запись "изменить, чтобы выдать шаблоны ссылок". Это поле должно содержать одно регулярное выражение на строку. Эти регулярные выражения будут использоваться для поиска и извлечения ключей выпуска из описаний списков изменений. Каждое регулярное выражение должно содержать одну или несколько групп захвата. Каждая группа захвата должна захватить ключ проблемы в формате, который точно соответствует формату, используемому отслежывателем проблем, для которого настроена привязка.

Совет

Для того чтобы связывание было эффективным, ваша команда должна разработать и согласовать простой, однозначный стандарт формата того, как ключи проблем упоминаются в дескрипторах списка изменений. Наличие этого стандарта позволит захватывать ключи выпуска с помощью регулярных выражений, введенных в разделе " изменение шаблонов ссылок выпуска" поле. Примерами такого стандарта могут служить следующие утверждения: "список изменений, содержащий исправление ошибки Bugzilla, должен содержать строку" Исправлена ошибка Bugzilla #<NNNN> " или " изменить список реализующий запрос на изменение должен содержать строку "Реализовано JIRA <PROJECT>-<PROJECT><NNN>".

Ниже приведены примеры регулярных выражений, которые можно использовать при настройке связывания на основе описаний списков изменений:

Bugzilla[a-zA-Z\s]*#([0-9]+) будет извлекать идентификаторы ошибок Bugzilla "5555" и "7777" из описаний списков изменений, таких как "начало работы над Bugzilla #5555 " и "рефакторинг: перемещенный метод; Исправлена ошибка bugzilla # 7777", соответственно.

Джира[а-за-З\С]* ([а-за-З]-[0-9]+) извлекает ключи выпуска Jira "MYPROJ-5555", "MYPROJ-7777" и "MYPROJ-1234" из описаний списка изменений, таких как" закрытая JIRA MYPROJ-5555", " исправленная JIRA MYPROJ-7777 и начал работать над JIRA MYPROJ-1234", соответственно.

Извлечение Заметок О Выпуске Из Bugzilla

Parabuild извлекает заметки о выпуске из Bugzilla, используя прямой доступ к базе данных Bugzilla, размещенной на сервере MySQL.

Драйвер MySQL должен быть установлен перед настройкой Bugzilla в качестве источника заметок о выпуске. Чтобы установить драйвер, выполните следующие действия:

1. Перейти к http://dev.mysql.com/downloads/connector/j/3.1.html

2. Скачать двоичный дистрибутив для MySQL Connector / J. Версий, доступных на момент написания этой статьи являются mysql-connector-java-3.1.13.tar.gz иmysql-connector-java-3.1.13.zip.

3. Untar/распаковать файл mysql-connector-java-3.1.13-bin.jar to <parabuild install dir>/lib/common/lib

4. Перезапустите экземпляр Parabuild

Чтобы добавить Bugzilla в качестве источника заметок о выпуске, выберите "Bugzilla- прямое подключение", используя выпадающий список доступных средств решения проблем, и нажмите кнопку" Добавить". На вкладке "примечания к выпуску" будет добавлена панель конфигурации Bugzilla. Заполните обязательные и необязательные поля ввода для завершения настройки. Значение каждого поля ввода на панели обсуждается ниже.

Рис. 5.11. Настройка Интеграции Bugzilla

Bugzilla MySQL Host

Поле ввода "Bugzilla MySQL host" содержит DNS-имя или IP -адрес сервера MySQL, на котором размещена база данных Bugzilla. Это обязательное поле.

Порт MySQL Bugzilla

Поле ввода "Bugzilla MySQL port" содержит номер порта сервера MySQL, на котором размещена база данных Bugzilla. Это обязательное поле.

База Данных MySQL Bugzilla

Поле ввода "Bugzilla MySQL database"содержит имя базы данных Bugzilla. Это обязательное поле.

Пользователь Bugzilla MySQL

Поле ввода" Bugzilla MySQL user" содержит имя пользователя, имеющего право доступа к базе данных Bugzilla. Это обязательное поле.

Пароль Bugzilla MySQL

Поле ввода" Bugzilla MySQL password " содержит пароль пользователя, имеющего право доступа к базе данных Bugzilla. Это обязательное поле.

Продукт Bugzilla

Поле ввода "продукт Bugzilla" содержит название продукта, для которого будет собран отмеченный релиз. Это обязательное поле.

Версия

Поле ввода "версия" содержит версию продукта, для которой будет собран указанный релиз. Это необязательное поле. Если версия не задана, будут запрошены примечания к выпуску для всех версий продукта.

Эмиссионный Фильтр

Поле ввода "фильтр проблем" содержит строку, которая используется для принятия решения о том, следует ли включать ошибку в примечания к выпуску. Parabuild будет искать сводку ошибки для этой строки и включит ошибку в примечания к выпуску, если строка будет найдена. Это необязательное поле. Фильтрация не выполняется, если фильтр не установлен.

Шаблон URL-адреса ошибки

Поле ввода "шаблон URL-адреса ошибки" может содержать необязательный шаблон URL-адреса, который Parabuild будет использовать для создания HTML-ссылок на своих страницах заметок о выпуске, чтобы указать на веб-интерфейс Bugzilla для быстрого доступа к деталям ошибки. Шаблон может использовать один ${bug.id} параметр шаблона.

Пример 5.51. Шаблон URL-адреса ошибки Bugzilla

http://bugzilla/track/show_bug.cgi?id=${bug.id}

Вкладка Параметры

Вкладка "параметры"позволяет настроить параметры, которые будут передаваться в сценарии сборки в качестве переменных оболочки. Также можно определить счетчик и шаблон, который может быть использован для генерации строки, содержащей версию продукта.

Счетчик Версий

Parabuild может отслеживать счетчик, который может быть использован для формирования строки, содержащей версию продукта. Строки версий, генерируемые Parabuild the, уникальны для данной конфигурации сборки. Параллельные сборки используют версию продукта, созданную ведущей сборкой. Для поддержки счетчика версий доступны следующие поля ввода и элементы управления:

· Установите флажок " Включить счетчик версий"

· Поле ввода " шаблон версии"

· Выпадающее " приращение счетчика версий"

· Установите флажок " приращение, если оно нарушено"

Значение каждого входного элемента управления обсуждается ниже.

Включить Счетчик Версий

Установите флажок "Включить счетчик версий", чтобы включить поддержку счетчика версий для этой конфигурации сборки. Если счетчик версий включен, Parabuild будет увеличивать счетчик версий автоматически или с помощью ввода при запуске сборки.

Шаблон Версии

Поле ввода "шаблон версии" позволяет ввести шаблон, который Parabuild будет использовать для формирования строки версии. Поддерживаются следующие параметры шаблона:

· build.name - содержит имя сборки.

· version.counter - contains value of the version counter.

· build.number- contains build number.

· Пример: Мой продукт 2.5.${version. counter}.${build. number}

· 5.12.1.3. Приращение Счетчика Версий

· Используйте выпадающий список "приращение счетчика версий", чтобы выбрать ручной или автоматический режим приращения для счетчика версий. Если выбран ручной режим, Parabuild не будет увеличивать счетчик. Вам придется ввести значение счетчика вручную, когда будет запрошен запуск сборки. Если выбран автоматический режим, Parabuild автоматически увеличит счетчик версий или будет использовать значение, введенное вручную при запросе запуска сборки.