Добро пожаловать на авторский блог Авдеева Марка.

Только для читателей Lifeexample возможно открыть интернет-магазин на Moguta.CMS со скидкой в 15%

<<< Проверка формы jQuery || PHP навигация >>>

Настройка SVN

22.05.2012
Настройка SVN

Здравствуй, уважаемый читатель блога LifeExample. При разработке любого более-менее крупного проекта невозможно обойтись без системы контроля версиями (SVN). Настройка SVN может загнать в тупик многих начинающих web разработчиков. Я до недавнего времени также пребывал в замешательстве и больших вопросах относительно установки и настройки SVN.

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

Что такое система контроля версий

Система контроля версий (по англ. Version Control System, сокращенно VCS) состоит из двух частей:

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

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

Многие начинающие программисты одиночки при написании кода, создают (backup) копии папок, с программой помечая их текущей датой, или порядковым номером.

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

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

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

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

Требования к Соискателю
Умение работать с SVN (либо аналогичной системой контроля версий)

Именно система контроля версий Subversion (SVN) применяется в большинстве организаций, поэтому я и расскажу сегодня о работе и настройке с SVN.

Настройка сервера (шаг 1)

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

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

Чтобы самостоятельно настроить SVN server, можно скачать, одну из предлагаемых на официальном сайте, программ с SVN сервером в комплекте, или же ограничиться чистым SVN сервером и скачать Subversion 1.7.

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

TortoiseSVN — это бесплатный клиент для системы контроля версий Subversion, выполненный как расширение оболочки Windows. Вся прелесть программы заключается в том, что она не только является клиентом, но и может автоматически в несколько кликов мыши создать локальный SVN сервер, пригодный для работы.

Таким образом, чтобы настроить SVN сервер, первым делом нам нужно скачать и установить программу TortoiseSVN.

TortoiseSVN_1.7.7 x32bit + RUS ( Скачали: 326 чел. ) 


TortoiseSVN_1.7.7 x64bit + RUS ( Скачали: 340 чел. ) 

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

Контекстное меню настроек SVN

Организуем хранилище наших проектов, для этого на диске С:\ создадим новый каталог с именем SVNrepository, откроем его, и щелкнув правой кнопки мыши, в контекстном меню выбирем TortoiseSVN->"Создать здесь хранилище".

Структура настроенного SVN сервера

Каталог SVNrepository должен заполниться файлами вышеприведенной структуры, после чего можно считать, что мы завершили настройку SVN сервера и готовы к работе.

Установка клиента (Шаг 2)

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

При установке инсталер TortoiseSVN создал соответствующие службы, которые теперь будут запускаться автоматически с запуском windows. Благодаря этим службам в контекстном меню проводника стали доступны новые пункты меню.

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

Настройка структуры хранилища (Шаг 3)

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

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

/trunk
/branches
/tags

В каталоге trunk расположим основной проект, над которым будем вести работу.

Каталог branches будет содержать последующие копии ответвлений проекта, или проще говоря – версий проэкта.

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

Разработчики в руководстве упоминают о том, что любая организация – каталога, имеет право на существование, и определяется только требованиями конкретного проекта. Именно поэтому, я создам в репозитории (хранилище), всего два каталога.

/trunk
/branches

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

Т.е. формально я представляю себе репозиторий такого вида:

/trunk
	/release v2
/branches
	/release v1
	/release v2
	/release v3

Из этой структуры следует, что на момент разработки версии v3 в текущий момент успешно выпущена и поддерживается версия v2.

Чтобы создать каталоги в хранилище, нужно открыть контекстное меню папки SVNrepository и выбрать пункт TortoiseSVN->"Обозреватель хранилища". Откроется окно для работы с хранилищем.

Настройка структуры хранилища

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

Попутно добавим в /branches каталог /release v1, в котором будут храниться версии первой разрабатываемой версии проекта.

Комментарии к созданой версии

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

Основа для работы готова, закончена настройка SVN сервера под конкретный пример, теперь давайте начнем разрабатывать наш тестовый проект.

Создание рабочей копии (Шаг 4)

В папку branches/release v1 добавим файл ReadMe.txt нашего, пока не существующего, проекта. Соответственно, нужно изначально подготовить данный файл, и осилить написать туда пару строчек текста, зачем, расскажу позже.

Создание рабочей копии настроенной SVN

Перенеся файл в репозитории, мы наконец-то можем возрадоваться началу процесса разработки проекта и контроля его версий. Теперь откройте любой каталог у себя на компьютере, в котором планируете создавать проект. Пусть это будет: C:/Project1.

В контекстном меню выберите пункт "SVN извлечь", укажите в качестве URL хранилища, путь до папки с версией v1:

file:///C:/SVNrepository/brunches/release v1

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

Подтверждение выгрузки копии

Обратите внимание, на папке проекта C:/Project1 появилась пиктограмма в виде зеленой галочки. Это означает, что все прошло успешно и рабочая копия полностью синхронизирована с хранилищем.

Готовая настроенная SVN рабочая копия

Изменение файлов проекта (Шаг 5)

Следующим шагом немного изменим, содержимое файла C:\Project1\ReadMe.txt, можете внести любые изменения, на свое усмотрение.

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

Измененная настроенная SVN рабочая копия

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

Применение изменений файлов (Шаг 6)

В контекстном меню папки Project1 выберем пункт "SVN фиксировать", система предложит указать комментарии, перед тем как файлы будут загружены на сервер. Не ленитесь их заполнять, поскольку в последствии, они сыграют вам на руку при необходимости отката версий.

Фиксация изменений в хранилище

Кроме того в открывшемся окне, мы можем произвести сравнение файла с предыдущими его версиями. Если вы следовали моим советам, и изменяли строки ReadMe.txt, то сможете оценить прелесть работы встроенной в TortoiseSVN программы для стравнения текстовых файлов. Для этого выберите в контекстном меню, пункт "Cравнить с базой".

Сравнение версий

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

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

Откат к предыдущей версии (Шаг 7)

Если спустя некоторое время, стало ясно, что все идет не так, и мы хотим вернуть файлу прежний вид, сделать это можно удобным способом. В контекстном меню файла C:\Project1\ReadMe.txt выберем пункт "Обновить до ревизии"

Откат к предыдущей версии

Заметьте что по умолчанию, система SVN предлагает обновиться до HEAD ревизии, т.е. до последней, но мы можем указать номер ревизии, к которой нужно откатить файл. Если номер не известен, можно использовать Журнал ревизий, и отметить именно ту версию, которая нас больше всего устраивает. Подтвердив выбор кнопкой "ОК&quot, файл будет заменен более ранней версией.

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

Чтобы не пропустить публикацию следующей статьи подписывайтесь на рассылку по E-mail или RSS ленту блога.

Нравится

Комментарии

  • Дiмка

    Спасибо, интересная и полезная статья!!! Раньше и не догадывался о существовании такого сервиса.

    • Пожалуйста, подписывайтесь на RSS или е-маил рассылку. Обещаю, следующие статьи будут не менее полезными и интересными 😉

  • Samigo

    Сорри за оффтоп, но Ваш блог(сайт) у меня часто зависает. 🙁
    А по теме, я постоянно делаю бакап копию в виде архива командой типа «rar a -r -u » для локальной копии любого документа.
    Для веб. проектов наверно такое тоже надо. я тоже не знал что это такое и теперь попробую…
    Спасибо за инфо!

  • dmgriny

    Марк!

    Осталось неясным. В описании шагов фигурирует только папка brunches хранилища. а как же другие созданные тобой папки:
    /trunk
    /release v2
    /branches
    /release v1
    /release v2
    /release v3

    Как взаимодействовать с ними?

    • Ну как я понял, транк — это текущая рабочая копия системы.

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

  • dmitry

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

  • Алексей

    Спасибо. Статья отличная. Все понятно описано. Буду пользоваться!

  • andrei

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

  • andrei

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

  • Оставить комментарий

    Подписаться на комментарии к этой статье по RSS

    Размещение статей и контекстных ссылок
    Бесплатная CMS для вашего магазина
    Яндекс.Метрика