Глава 11

Глава 11 Конфигурационное управление с применением ClearCase Merging Глава 11

Цели • Изучив эту главу, вы сможете: • Понимать, как в ClearCase работает алгоритм слияния • Сливать файловые элементы • Выполнять специальные типы слияний • Использовать Merge Manager для автоматизированного слияния Глава 11

Слияние - обзор Изменения, производимые над элементами, легко распространяются от ветви к ветви. ClearCase обеспечивает богатый набор возможностей, чтобы сделать процесс слияния более автоматизированным. Если слияние выполнено, разработка может продолжаться вдоль ветви Отсутствуют какие-либо ограничения для возможных слияний, как по частоте, так и по направлениям Глава 11

Алгебра слияния Глава 11

Определение базовой участника (Base Contributor) Если все участники – версии одного и того же элемента, то ClearCase определяет ближайшего базового участника для сравнения и позволяет автоматическое слияние Если все участники – не версии одного и того же элемента, то базовый участники не определяет-ся. Автоматическое слияние невозможно. Вам предлагается ручное слияние файлов Глава 11

Возможности слияния Графические средства позволяют c использовать как опции из меню так и «мышь» Командная строка поддерживает различные опции слияния Можно сливать до 32 участников Утилита Merge Manager просматривает определенную пользователем последовательность версий и сообщает какие слияния требуется произвести Глава 11

Возможности слияния (продолжение) Диалоговое окно позволяет Вам: Просматривать содержимое базового файла и файлов-участников слияния Просматривать и редактировать результаты слияния Определять, когда ClearCase запросит вмешательства пользователья (Navigate в контекстном меню) Перезапускать процесс слияния (при выходе из контекстного меню выберите Restart Merge). Процесс слияния не завершается и не записывается полностью, пока Вы не выйдете из окна слияния Глава 11

Пример слияния: В этом примере: База - Hello.txt@@\main\2. Участники - Hello.txt@@\main\3 и Hello.txt@@\CHECKEDOUT Глава 11

Начало слияния Глава 11

Проверка результатов слияния После выполнения Diff Merge проверьте результаты слияния через Version Tree Browser и выполните check in по окончании Глава 11

Подтверждение слияния Глава 11

Результат слияния Необходимо принятие, удаление или редактирование строк слияния Глава 11

Результаты слияния В результате слияния ClearCase: Переименовывает существующий файл в file.contrib Размещает результаты слияния в checked-out версию файла Записывает слияние в базу данных VOB с гиперссылкой Глава 11

Слияние Unreserved Checkout Если имеются наследственные версии, то над Unreserved Checkout нельзя сделать операцию checkin. В окне checkin отобразится: Unreserved Checkout должны быть слиты с LATEST до того, как над ним быдет произведена операция checkin. Глава 11

Слияние Unreserved Checkout (продолжение) Утилита Diff Merge сливает версии, остающегося unreserved файла, над которыми должна быть совершена операция checkin Глава 11

Слияние директорий – обзор Каждая версия директории содержит файловые элементы, элементы-директории, символические связи VOB. Слияние директории может использовать 2 или более версии одной и той же директории. Результат слияния – новая версия директории, отражающая содержание всех участников слияния. Слияние директории не может обрабатывать 2 различные директории-элемента (т.е. src и include не могут быть слиты). При слиянии директорий не остается .contrib- директории. Глава 11

Слияние директорий – примеры. Перед слиянием 2 ветви src директории имеют различное содержание. I:dcrowe_hw\cleartool ls src Src@@\main\LATEST Src@@\main\LATEST\date.c@@ Src@@\main\LATEST\hello.c@@ Src@@\main\LATEST\hello.h@@ Src@@\main\LATEST\Makefile@@ Src@@\main\LATEST\sys.c@@ Src@@\main\LATEST\util.c@@ J:dcrowe_hw\cleartool ls src Src@@\main\LATEST Src@@\main\LATEST\clock.c@@ Src@@\main\LATEST\ date.c@@ Src@@\main\LATEST\hello.c@@ Src@@\main\LATEST\time.c@@ Src@@\main\LATEST\util.c@@ Глава 11

Слияние директорий (продолжение) Чтобы выполнить слияние директории надо: Удостовериться, что Config spec выбирает нужную версию. Убедитесь, что все участвующие версии в состоянии checked in Извлечь результирующую версию директории. Начинайте слияние незамедлительно, без каких-либо изменений проверенных версий. Пример: В этом примере последняя версия «улучшенной» ветви будет слита с основной ветвью. Check in src@@\main\enhance\LATEST Формирование View поумолчанию: Element * checkout Element * \main\LATEST Check out src@@\main\enhance\LATEST Глава 11

Слияние директорий (продолжение) В окне Diff Merge, выберите изменения для директории слияния Глава 11

Слияние директорий (продолжение) Содержание директории может быть просмотрено через Windows Explorer или Cleartool ls. I: \dcrowe_hw > Cleartool ls src src@@\main\enhance\LATEST src@@\main\enhance\LATEST\clock.c@@ src@@\main\enhance\LATEST\date.c@@ src@@\main\enhance\LATEST\hello.c@@ src@@\main\enhance\LATEST\Makefile.c@@ src@@\main\enhance\LATEST\sys.c@@ src@@\main\enhance\LATEST\time.c@@ src@@\main\enhance\LATEST\util.c@@ Глава 11

Merge Manager– обзор Когда требуется большое число исходных файлов для частого ветвления и слияния, Manager слияния требует много ручной работы, несвязанной с параллельной разработкой. Manager слияния обеспечивает графический интерфейс, для определения файла, который будет слит и представления слияния. Глава 11

Использование Merge Manager Выберите View, который Вы хотите слить. Это может быть как Динамический, так и Snapshot View. Глава 11

Использование Manager слияния (продолжение) Выберите особые элементы, которые Вы хотели бы слить Глава 11

Использование Manager слияния (продолжение) Выберите метод выбора версии каждого элемента для слияния Глава 11

Использование Manager слияния (продолжение) Укажите дополнительную информацию Глава 11

Использование FindWizard Кликнете на Find, когда сформируете свой выбор критериев слияния. Глава 11

Слияние с помощью CLI Команда Cleartoolmerge поддерживает задание опций слияния в командной строке. Выполнение слияния из командной строки: Команда Cleartoolmerge поддерживает богатый набор опций для выполнения слияния из командной строки Сделайте Checkout для результирующей версии Выполните слияние Пример: I:\dcrowe_hr\src>cleartool cats Element * CHECKOUT Element * \main\LATEST I:\dcrowe_hr\src>cleartool checkout –nc util.c I:\dcrowe_hr\src>cleartool marge –to util.c –qall –version \main\qa\LATEST Глава 11

Слияние с помощью CLI Команда –out в Cleartool merge используется для слияния 2-х версионных файлов во View-private файл. Пример: Слияние последней версии на ветви bugfix с версией в Вашем View. Результат кладется во View-private файл, называющийся mrgtst.c: I:\dcrowe_hr\src>cleartool marge out mrgtst.c util.c util.c@@\main\rel2_ bugfix \LATEST ****************************************************************** <<<file 1:I:\dcrowe_hr\src\util.c@@\main\1 >>> file 2: util.c >>> file 1:util.c@@\main\rel2_ bugfix \LATEST ------[after 15 file]----------|----------------[inserted 16-17 file 2]------- … Output of marge in is “mrgtat.c”. Глава 11

Контроль результатов слияния. Всегда полезно проверять результат слияния перед операцией checkin I: \dcrowe_hw\src > clearmake hello.exe I: \dcrowe_hw\src > hello Hello, dcrowe! Your home directory is ‘default’ in the standard area. It is now Thu Feb 25 11:12:03 1999. I: \dcrowe_hw\src > cleartool checkin util.c Глава 11

Просмотр результата слияния В версионном окне Properties/ Custom отображается информация о гиперссылке слияния Глава 11

Selective Merge Обычно mergeиспользует совокупную последовательность изменений С помощью опции –insert, можно явно указать версию из ветви для слияния Для этого типа merge стрелки слияния не создаются, в отличие от обычного типа слияния. Глава 11

Subtractive Merge Разностное слияние удаляет из checked-out версии изменения, сделанные в одной или более ее предшественниц. Используйте –delete для пометки версии или нескольких версий для вычитания. Пример: I: \dcrowe_hw\src > cleartool checkout hello.c I: \dcrowe_hw\src > cleartool merge to hello.c –delete –version \main\branch\5 \ main\branch\7 Глава 11

Аннотированные отчеты – обзор Показывает содержание версии и аннотирует каждую строку с указанием в какой версии строка была добавлена Только text_files или compressed_text_files могут быть аннотированы. Вывод по умолчанию во View-Private файл: filename.ann. Если генерация происходит с помощью Cleartool annotate, то вывод может быть сформатирован несколькими путями с использованием опции –fmt. Глава 11

Аннотированные сообщения – пример По умолчанию, выходная строка команды Cleartool annotate включает только текстовые строки Чтобы изменить формат, заданный по умолчанию: Используйте опцию –rm, чтобы включить строки, перенесенные в одну или несколько верси по нисходящей ветви. Используйте опцию –all, чтобы включить строки из всех версий, кроме тех, которые расположены по нисходящей ветви. I:\dcrowe_hw\src > cleartool annotate hello.c Annotated result written to “hello.c.ann” Глава 11

Формат отчета Глава 11

Контрольные вопросы Как в ClearCase осуществляется ручное слияние? Что такое базовый участник слияния? Какая процедура GUI используется для осуществления слияния нескольких файлов одновременно? Что такое subtractive merge и selective merge? Глава 11

Глава 11

Глава 11

Presentation Transcript