Команда Для Создания Метки Сборки

Поле "Command to Label Build" может содержать команду, которая может быть использована для маркировки или пометки содержимого внешнего VCS в данный момент времени. Эта команда может быть вызвана, если запуск сборки прошел успешно и если маркировка включена. Следующие переменные оболочки доступны для сценария оболочки "Command to Label Build"::

· PARABUILD_LABEL_TO_CREATE содержит имя метки, которая должна быть применена к состоянию внешнего VCS в данный момент времени.

· PARABUILD_LABEL_TIMESTAMP содержит количество миллисекунд, прошедших с полуночи 1 января 1970 года UTC.

· PPARABUILD_LABEL_DATETIME содержит строковое представление метки времени, к которой должна быть применена метка в "yyyyMMddHHmmss" формат.

· PARABUILD_CONFIGURATION_IDсодержит уникальный общесистемный идентификатор, присвоенный этой конфигурации сборки.

· PARABUILD_BUILD_NAME содержит имя, присвоенное этой конфигурации сборки.

Команда Удаления Метки

Поле "команда для удаления метки" может содержать команду, которая может быть использована для удаления метки или тега, ранее созданного Parabuild во внешнем VCS. Эта команда может быть вызвана, если настроена очистка меток. Следующие переменные оболочки доступны для сценария оболочки "команда удаления метки":

· PARABUILD_LABEL_TO_DELETE содержит имя метки, которую следует удалить.

· PARABUILD_CONFIGURATION_IDсодержит уникальный общесистемный идентификатор, присвоенный этой конфигурации сборки.

· PARABUILD_BUILD_NAME содержит имя, присвоенное этой конфигурации сборки.

Обработка Ошибок

Команда оболочки, описанная в предыдущих разделах, должна возвращать ненулевой код ошибки, если что-то идет не так. Если команда возвращает ненулевой код, Parabuild соберет ограниченное количество строк из хвоста stderr выход. Выходные данные будут отправлены администратору сборки для уведомления об ошибке.

Настройка Общего Доступа К Системе Контроля Версий

Parabuild предоставляет возможность настроить доступ к универсальной системе управления версиями. Универсальная система управления версиями может быть использована для интеграции Parabuild с системой управления версиями, с которой Parabuild еще не интегрирован. Кроме того, эта функция может быть использована для доставки пользовательской интеграции, если один раз включенная в Parabuild не соответствует вашим потребностям. Использование этой функции требует обширных знаний других языков, таких как bash, Perl, Java и тому подобных.

Parabuild интегрируется с универсальной системой управления версиями, вызывая сценарии оболочки в соответствии с определенным протоколом доступа к системе управления версиями, как это видно из Parabuild.

Parabuild предоставляет параметры конфигурации сборки скриптам оболочки. Параметры передаются в виде переменных оболочки.

Команда Shell должна вызываться в соответствии с правилами конкретной ОС: пример для вызова bash:bash /op/sripts/get_changes.sh. Пример для вызова cmd: звоните C:\scripts\get_changes.bat

Протокол, команды и их параметры обсуждаются ниже.

Команда Для Получения Изменений

Parabuild выдает эту команду каждый раз, когда ему приходится опрашивать систему управления версиями на предмет новых изменений в соответствии с расписанием сборки. Если изменения присутствуют, эта команда должна вывести набор записей изменений с разделителями строк вstdout. Parabuild будет анализировать выходные данные в соответствии с параметрами парсера. Параметры вводятся в соответствующие поля ввода. Значение каждого поля обсуждается ниже.

Параметры Парсера

Делитель колонн это строка, разделяющая столбцы в записи изменений. Разделитель столбцов должен содержать набор символов, которые вряд ли будут присутствовать в записи изменений. Пример:w0Fg9.

Конец записи маркер-это строка, которая отмечает конец записи изменения. Маркер конца записи должен содержать набор символов, которые вряд ли будут присутствовать в записи изменения. Пример:bH56d. Конец маркера записи должен сопровождаться разрывом строки.

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

Изменение Формата Записи

Формат записи изменений выглядит следующим образом:

<User name=""><Column divider=""><Change date=""><Column divider=""><File name=""><Column divider=""><Revision><Column divider=""><Change type=""><Column divider=""><Change comment=""><Column divider=""><End of="" record="" marker="">

Столбец даты изменения должен соответствовать формату, определенному в поле "изменить формат даты". Пример формата- yyyyMMdd.Хммм.

Тип изменения должен содержать один из следующих литералов sting:checkin, mkelem, add, delete или remove.

Параметры

Следующие переменные оболочки доступны для "Get Изменения " shell script:

· PARABUILD_SINCE_TIMESTAMP содержит отметку времени, с которой можно начать поиск изменений. Это число миллисекунд, прошедших с полуночи 1 января 1970 года UTC.

· PARABUILD_SINCE_DATETIME содержит строковое представление метки времени в " yyyyMMddHHmmss - формат.

· PARABUILD_CONFIGURATION_IDсодержит уникальный общесистемный идентификатор, назначенный этой конфигурации сборки.

· PARABUILD_BUILD_NAME содержит имя, присвоенное этой конфигурации сборки.