LXF70:Subversion1 - История изменений

Yaleks: шаблон

2009-02-04T18:59:33Z

шаблон

Lockal: восстановление кавычек в коде AWB

2008-04-27T13:07:18Z

восстановление кавычек в коде AWB

Broom: /* Часть 3. Обеспечение удалённого доступа */ - добавлена картинка

2008-03-26T20:33:35Z

‎Часть 3. Обеспечение удалённого доступа: - добавлена картинка

Broom: /* Часть 2. Миграция с CVS */ - добавлена картинка

2008-03-26T20:22:51Z

‎Часть 2. Миграция с CVS: - добавлена картинка

Broom: /* Новое решение */

2008-03-26T20:18:00Z

‎Новое решение

Broom: /* Новое решение */

2008-03-26T20:09:17Z

‎Новое решение

Broom в 07:12, 10 марта 2008

2008-03-10T07:12:04Z

WikiSysop в 07:38, 8 марта 2008

2008-03-08T07:38:36Z

Broom: Часть 4 - Поддержка

2008-03-07T21:20:49Z

Часть 4 - Поддержка

Broom в 20:40, 7 марта 2008

2008-03-07T20:40:04Z

← Предыдущая		Версия 18:59, 4 февраля 2009
Строка 1:		Строка 1:
		+	{{Цикл/Subversion}}
		+
	== Subversion. Установка репозитария ==		== Subversion. Установка репозитария ==
	''Часть 1: Subversion (англ. «ниспровержение», «подрыв») – это отличное решение open-source для управления		''Часть 1: Subversion (англ. «ниспровержение», «подрыв») – это отличное решение open-source для управления

@@ Строка 44: / Строка 44: @@
 <code>
-  $ svn import -m “Initial project import”
+  $ svn import -m "Initial project import"
   Adding helloworld/helloworld.cpp
   Adding helloworld/Makefile
@@ Строка 120: / Строка 120: @@
 <code>
-  $ svn commit –m “Copied and removed cpp files”
+  $ svn commit –m "Copied and removed cpp files"
   Deleting helloworld.cpp
   Adding welcome.cpp
@@ Строка 158: / Строка 158: @@
   SVNPath /usr/share/subres
   SVNAutoversioning on
-  AuthName “LXF Subversion Repository”
+  AuthName "LXF Subversion Repository"
   AuthTypeBasic
   </Location>
@@ Строка 260: / Строка 260: @@
 Также в сети имеется книга
-издательства O’Reilly, озаглавленная «'''Version Control with Subversion'''» (Контроль версий с помощью ''Subversion''), которую
+издательства O'Reilly, озаглавленная «'''Version Control with Subversion'''» (Контроль версий с помощью ''Subversion''), которую
 можно скачать в формате PDF или HTML с сайта http://svnbook.redbean.com.

@@ Строка 139: / Строка 139: @@
 === Часть 3. Обеспечение удалённого доступа ===
 Очевидно, что пользователи, имеющие доступ к репозитарию ''Subversion'', могут находиться в разных частях света, и поэтому требует-
 ся возможность работы в сети. Это особенно верно для открытых проектов. ''Subversion'' использует ''Apache'' и особый протокол WebDAV, чтобы обеспечить доступ к репозитарию для сетевых клиентов. Установка и настройка достаточно проста, с единственным требованием, что нужен работающий ''Apache'' версии 2.0 или выше.

← Предыдущая		Версия 20:22, 26 марта 2008
Строка 86:		Строка 86:

	=== Часть 2. Миграция с CVS ===		=== Часть 2. Миграция с CVS ===
		+
		+	[[Изображение:LXF70-subversion2.png\|thumb\|Вместо того, чтобы импортировать всю историю проекта в Subversion, иногда проще выбрать несколько важных релизов, и импортировать только их.]]
		+
	Единственной проблемой при таком импортировании проекта является то, что вы потеряете всю историю изменений, накопленную в вашей текущей системе контроля версий. К счастью, есть способ перенести вашу историю изменений в новый репозитарий ''Subversion''.		Единственной проблемой при таком импортировании проекта является то, что вы потеряете всю историю изменений, накопленную в вашей текущей системе контроля версий. К счастью, есть способ перенести вашу историю изменений в новый репозитарий ''Subversion''.

@@ Строка 19: / Строка 19: @@
 === Новое решение ===
 Система ''Subversion'' была разработана как непосредственная открытая замена для ''CVS'', выстроенная «с нуля», чтобы решить многие проблемы своей предшественницы. Версия 1.01 была выпущена в марте 2004-го года, а как раз сейчас начинается тестирование версии 1.2.0 Во главе списка ее отличительных особенностей – контроль версий каталогов, который не может обеспечить ''CVS''. Это ключевой момент, поскольку ''Subversion'' позволяет вам манипулировать каталогами таким же образом, как и файлами – переносить, переименовывать, копировать и удалять. Основанная на файлах структура ''CVS'' – причина ее еще одной большой проблемы. При фиксации изменений существует вероятность потерять соединение на полпути. В случае с ''CVS'', результатом этого станет ситуация, когда половина файлов от разработчика будет обновлена, в то время как другая половина – нет, что не оставит администратору никакой возможности разобраться, какие файлы изменялись, а какие остались старыми. Решение, которое предлагает Subversion, заключается в том, что все изменения в репозитарии выполняются «атомарно». Это означает, что все изменения вносятся как единая транзакция, исключающая «полуобновление» файлов и двойную фиксацию. Это, наряду с другими существенными добавлениями («дешевые» ветвления и тэггинг, отличная поддержка двоичных форматов), сделает обновление до ''Subversion'' почти обязательным для пользователей ''CVS'' уже в ближайшем будущем.
 ''Subversion'' доступна для загрузки с сайта http://Subversion.tigris.org под лицензией CollabNet/Tigris.org, которая аналогична лицензии ''Apache''; ее разработчики рекомендуют версию 1.1.4. Как только вы установите эту программу, вам захочется задействовать ее для использования в своем собственном проекте.
 === Часть 1. Установка репозитария ===

← Предыдущая		Версия 20:09, 26 марта 2008
Строка 22:		Строка 22:

	''Subversion'' доступна для загрузки с сайта http://Subversion.tigris.org под лицензией CollabNet/Tigris.org, которая аналогична лицензии ''Apache''; ее разработчики рекомендуют версию 1.1.4. Как только вы установите эту программу, вам захочется задействовать ее для использования в своем собственном проекте.		''Subversion'' доступна для загрузки с сайта http://Subversion.tigris.org под лицензией CollabNet/Tigris.org, которая аналогична лицензии ''Apache''; ее разработчики рекомендуют версию 1.1.4. Как только вы установите эту программу, вам захочется задействовать ее для использования в своем собственном проекте.
		+
		+	[[Изображение:LXF70-subversion1.png\|thumb\|CVS и Subversion имеют один и тот же цикл разработки. [1] Первоначальная версия в репозитарии. [2] Файл извлечен двумя разработчиками. [3] Каждый разработчик редактирует свою часть файла. [4] Файл фиксируется в репозитарии, объединяя оба изменения.]]

	=== Часть 1. Установка репозитария ===		=== Часть 1. Установка репозитария ===

@@ Строка 1: / Строка 1: @@
 == Subversion. Установка репозитария ==
-''ЧАСТЬ 1:  Subversion (англ. «ниспровержение», «подрыв») – это отличное решение open-source для управления
+''Часть 1:  Subversion (англ. «ниспровержение», «подрыв») – это отличное решение open-source для управления
 процессом разработки вашего проекта. Соответственно, в LXF всегда под рукой собственный «подрывник», '''Грэм Моррисон''', который расскажет вам об этом.''
@@ Строка 23: / Строка 23: @@
 ''Subversion'' доступна для загрузки с сайта http://Subversion.tigris.org под лицензией CollabNet/Tigris.org, которая аналогична лицензии ''Apache''; ее разработчики рекомендуют версию 1.1.4. Как только вы установите эту программу, вам захочется задействовать ее для использования в своем собственном проекте.
-=== Часть 1 – установка репозитария ===
+=== Часть 1. Установка репозитария ===
 '''Первый шаг при администрировании репозитария Subversion''' – создание структуры и заполнение ее файлами. ''Subversion'' использует базу данных ''Berkeley'', которая ограничивает инсталляцию локальной файловой системой потому, что ''Berkeley'' полагается на файловую систему, которая поддерживает относительно «продвинутые» особенности, не доступные в настоящий момент в сетевых аналогах (таких как ''Samba'' или ''NFS''). Как только будет выбрано место для размещения репозитария, вы можете создать его, используя команду ''svnadmin'', предназначенную для внесения значительных изменений в репозитарий.
@@ Строка 82: / Строка 82: @@
 '''Post-revprop-change'''. В зависимости от наличия сценария pre-revprop-change, этот скрипт выполняется после того, как свойства ревизии будут изменены. И снова напомню, что пакет ''Subversion'' включает пример, показывающий, как сообщить команде разработчиков о произошедших изменениях свойств.
-=== Часть 2 - Миграция с CVS ===
+=== Часть 2. Миграция с CVS ===
 Единственной проблемой при таком импортировании проекта является то, что вы потеряете всю историю изменений, накопленную в вашей текущей системе контроля версий. К счастью, есть способ перенести вашу историю изменений в новый репозитарий ''Subversion''.
@@ Строка 132: / Строка 132: @@
 могут быть. Если такое использование кажется слишком ограниченным, вы можете установить только ветви и тэги, которые наиболее важны для вашего проекта (например, вы могли бы без последствий проигнорировать ночные сборки). Это выполняется с помощью флага '''--exclude''', определяющем, какие ветви и тэги следует игнорировать. Наконец, вы можете просто импортировать залпом все сразу, и использовать скрипт ''cvs2svn'' для конвертирования репозитария в ''Subversion'' полностью.
-=== Часть 3 - Обеспечение удалённого доступа ===
+=== Часть 3. Обеспечение удалённого доступа ===
 Очевидно, что пользователи, имеющие доступ к репозитарию ''Subversion'', могут находиться в разных частях света, и поэтому требует-
 ся возможность работы в сети. Это особенно верно для открытых проектов. ''Subversion'' использует ''Apache'' и особый протокол WebDAV, чтобы обеспечить доступ к репозитарию для сетевых клиентов. Установка и настройка достаточно проста, с единственным требованием, что нужен работающий ''Apache'' версии 2.0 или выше.
@@ Строка 208: / Строка 208: @@
 |}
-=== Часть 4 - Поддержка ===
+=== Часть 4. Поддержка ===
 Раз репозитарий запущен, вам понадобится несколько команд для поддержания его в рабочем состоянии. Наиболее важная из них – '''svnadmin''', команда, в общих чертах аналогичная '''cvs admin''', которая предоставляет несколько жизненно важных подкоманд. Мы уже встречались с '''svnadmin create''', которая отвечала за генерацию репозитария. Вы можете воспользоваться командой '''svnadmin dump''' как частью процесса резервного копирования, но она полезнее для переноса содержимого между репозитариями. Команда копирует содержимое репозитария в стандартный поток вывода, используя переносимый формат dump-файла. Команда '''dump''' также позволяет вам определять диапазон ревизий репозитария, которые должны быть включены в вывод, вместо того чтобы выводить все сразу, как это происходит по умолчанию.

← Предыдущая		Версия 21:20, 7 марта 2008
Строка 207:		Строка 207:
	\|Копирует объект, включая историю его ревизий		\|Копирует объект, включая историю его ревизий
	\|}		\|}
		+
		+	=== Часть 4 - Поддержка ===
		+	Раз репозитарий запущен, вам понадобится несколько команд для поддержания его в рабочем состоянии. Наиболее важная из них – '''svnadmin''', команда, в общих чертах аналогичная '''cvs admin''', которая предоставляет несколько жизненно важных подкоманд. Мы уже встречались с '''svnadmin create''', которая отвечала за генерацию репозитария. Вы можете воспользоваться командой '''svnadmin dump''' как частью процесса резервного копирования, но она полезнее для переноса содержимого между репозитариями. Команда копирует содержимое репозитария в стандартный поток вывода, используя переносимый формат dump-файла. Команда '''dump''' также позволяет вам определять диапазон ревизий репозитария, которые должны быть включены в вывод, вместо того чтобы выводить все сразу, как это происходит по умолчанию.
		+
		+	<code>
		+	$ svnadmin dump /usr/share/subres > dump.txt
		+	</code>
		+
		+	Партнер команды ''dump'' – '''svnadmin load''', которая может импортировать вывод в формате dump. Однако, чтобы создать резервную
		+	копию репозитария, вам нужна другая команда – '''hotcopy'''. Благодаря базе данных ''Berkley'', становится возможным копировать содержимое репозитария без его остановки. Стандартная инсталляция ''Subversion'' также предоставляет сценарий на Python в каталоге tools/backup, который вы можете использовать для автоматического исполнения (например, как задание ''cron''), вместо ручного запуска '''svnadmin hotcopy'''.
		+
		+	Лучший способ проверить статус работающего репозитария – использование команды '''svnlook'''. ''Svnlook'' проверяет самую свежую версию, и по умолчанию имеет доступ только для чтения, так что можно не беспокоиться, что будут сделаны какие-то катастрофические
		+	изменения. Каждая команда с ''svnlook'' может быть применена как ко всему репозитарию, так и к определенной ревизии.
		+
		+	<code>
		+	$ svnlook info /usr/share/subres --revision 1
		+	graham
		+	2005-04-15 16:33:44 _0100 (Fri, 15 Apr 2005)
		+	22
		+	Initial project import
		+	</code>
		+
		+	''Svnlook info'' – мощная команда, позволяющая получить общий обзор репозитария. Приведенный пример показывает автора, дату, комментарий и размер первой ревизии, сделанной в репозитарии. Каждое поле может быть получено независимо, если заменить '''info''' на '''author''', '''date''' или '''log''', так что команда может быть использована при разработке скриптов для использования в качестве «ловушек», упомянутых ранее.
		+
		+	На данный момент вы должны понимать основы работы сервера ''Subversion''. Следующим этапом должен быть либо старт проекта в
		+	''Subversion'', либо спасение ''CVS''-проекта, увядающего на вашем диске. Поскольку ваш репозитарий поднят и настроен, следующий шаг для вас и ваших коллег по разработке – использовать его, но об этом мы поговорим в следующий раз!
		+
		+	==== Подсказка (врезка) ====
		+	'''Документация по Subversion'''
		+
		+	Лучший способ понять ''Subversion'' – это воспользоваться ее замечательной встроенной документацией. Чтобы добраться до нее, выполните '''svn help''' в командной строке. В результате вы получите список внутренних команд ''Subversion'', по которым вы можете
		+	получить дополнительную информацию, указав имя в конце команды help, например, так:
		+
		+	<code>
		+	$ svn help co
		+	</code>
		+
		+	Также в сети имеется книга
		+	издательства O’Reilly, озаглавленная «'''Version Control with Subversion'''» (Контроль версий с помощью ''Subversion''), которую
		+	можно скачать в формате PDF или HTML с сайта http://svnbook.redbean.com.

← Предыдущая		Версия 20:40, 7 марта 2008
Строка 131:		Строка 131:
	Наиболее часто используемая опция включает только главную ветвь (так называемый trunk) репозитария ''CVS'', ('''cvs2svn --trunk-only'''), игнорируя все исторические данные в любых ветвях и тэгах, какие у вас		Наиболее часто используемая опция включает только главную ветвь (так называемый trunk) репозитария ''CVS'', ('''cvs2svn --trunk-only'''), игнорируя все исторические данные в любых ветвях и тэгах, какие у вас
	могут быть. Если такое использование кажется слишком ограниченным, вы можете установить только ветви и тэги, которые наиболее важны для вашего проекта (например, вы могли бы без последствий проигнорировать ночные сборки). Это выполняется с помощью флага '''--exclude''', определяющем, какие ветви и тэги следует игнорировать. Наконец, вы можете просто импортировать залпом все сразу, и использовать скрипт ''cvs2svn'' для конвертирования репозитария в ''Subversion'' полностью.		могут быть. Если такое использование кажется слишком ограниченным, вы можете установить только ветви и тэги, которые наиболее важны для вашего проекта (например, вы могли бы без последствий проигнорировать ночные сборки). Это выполняется с помощью флага '''--exclude''', определяющем, какие ветви и тэги следует игнорировать. Наконец, вы можете просто импортировать залпом все сразу, и использовать скрипт ''cvs2svn'' для конвертирования репозитария в ''Subversion'' полностью.
		+
		+	=== Часть 3 - Обеспечение удалённого доступа ===
		+	Очевидно, что пользователи, имеющие доступ к репозитарию ''Subversion'', могут находиться в разных частях света, и поэтому требует-
		+	ся возможность работы в сети. Это особенно верно для открытых проектов. ''Subversion'' использует ''Apache'' и особый протокол WebDAV, чтобы обеспечить доступ к репозитарию для сетевых клиентов. Установка и настройка достаточно проста, с единственным требованием, что нужен работающий ''Apache'' версии 2.0 или выше.
		+
		+	В этом случае установка будет состоять в простом добавлении нескольких строк в исходный файл конфигурации Apache. Нужны два модуля – mod_dav и mod_dav_svn, которые менеджер пакетов должен был добавить автоматически. Тем не менее, вам следует убедиться, что эти модули подгружаются. В файл '''httpd.conf''' нужно включить особую информацию о настройках ''Subversion'':
		+
		+	<code>
		+	<Location /svn>
		+	DAV svn
		+	SVNPath /usr/share/subres
		+	SVNAutoversioning on
		+	AuthName “LXF Subversion Repository”
		+	AuthTypeBasic
		+	</Location>
		+	</code>
		+
		+	Опция '''DAV''' просто информирует ''Apache'', какой модуль используется ('''svn'''), а '''SVN Path''' указывает на репозитарий. Поскольку ''Subversion'' использует web-сервер, поддерживающий WebDAV, то существует возможность использовать другие совместимые с DAV
		+	клиенты для доступа к репозитарию ''Subversion''. Теоретически, такие клиенты могут рассматривать репозитарий как разновидность
		+	файловых систем, так же как мы получаем доступ к объектам ''Samba'' или ''NFS'' с помощью своего файлового менеджера.
		+
		+	Пока что осуществление этого требует значительных усилий, если нужно добиться истинной совместимости. Функция ''SVN autoversioning''
		+	– это компромисс, разрешающий делать обновления с основных клиентов, без записей в журналах или комментариев, добавляемых ''Subversion'' автоматически в общем виде. Это далеко от идеала, но предоставляет дополнительную возможность выбора.
		+
		+	Последняя строка в нашем примере задает тип аутентификации, в настоящее время используется базовая аутентификация протокола HTTP. Доступ на запись может контролироваться путем ограничения HTTP командами, на которые ''Subversion'' может положиться как на
		+	обеспечивающие только возможность чтения:
		+
		+	<code>
		+	<LimitExcept GET PROPFIND OPTIONS REPORT>
		+	</code>
		+
		+	Используя этот пример, вы разрешите пользователям доступ на запись только через выделение отдельных учетных записей и соответствующий файл ''.htpasswd'', как это было бы при нормальной конфигурации ''Apache''. Безопасные соединения также возможны при помощи доступа к репозитарию через HTTPS вместо HTTP, и в этом случае приходится полагаться на предварительно настроенный модуль mod_ssl. После того как ''Apache'' будет настроен, вы должны получить возможность управлять репозитарием удаленно, используя URL своего сервера, вместо прежнего указателя на файлы:
		+
		+	<code>
		+	$ svn co http://localhost/subres
		+	</code>
		+
		+	==== Subversion против CVS (врезка)====
		+	Не секрет, что ''Subversion'' была разработана, чтобы заменить ''CVS'', и поэтому работа с обоими приложениями очень похожа. С точки зрения клиента многие команды идентичны, и вы можете зачастую просто заменить cvs на svn в командной строке. Обработка происходит в фоновом режиме, и серверные и сетевые протоколы, которые имеют различия, остаются, по большей части, скрыты от конечного пользователя. Здесь приводится список некоторых команд, которые слегка отличаются:
		+	{\|
		+	\|CVS
		+	\|Subversion
		+	\|Функция
		+	\|-
		+	\|cvsadmin
		+	\|svnadmin
		+	\|Оболочка к административным функциям
		+	\|-
		+	\|cvsannotate
		+	\|svn blame
		+	\|Выводит информацию о ревизиях для файлов
		+	\|-
		+	\|cvsco –j
		+	\|svn merge
		+	\|Объединяет два источника в рабочую копию
		+	\|-
		+	\|cvshistory
		+	\|svn log
		+	\|Выводит журнальные сообщения
		+	\|-
		+	\|cvsinit
		+	\|svnadmin create
		+	\|Создает новый репозитарий
		+	\|-
		+	\|cvsrdiff
		+	\|svn diff
		+	\|Составляет список отличий для патча
		+	\|-
		+	\|cvsremove
		+	\|svn delete
		+	\|Удаляет объект из репозитария
		+	\|-
		+	\|cvsrtag
		+	\|svn copy
		+	\|Копирует объект, включая историю его ревизий
		+	\|}