Читайте также статьи и материалы о технологиях Rational и Microsoft в блоге Новичкова Александра и Шамрая Александра

Зачем нам нужен план управления конфигурациями? Основные понятия и концепции документа

Зачем нам нужен план управления конфигурациями? Основные понятия и концепции документа

Видео и презентационные материалы в тему статьи

Позволяет интегрировать ClearQuest и MS Project. Модуль позволяет осуществлять более глубокую интеграцию, чем стандартный модуль Rational. При формировании интеграции между базой ClearQuest и планом MS Project модуль дает гибкие возможности по выбору полей и их соответствий (синхронизируемые данные).
Принципиальная возможность модуля заключена в том, что он позволяет синхронизировать любые поля плана с репозиторием ClearQuest, а также синхронизировать иерархию между пунктами плана и зависимость пунктов!!!
Данная часть демонстрирует возможности модуля интеграции при планировании работ менеджером из MS Project.

  Зачем нам нужен план управления конфигурациями? Основные понятия и концепции документа (полная версия в блоге Новичкова Александра)

Автор: Новичков Александр, Лапыгин Дмитрий

• Что такое план?
  
• Кто пишет план?
  
• Когда готовят план УК?
  
• Поддержка плана в актуальном состоянии
  
• План УК в стандартах
  
• Стандартизация и классификация
  
• Структура типового плана УК с комментариями к разделам
  
• Полнота плана УК в зависимости от объема проекта и его типа
  
• Как заставить участников читать план?
  
• Примеры содержимого (выдержки из разных планов)
  
• Примеры структур планов
  
• Финальный план УК государственной компании
  
• Финальный план УК системного интегратора
  
• Начальная версия плана УК билинговой компании
  
• Структура плана для разработки системы в реальном масштабе времени
  

Разработка плана управления конфигурацией

Всегда не хватает времени, чтобы выполнить работу как надо, но на то, чтобы ее переделать, время находится…

Что такое план Управления Конфигурациями?

Многие компании при попытке поставить любой процесс (не важно какой, но в данном случае – Управления Конфигурациями) ограничиваются только инсталляцией программных средств с минимальными затратами в дальнейшей работе. Так был загублен не один проект. Во-первых, всегда должна быть планомерная работа. А во-вторых, сначала внедряется процесс, а потом инсталлируются средства автоматизации (уж никак не наоборот). Соответственно, если есть процесс, то должен быть документ, описывающий его. Таким документом для процесса УК является «План управления конфигурациями», где излагается концепция процесса и имплементация средств автоматизации. В нем же расписываются все роли, и, что особенно важно, деятельности в зависимости от стадии жизненного цикла разработки ПО.

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

План должен быть документально оформлен и выполнен (план может быть частью плана управления конфигурацией системы).

План на высоком уровне определяет процесс разработки ПО. План также содержит в себе много административных моментов, которые необходимо реализовать в настройках инструментальных средств УК, чтобы они соответствовали плану.

Кто пишет план?

По большому счету написание плана – коллективная работа. Здесь задействованы все участники проекта, так как на основе их информации и рождается план УК.

Если говорить применительно к терминологии УК, то есть роль, которая отвечает за физическое написание плана – Менеджер УК.

Менеджер Управления Конфигурациями – ключевая роль. Этот человек знает процесс разработки. Понимает цели и задачи УК. Все свои знания он излагает в плане УК. Сам управляет процессом УК.

Очень часто пытаются либо вообще обойтись без такой роли, либо «спихивают» ее на разработчиков. Естественно, это неправильно, так как разработчик не видит всей картины процесса разработки, может не понимать структурных взаимодействий между отделами… и т.д. Перечень непониманий можно продолжать далее. На первых порах, на порах становления роль менеджера берет на себя человек, который имеет представление о процессе разработки. Такой человек всегда есть в коллективе, как правило, это лидер разработчиков или руководитель отдела разработки.

Техническое применение плана (реализация плана в средствах поддержки УК)

Как мы уже говорили выше – план содержит высокоуровневое описание процесса, но чтобы инструментальные средства поддержки УК начали следовать плану, необходимо выполнить их физическую настройку:

• Установить средства;
• Разработать экранные формы запросов на изменение;
• Установить политику доступа;
• Определить жизненный цикл запросов на изменение;
• Поставить данные под УК в соответствии с планом;
• И т.д.

Физическую настройку обычно проводит администратор, который на основании имеющегося плана проводит физические настройки инструментальных средств УК.

Когда готовят план УК?

План разрабатывается на ранних стадиях общего планирования проекта. План должен быть подготовлен на самых ранних стадиях, еще до того, как разработчики включили компьютеры – момент проработки технического задания уже нужно писать план УК. Это в идеале. На практике, как правило, процесс уже сложился и его требуется сначала описать, а потом, по потребностям модифицировать, улучшить.

Что хорошо в плане УК, так это то, что он долго пишется всего один раз. Далее для каждого проекта пишется новый план, на основе существующего, так как способы и методы в новом проекте могут отличаться, то и план описывает все особенности данного проекта. Иногда применяется практика выделения общих частей плана УК и утверждение их как составная часть стандарта на разработку в компании. После чего каждый проект использует общий план + выпускает к нему набор дополнений для конкретного проекта. Впрочем набор дополнений не может противоречить основному плану.

Поддержка плана в актуальном состоянии

План рассматривается всеми участниками процесса и рецензируется ими.

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

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

Очень часто при обследовании компаний, нам приходится сталкиваться с тем, что имеющийся план не соответствует тому процессу, который существует в организации. Самое любопытное заключено в том, что если специалисты на ранних этапах внедрения отслеживали актуальность плана, то со временем план УК (а вместе с ним и большинство документов по другим процессам) постепенно «задвигается» и работа по нему прекращается. И получается очень занятная ситуация: с одной стороны, если идти по формальным признакам, в организации есть процесс и есть НМО, описывающее его. С другой стороны, по факту, НМО описывает нечто, чего уже нет в организации. В итоге можно считать, что в организации нет плана УК, так как он не отражает реалии.

С подобным ходом вещей необходимо нещадно бороться. Мы все прекрасно понимаем, что нормальное состояние человека и организации это совершенствование (совершение процесса, самосовершенствование… и т.д.) имеющегося. Просто насущно необходимо совершенствовать документацию по процессу вместе с самим процессом. Их эволюционирование должно осуществляться параллельно. Только тогда можно будет говорить о зрелости процессов в организации.

План УК в стандартах

План УК является важнейшим документом процесса. По большому счету он является единственным документом процесса УК. Состав и содержимое плана УК определяется в некоторых стандартах, но в большинстве случаев существенно дорабатывается под нужды конкретной организации или проекта при внедрении процессов ЖЦ ПС. Все рассмотренные в данные книге стандарты определяют процесс, роли, но не все определяют и классифицируют планы УК. Рассмотрим подробнее требования стандартов на содержимое планов УК:

Таблица 1 – Определение структуры плана УК в стандартах

Стандартизация и классификация

На сам план при его разработке влияют множество факторов. Структура плана УК, и его содержание, зависит от таких факторов, как тип проекта и его длительность, уровень формализации процессов, размер команды (наличие регионально распределенных групп), количество субподрядчиков, и многих других. Это означает, что структура плана, состав приложений могут в достаточно больших пределах варьироваться, сохраняя при этом единый «дух».

Рассмотрим факторы, влияющие на структуру плана УК:

• Тип проекта;
• Относительный размер проекта;
• Количество конфигурационных элементов;
• Число компонентов и подсистем;
• Наличие нескольких офисов (регионально распределенная разработка);
• Фаза жизненного цикла;
• Модель разработки;
• Доступность (наличие) средств УК и иных смежных средств;
• Уровень формализации (как процессов организации, так и тип контроля плана).

Проведем детализацию, выделив возможные значения по факторам, так как показано в таблице ниже.

Таблица 2 – факторы, влияющие на структуру плана УК и его детализацию

Структура типового плана УК с комментариями к разделам

Существует бесконечное множество вариаций на тему плана УК. Ниже представлены основные разделы плана и объясняется, почему они необходимы. Отметим, что данная структура – усредненная и представляет собой выборку из планов УК, составленных нами в реальных проектах.

Таблица 4 – Структура плана УК

Полнота плана УК в зависимости от объема проекта и его типа

Японская мудрость гласит: «Чем завтра сто, лучше сегодня пятьдесят». Применительно к плану УК ее можно перефразировать как: «Лучше полплана сегодня, чем полный завтра».

Просмотрев структуру и содержание плана, у читателя может сложиться ощущение, что написание плана это отдельная непосильная наука, и вообще, план нужен только в очень больших проектах. К сожалению такое мнение бытует во многих софтверных компаниях (в отраслевых компаниях ситуация несколько лучше). Как правило, в подобных организациях присутствует некий недокументированный процесс разработки, либо есть фрагменты документов по процессу, но в силу низкой культуры коллективной работы отсутствует планирование как класс.

План УК должен быть разработан. Вопрос в том насколько он должен быть детальным и формальным. Нам очень часто приходится слышать от клиентов фразы, смысл которых в том, что нам для нашего маленького проекта планирование нужно. Это мнение неправильно в корне. Планирование должно быть всегда, вопрос только в глубине изложения.

Мы попытались облегчить задачу выбора степени детальности изложения, привязав пункты плана УК к относительному размеру проекта.

Применяется следующая градация:

• Малый – в этом проекте участвуют 2-7 разработчиков, тестировщиков почти нет, либо разработчики сами выполняют тестирование. Также в данную категорию могут попасть проекты, в которых нет параллельной разработки – то есть у каждого разработчика есть свой круг решаемых задач. Роли определены не четко. Команда находится в одной комнате;
• Средний – это проект, в котором участвуют более 6 разработчиков. Ведется разработка коробочных продуктов на продажу. В команде есть выделенные роли: разработчики, тестировщики, аналитики, системные аналитики. Разделение достаточно четкое, но есть совмещение ролей. Все участники находятся в одном офисе, но в разных рабочих комнатах.
• Крупный – тоже, что и средний, но возможно, работа над проектом ведется с несколькими субподрядчиками. Сама компания разбросана по нескольким регионам. В компании много параллельно идущих проектов.

Применена следующая градация:

• Обязательность пункта – нужен ли данный пункт плана в проекте данного типа, можно ли отказаться от пункта без ущерба целостности логической стройности плана УК.
• Детальность изложения – насколько глубоко необходимо проработать раздел. Какова его детальность? Нужно ли вносить дополнительные подпункты, раскрывающие значения основных пунктов?
• Формальность изложения – этот пункт больше относится к стилю и коррелируется с детальностью и обязательностью. Для желательного раздела в маленьком проекте допускается нестрогий стиль изложения.

Таблица 3 – обязательность, формальность и глубина изложения пунктов плана УК.

Сокращения к таблице:

О – обязательно; Ж – желательно, П – можно пропустить.

ВД – высокая детальность, СД – средняя детальность, НД – низкая детальность.

Ф – формально, НФ – неформально.

Как заставить участников читать план?

Подобная проблема встречается во всех организациях и касается не только плана. Зачастую исполнители не читают инструкций, планов, методик и всех прочих документов, так как считают это бесполезной тратой времени. Либо график работ настолько плотный, что просто не остается рабочего времени на чтение, а свободно тратить на «белиберду» никто не хочет. Руководство в попытках решить проблему, как правило, ограничивается только административными мерами (запугивание, обязаловка… и т.д.), что есть не совсем правильно. Жизненный опыт показывает, что нужно комбинировать сразу несколько методов, посредством которых можно заставить специалистов прочитать НМО, причем сделать так, чтобы инициатива исходила от них самих.

Опишем основные методы:

Таблица 4 – методы и принципы воздействия на исполнителей

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

Примеры содержимого (выдержки из разных планов)

Мы долго мучались над данным разделом: включать его в книгу или не включать? Ведь любой «живой» план УК является неотъемлемой частью организации и являет собой описание процесса разработки, что может являться (и должно являться) секретом для всех окружающих.

Долго подумав, мы решили выйти следующим образом: данный раздел будет содержать общие слова, таблицы и т.д. не раскрывая секретов разработки. Примерные планы из открытых источников (учебно-треннировочные планы) приведены в приложении.

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

В некоторых случаях, если формулировки в разных планах существенно отличаются, то мы приводим выдержки из нескольких планов.

1. Введение

Настоящий документ предназначен для планирования и документирования процессов управления конфигурацией и управления изменениями в проекте «***»

В соответствии с ГОСТ Р ИСО/МЭК 12207 процесс УК включает в себя как задачи идентификации и контроля конфигураций ПС. Так и задачи контроля внесения изменений в ПС. План конфигурационного управления (ПКУ) описывает все задачи контроля конфигурации и изменений, которые будут выполняться в ходе проекта. ПКУ определяет последовательность выполнения задач, ролевые функции и ответственность участников проекта, и требуемые ресурсы, включая персонал, инструментарий и оборудование.

1.1 Назначение

(вариант 1)

Целью настоящего документа является определение, адаптация и описания процессов управления конфигурацией и изменениями при внедрении технологии фирмы IBM Rational Software для пилотного проекта создания и сопровождения системы «***».

(вариант 2)

Целью настоящего документа является определение процесса управления конфигурациями, включая управление изменениями, в условиях распределенной разработки программных средств (ПС), проводимой силами территориально удаленных между собой подразделений и организаций «***» и их субподрядчиков.

1.2 Область применения

Действие документа распространяется на процессы управления изменениями и конфигурационного управления при распределенной разработке ПС.

Все подразделения и организации «***» и их субподрядчики, участвующие в проекте разработки ПС, организуют процессы управления изменениями и конфигурационного управления в указанном проекте на основании положений настоящего документа.

1.3 Определения, акронимы и сокращения

(вариант 1)

(вариант 2)

Базовая версия (baseline) – перечень всех версий элементов, составляющих одну или более компонент системы в фиксированный момент времени. Обычно используется для фиксации стабильного состояния системы, которое может быть использовано в дальнейшем процессе разработки.

Версионное хранилище (VOB, versioned object base) – репозиторий, хранящий версии файлов и директорий, результаты сборки и ассоциированные с ними метаданные.

1.5 Обзор содержания

Настоящий документ состоит из следующих разделов:

• Организация, распределение ответственности и взаимодействия – раздел содержит описание организации процесса разработки программных средств, распределение ответственности и описание взаимодействия между участниками проекта;
  
• Инструментарий, рабочая среда и инфраструктура – раздел содержит перечень и описание инструментальных средств, применяемых участниками проекта в ходе работы, характеристики рабочей среды проекта и используемой для ее создания инфраструктуры;
  
• Конфигурационная идентификация – раздел описывает методы идентификации учетных элементов конфигурации (компонентов ПС и отдельных артефактов) проекта и процедуру управления базовыми версиями проекта;
  
• Контроль конфигурации и изменений – раздел описывает процедуры отработки и утверждения основных типов запросов и их атрибуты. Раздел также включает описание группы управления изменениями, ответственной за принятие решений по поступающим запросам;
  
• Учет состояния конфигурации – раздел содержит правила хранения и резервирования конфигурации ПС, описывается процесс выпуска релизов, отчеты и проверки состояния конфигурации.
  

2. Конфигурационное управление программным продуктом

2.1. Организация, распределение ответственности и взаимодействия

(пример 1)

(Пример 2)

В ходе проекта разработки ПС УК применяется для поддержки всех основных процессов жизненного цикла ПС.

Для обеспечения процесса конфигурационного управления используется существующая организационная структура, представленная следующими рабочими группами:

• группа планирования;
  
• группа мониторинга;
  
• группа методологии;
  
• группа проектирования;
  

   

  ***
  

  ***
  

  ***
  

В процессе УК используются следующие ролевые функции:

• Аналитик – отвечает за анализ и проектирование, выполняемое на основе заданий по запросам на изменение;
  
• Сборщик – отвечает за интеграцию результатов выполнения заданий, создание базовых версий и проведение сборки ПС;
  
• Разработчик – отвечает за разработку, отладку и модификацию компонентов ПС в соответствии с ТЗ.
  

  ***
  

  ***
  

  ***
  

(пример 4)

Всеми полномочиями по управлению проектом и качеству наделяется группа проектного офиса, находящаяся в рамках организации. Тестирование осуществляет внешняя подрядная организация (она же Заказчик ПО).

Отел УК предоставляет проектному офису квалифицированный персонал для осуществления действий по УК и всю необходимую координацию совместных действий.

Рабочая организация делится на три группы: «Разработчики», «Технические писатели». Внешняя – «Тестировщики».

Все группы подчиняются менажеру проектного офиса.

Менеджер проектного офиса ответственен за все проектные решения. Он является председателем CCB.

Рисунок 1 – Иерархия проектных групп

***

***

***

(пример 4)

Для обеспечения высокого качества за реализацию проекта в целом отвечает диспетчер проектного офиса, и является председателем CCB. Менеджер УК является сопредседателем CCB. Интегратор и администратор подчиняются непосредственно менеджеру проекта для обеспечения высокой скорости и качества выполняемых работ.

Рисунок 2 – Иерархия проектных групп

***

***

***

2.1.1 Взаимодействие участников проекта

(пример 1 – мультирегион)

Все участники проекта взаимодействуют на основе распределенного Репозитория в одном из двух режимов:

• Локальном – при обмене информацией в пределах одной локальной сети;
  
• Глобальном – при обмене информацией между участниками проекта, работающими в географически удаленных сетях.
  

Локальный режим взаимодействия обеспечивается локально расположенными версионными хранилищами, входящими в состав репозитория, и стандартным интерфейсом Rational ClearCase и Rational ClearQuest.

Глобальный режим взаимодействия обеспечивается географически распределенными версионными хранилищами, входящими в состав репозитория и синхронизируемыми с помощью Rational ClearCase MultiSite. Для доступа к репозиторию пользователей используется стандартный интерфейс Rational ClearCase и веб-интерфейс Rational ClearQuest.

***
***

***

1. Политика полномочий
   

Доступ к проекту имеют только определенный круг лиц согласно ролям в проекте. Реализуется средствами операционной системы через создание группы проекта и предоставления ей прав на директорию репозитория.

Удалять элементы УК и версии элементов УК может только интегратор (по запросу в ClearQuest от остальных участников проекта).

Ставить элементы под УК могут:

• Файлы польз. док. – тех. Писатели;
  
• Файлы исходных текстов – Разработчики;
  
• Проектная документация – Аналитики, Архитекторы, Разработчики (ПЗ);
  
• Модели – Аналитики, Архитекторы;
  
• Бинарники – Интеграторы;
  
• Тестовые Скрипты – Тестировщики;
  
• Планы – Архитектор (Рук.проекта).
  

Все операции с метками имеет право делать только интегратор.

Бренчи может создавать только интегратор.

Создавать или изменять профили может только интегратор или менеджер конфигурации.

(пример 1 формирование таблицы политики доступа. Отталкиваясь от ролей)

***
***

***
(пример 2 – формирование таблицы политики доступа. Отталкиваясь от операций)

***
***

***

2.2 Инструментарий, рабочая среда и инфраструктура

***

***

***

В процессе разработки ПС участниками проекта применяются программные средства, представленные в следующей таблице:

***

***

***

2.2.1 Рабочая среда

Окружение инструментария УК:

• Операционная система Windowd 2000 Advanced Server для серверов ClearCase и ClearQuest.
  
• СУБД MS SQL Server для хранилища данных ClearQuest
  
• Операционная система Windows 2000 Professional / Windows XP Professional для клиентов. MS Office XP.
  
• Все сервера и рабочие места являются членами домена Development.
  

Сервера СС и CQ физически находятся в серверном помещении организации. Все пользователи находятся в одном сегменте локальной сети. Рабочие места физически находятся на территории организации.

Примечание:

Рабочая среда может не включаться в основные разделы плана, а быть приложением.

2.2.2 Программно-аппаратный комплекс

В каждом проекте следует иметь описание конфигураций используемых рабочих станций и серверов (как приложение к плану). Описание должно содержать следующие данные:

• Сетевое имя сервера/рабочей станции.
  
• Используемая операционная система.
  
• Используемое ПС.
  

   

2.2.3 Интерфейсы и интеграция

В проектах определяются используемые интерфейсы взаимодействия инструментов конфигурационного управления и управления изменениями для следующих пар взаимодействия:

• Rational RequisitePro и ClearCase – интеграция на основе периодического внесения артефактов управления требованиями под версионный контроль в составе базовых версий.
  
• Rational RequisitePro и ClearQuest – интеграция на основе стандартной схемы ClearQuest Enterprise, поставляемой Rational.
  
• ***
  

***

***

***

2.2.4 Инфраструктура

Процессы конфигурационного управления базируются на версионном контроле артефактов проекта и управлении изменениями в ПС. Для задач версионного контроля используются географически распределенные версионноые хранилища под управлением Rational ClearCase и Rational ClearCase MultiSite. Для задач управления изменениями используется централизованная БД ClearQuest с возможностью доступа через веб-интерфейс.

БД ClearQuest используется для хранения запросов на изменения, возникающих в ходе проекта. Все проекты используют единую базу данных и единую схему обработки запросов на изменения.

БД ClearQuest входит в состав центрального репозитория и не реплицируется в локальные репозитории рабочих групп.

3. Программа конфигурационного управления

Система УК организации используется на протяжении всего жизненного цикла разработки продукта. Система УК содержит текущую и предыдущие версии файлов требований, проектирования и реализации, которые идентифицируют определенную версию системы или компонента системы. Система УК содержит также репозиторий запросов на изменение системы.

Этап работ УК связан со всеми остальным этапами работ, т.к. работы связаны с обслуживанием репозитория артефактов, полученных на других этапах работ (анализ и дизайн, разработка, документирование, отчетность).

3.1 Конфигурационная идентификация

3.1.1 Методы идентификации

В процессе управления конфигурацией рассматриваются учетные элементы конфигурации, представленные в виде:

• Файлов;
  
• Директорий;
  
• Наборов файлов и директорий.
  

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

Для идентификации учетных элементов в целом используются следующие типы метаданных:

• Тип учетного элемента;
  
• Наименование атрибута, установленного на учетный элемент;
  
• Значение атрибута, установленного на учетный элемент.
  

Для идентификации версии учетного элемента используются следующие типы метаданных:

• Номер версии и наименование ветви учетного элемента;.
  
• Метка, установленная на версию учетного элемента;
  
• Наименование атрибута, установленного на учетный элемент или его версию;
  
• Значение атрибута, установленного на учетный элемент или его версию.
  

3.1.1.2 Объекты идентификации

Рассматриваются следующие основные группы объектов конфигурационной идентификации:

• Операционная система;
  
• Программные средства;
  
• Артефакты проекта, подразделяемые на следующие группы:
  
  • Артефакты управления требованиями;
    
  • Артефакты проектирования;
    
  • Артефакты разработки;
    
  • Артефакты тестирования;
    
  • Документация.
    

3.1.1.3 Виды файлов

В каждом проекте должны быть определены виды файлов, подлежащих версионному контролю. Это позволяет определить тип элемента ClearCase для каждого вида файлов. От типа элемента зависит способ хранения файла в версионном хранилище и способ его обработки в процедурах конфигурационного управления. Например, можно ли использовать процедуру слияния для данного типа или нет.

Используются следующие правила наименования элементов и метаданных (исключая автоматически создаваемые метаданные):

• Версионное хранилище. Имя версионного хранилища может состоять из букв, цифр и символа подчеркивания «_».
  
• Ветвь. Имя ветви начинается с буквы и может содержать буквы, числа и символ “_”. В наименовании ветви отражается ее функциональность (например, bug_fix). Используются только строчные буквы, чтобы по регистру отличать названия меток от названий ветвей.
  
• Метка. Имя метки начинается с буквы и может содержать буквы, числа и символ “_”. Используются только заглавные буквы, чтобы по регистру отличать названия меток от названий ветвей.
  
• Атрибут. Имя атрибута начинается с буквы и может содержать буквы, числа и символ “_”. В наименовании атрибута отражается его функциональность.
  

3.1.2 Базовые версии проекта

***

Базовые версии создаются на основе версий учетных элементов, успешно прошедших сборку и тестирование, и подразделяются на:

• Локальные – базовые версии модулей подсистем или групп артефактов, которые создаются в различных рабочих группах, участвующих в проекте;
  
• Глобальные – базовые версии ПС в целом, создаваемые на основе артефактов, входящих в локальные базовые версии.
  

Для идентификации базовых версий, применяются метки. Метка устанавливается менеджером управления
конфигурацией на все версии учетных элементов, находящиеся в его интеграционном представлении, после успешного завершения сборки и интеграционного тестирования модуля или всей системы.

***

3.1.2.1 Принципы создания меток

***

1. Все метки создаются заглавными латинскими буквами.
   
2. Метка соответствует правилам именования билдов и релизов, а именно:
   

• номер релиза состоит из 3-х частей X.YY.ZZZ;
  
• X – номер версии;
  
• YY – номер подверсии. При изменении номера версии обнуляется;
  
• ZZZ – номер сборки. Сквозная нумерация от начала проекта.
  

На отлаженные версии в отладочном потоке ставится метка с префиксом BR.

***

3.1.2.2 Принципы создания ответвлений (бренчей)

***

Существует несколько типов бренчей:

3.2 Контроль конфигурации и изменений

3.2.1 Отработка и утверждение запросов на изменение

Процесс отработки и утверждения запросов на изменение ПС зависит от типов запросов на изменения, которые используются в проекте.

3.2.1.1 Типы запросов на изменение

В проекте используются следующие типы запросов на изменение:

• Запрос на развитие ПС. Этот тип запроса создается вручную и служит для регистрации запросов на внесение изменений, поступивших от пользователей или созданных участниками проекта;
  
• Дефект. Этот тип запроса может генерироваться автоматически и служит для идентификации ошибок, обнаруженных в процессе тестирования. Используется для интеграции со средствами тестирования (Test Manager);
  
• Задача. ***
  
• Поручение. ***
  
• Проект. ***
  

Запросы на развитие ПС и дефекты обрабатываются в БД управления изменениями с помощью двух разных типов записей, которые могут отличаться следующими компонентами:

• Полями в записи БД, содержащими информацию по запросу на изменение;
  
• Состояниями, которые могут использоваться в схеме отработки запроса;
  
• Действиями, которые переводят запись из одного состояния в другое;
  
• Формами пользовательского интерфейса, заполняемыми при переводе записи из одного состояния в другое;
  
• Скриптами, автоматически запускаемыми при наступлении определенных событий.
  

Запросы на изменения помещаются в записи БД ClearQuest «Enhancement Request» («Запрос на Развитие») или «Defect» («Дефект»).

Все запросы на изменения требований относятся к типу запроса на развитие ПС и регистрируются в качестве «Enhancement Request», затем анализируются, утверждаются и назначаются на исполнение.

Каждому назначенному на исполнение запросу «Enhancement Request», который разбивается на несколько заданий, ставится в соответствие один или более запросов типа «Defect», которые соответствую заданиям, выданным исполнителям для реализации первоначального запроса. Эти запросы связываются соотношением «parent-child», где «Enhancement Request» выступает как «parent», а «Defect» – как «child».

Такая связь позволяет определять готовность первоначального запроса на основании данных об исполнении заданий, связанных с ним. Первоначальный запрос закрывается только после того, как будут исполнены и закрыты все связанные с ним запросы типа «Defect».

3.2.1.1.1 Дефект

Атрибуты запроса типа «Дефект» представлены ниже

***

***

***

Диаграмма активности Дефекта

Диаграмма активности записи «Дефект»

Описание действий, представленных на схеме, дано ниже

Описание действий по обработке Дефектов

***

***

***

Диаграмма состояний Дефекта

Диаграмма состояний записи «Дефект»

***
***

***

(Пример 2)

***
***

***

Отличительные особенности реализации используемой в проекте схемы:

• Используются два типа записи:
  

1. Запрос на развитие
   
2. Дефект
   

• Для автоматизации процессов используется инструментальное средство ClearQuest
  
• Для работы с БД запросов на изменение и дефектов используется СУБД Oracle версии 8.* или выше.
  
• Используется единая последовательность отработки запросов на изменения и дефектов, включая перечень возможных состояний и действий, переводящих запись из одного состояния в другое.
  
• Типы записей “запрос на развитие” и “дефект” отличаются по:
  

1. Составу полей;
   
2. Используемым формам интерфейса пользователя;
   
3. Скриптам, автоматически запускаемым при наступлении определенных событий с записью.
   

• Заполнение полей производится двумя способами:
  

1. Автоматизированным. Данный способ возможен при интеграции ClearQuest со средствами тестирования Rational. При автоматизированном заполнении частично заполняются некоторые поля в соответствии с контекстом тестирования;
   
2. Ручным. Основной способ, при котором контроль над всеми полями лежит на человеке.
   

• В запросах допускается использование комбинирования способов заполнения
  

Ниже представлено общее для двух типов запросов описание процедуры обработки запроса на развитие ПС и дефекта на основе состояний и возможных действий, приводящих к изменению состояния.

Состав основных полей представлен отдельно для каждого типа записи.

Описание процедуры обработки запросов на развитие ПС и дефектов

Процедура управления дефектами описывается с использованием следующих представлений:

• порядок выполнения процедуры;
  
• описание состояний;
  
• описание действий;
  
• описание допустимых параметров.
  

Порядок выполнения процедуры

***
***

***

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

***
***

***

Диаграмма состояний процедуры управления дефектами

Все участники проекта могут подавать запросы на устранение дефекта или развитие ПС (далее “запросы”). Лицо, выполняющее действие по созданию нового Запроса («Представить»), автоматически получает роль Инициатора Запроса (Submitter).

Запрос в состоянии «Представлен» поступает на рассмотрение Руководителя проекта. Далее, руководитель проекта, который должен назначить ответственного разработчика для исполнения запроса, в соответствии с важностью запроса и его значимости для проекта, выполняет следующее:

• поручает выполнение Запроса конкретному разработчику – «Назначить»;
  
• завершает выполнение Запроса – «Закрыть».
  

***
***

***

Описание состояний

Настоящее представление уточняет порядок выполнения процедуры в части детализации описания состояний Запроса.

За состоянием закрепляется только одна роль, которая будет иметь полномочия на выполнение действий, связанных с изменением состояния Запроса (для всех действий, за исключением операции «Изменить»).

Описание состояний Запроса на устранение дефекта

***
***

***

3.2.2 Группа управления изменениями

Группа управления изменениями, утверждающая поступающие запросы на развитие ПС, выполняет несколько основных функций:

• Утверждение запросов на развитие ПС;
  
• Назначение рабочей группы для реализации утвержденного запроса (в случае, если существует несколько групп, которые могут исполнить запрос);
  
• Контроль реализации утвержденных запросов на изменение.
  

Основная цель деятельности группы управления изменениями – обеспечение целостности ПС на протяжении всего жизненного цикла. В ее состав входят представители всех рабочих групп.

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

Кроме утверждения/отклонения запросов во время сессии группа управления изменениями также определяет ответственных за анализ вновь поступивших запросов и рассматривает отчет о реализации утвержденных запросов.

3.3 Учет состояния конфигурации

3.3.1 Хранение материалов проекта и выпуск релизов

Материалы проекта находятся под версионным контролем. Структура версионных хранилищ определяется в зависимости от типа хранилища:

• Глобальные версионные хранилища, используемые несколькими географически удаленными рабочими группами и подлежащие репликации, имеют структуру, представленную в приложении к настоящему.
  
• Локальные версионные хранилища, используемые локально в пределах одной рабочей группы, имеют структуру, определяемую в плане конфигурационного управления соответствующей рабочей группы.
  

3.3.1.1 Резервирование данных

Ежедневно создается резервная копия версионных хранилищ и материалов проекта, находящихся в рабочих представлениях участников проекта.

Для резервирования используются материалы и данные о настройке проекта, представленные в приложении.

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

3.3.2 Отчеты и проверки

Отчеты и аудит проекта используются для получения данных о текущем состоянии проекта в ходе его выполнения.

Используются следующие типы отчетов:

• Отчеты по срокам, которые показывают данные о сроках пребывания заданий и запросов в том или ином состоянии.
  
• Отчеты по количеству, которые показывают данные о количестве заданий и запросов, имеющих определенные параметры
  
• Отчеты о тенденциях, которые показывают данные о соотношении заданий и запросов, отличающихся по какому-либо параметру и за определенный период. Например, открытых и закрытых.
  

   

  В проекте используются следующие отчеты
  

4. Этапы

5. Обучение и ресурсы

В проекте участвуют специалисты «***», выполняющие ролевые функции, определяемые для каждой группы проекта и представленные в приложении

6. Субподрядчики и контроль программного обеспечения со стороны поставщиков

Примечания:

В разделах не рассмотрены следующие разделы:

Структура каталогов изделия

Примеры структур планов

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

Финальный план УК государственной компании

Данный план был подготовлен для одной госкомпании. Структура была подведена под требования заказчика.

1.    Введение

1.1.    Цель документа

1.2.    Нормативная основа

1.3.    Сведения о документе

1.4.    Термины, сокращения и определения

2.    Идентификация объектов конфигурационного управления

2.1.    Разрабатываемые конфигурации продукта

2.2.    Описание платформ разработки

2.3.    Физическая архитектура системы

2.4.    Идентификация подсистем

2.5.    Описание инструментальных средств

2.6.    Описание объектов конфигурационного управления

2.7.    Структура базы данных конфигурационного управления

2.8.    Стандарт именования

3.    Порядок сборки и формирования версий

3.1.    Взаимозависимости подсистем

3.2.    Порядок разработки

3.3.    Порядок сборки

3.4.    Порядок формирования версий

4.    Распределение ролей в проекте

4.1.    Руководитель проекта

4.2.    Интегратор (ответственный за управление конфигурацией проекта)

4.3.    Руководители подпроектов

4.4.    Права доступа

Финальный план УК системного интегратора

Данный план был разработан для компании системного интегратора. Основная особенность плана – использование средства IBM Rational ClearCase сразу в двух вариантах – базовом и UCM. Обычно выбирается только одна модель работ в проекте, но в данном случае пришлось выбирать сразу обе.

1. Введение
   1. Цель
   2. Область действия
   3. Определения, акронимы и аббревиатуры
   4. Ссылки
   5. Обзор
2. Организация и рабочая среда процессов конфигурационного управления
   1. Организация процессов конфигурационного управления
   2. Ролевые функции в процессе конфигурационного управления
   3. Инструментарий и рабочая среда
   4. Рабочая среда
   5. УК в режиме базового (base) ClearCase
3. Архитектура проекта конфигурационного управления
   1. Регионы
   2. Версионные хранилища
   3. Разделение доступа к объектам
4. Настройка рабочего пространства
5. Программа конфигурационного управления
6. Конфигурационная идентификация
7. Выпуск релизов
8. Контроль изменений и конфигурации
9. Процессы конфигурационного управления в жизненном цикле проекта
10. Интеграция средств УК с другими средствами:
    1. Интеграция ClearCase и ClearQuest
    2. Интеграция ClearCase и RequisitePro
    3. Интеграция ClearQuest и Bound Checker
11. УК в режиме UCM
12. Архитектура проекта конфигурационного управления
    1. Регионы
    2. Версионные хранилища
    3. Разделение доступа к ОКУ
13. Проекты UCM
    1. Потоки
    2. Настройка рабочего пространства
14. Программа конфигурационного управления
    1. Конфигурационная идентификация
       1. Выпуск релизов
       2. Контроль изменений и конфигурации
    2. Интеграция ClearCase с другими инструментами Rational
    3. Интеграция ClearCase и ClearQuest
    4. Интеграция ClearCase и RequisitePro
15. Управление изменениями
16. Репозиторий ClearQuest
17. Типы запросов на изменение
18. Enhancement Request
19. Defect
20. Схема обработки запросов на разных стадиях проекта
21. Типы записей, используемые в режиме Base ClearCase
22. Типы записей, используемые в режиме UCM
23. Стадия ТЗ – Inception
24. Стадия «Технический проект» (ТП – Elaboration)
25. Стадия «Рабочий проект» (РП – Construction)
26. Стадия «Ввод в действие» (ВД– Transition)
27. Учет состояния конфигурации
28. Хранение материалов проекта
29. Отчеты и аудит
30. Этапы
31. Обучение участников проекта
32. Создание рабочей среды конфигурационного управления проектом
33. Отработка процессов конфигурационного управления
34. Доработка технологии конфигурационного управления
35. Контроль программного обеспечения от поставщиков

Начальная версия плана УК билинговой компании

Любой план пишется не сразу. Давайте выделим основные разделы в плане, как это было сделано в одном из проектов. Возможно, что в Вашем случае. Подобный план может явиться хорошим началом для более детального и фундаментального документа.

1.Введение

2.Описание основных процессов системы конфигурационного управления

2.1     Информационные хранилища

2.2    Структура проекта

2.3    Идентификация

2.4     Основные процессы

2.5    Ролевые функции и обязанности участников процесса УК

3. Накопление, обобщение и анализ информации

Структура плана для разработки системы в реальном масштабе времени

Данный пример показывает гипотетический план из стандарта IEEE Std 828-1990. Особенности плана:

1. Обеспечить разработку систему управления в реальном времени среднего размера для управления транспортными средствами. Датчики используются для ввода информации в систему, а показы используются, чтобы поддержать человеко-машинный интерфейс.
2. Длительность проект примерно 3-3,5 года
3. Большинство работ выполняется в главном офисе подрядчика с некоторой работой, выполняемой в соседнем филиале
4. У компании есть большой опыт в плане УК.

1. Введение
   1. Цели
   2. Scope
   3. Акронимы и определения
   4. Ссылки
2. Управление
   1. Организация
   2. Обязательства по выполнению SCM
      1. Конфигурационная идентификация
      2. Конфигурационный контроль
      3. Отслеживание статуса
      4. Проверки и аудит
      5. Configuration Control Board
   3. Выполнение Плана УК
      1. CCB
      2. Базовые версии
      3. Списки и процедуры отчетов и аудитов
      4. Управление Конфигурациями средств разработки
      5. Применяемая политика, директивы и процедуры
3. Действия УК
   1. Конфигурационная идентификация
      1. Документирование
      2. Части ПО
      3. Конфигурационная идентификация функциональных базовых версий
      4. Конфигурационная идентификация базовых версий в разработке
      5. Конфигурационная идентификация продуктовых базовых версий (законченных)
   2. Контроль конфигурации
      1. Функции CCB
      2. Запросы на изменение
      3. Авторизация изменений
      4. Автоматизация запросов на изменение
   3. Учет статуса
   4. Аудит
      1. Функциональный аудит
      2. Физический аудит
      3. Просмотр
   5. Инструментальные средства процесса УК
   6. Управление субподрядчиком
      1. Программное обеспечение Заказчика
      2. Программное обеспечение Субподрядчика
      3. Совместное ПО

ПРИЛОЖЕНИЯ

Приложение А «Управление запросами на изменения»

Приложение Б «Создание начальной базовой версии»

Приложение В «Процедура изменений»

27.01.2008

Комментарии

• 
  Автор:   ·  11.08.2011 03:54:09
  That is well known that money can make people autonomous. But what to do if somebody does not have cash? The one way only is to try to get the business loans and credit loan.

Добавить комментарий (анонимные комментарии не публикуются!!!)

ФИО:
E-mail:
Тема:
Комментарий:
Оценка:
Код подтверждения:

Читайте также статьи и материалы о технологиях Rational и Microsoft в блоге Новичкова Александра и Шамрая Александра

Новости и пресс-релизы СМ-Консалт

Архив "Новости и пресс-релизы СМ-Консалт"