Практическое руководство Использование SVN

Шамрай А.В.

[Выберите дату]

1

Оглавление 1 Установка сервера Visual SVN ....................................................................................................................... 3

2 Установка клиента TortoiseSVN..................................................................................................................... 4

3 Создание пользователей и групп ................................................................................................................. 4

4 Создание хранилища ..................................................................................................................................... 6

5 Подключение к серверу ................................................................................................................................ 7

6 Загрузка файлов на локальный компьютер ................................................................................................ 8

7 Импорт данных в хранилище ..................................................................................................................... 11

8 Разрешение конфликтов при редактировании текстовых файлов ......................................................... 12

9 Разрешение конфликтов при редактировании файлов MS Word ........................................................... 17

10 Блокирование файлов на изменение .................................................................................................... 18

11 Проверка состояния хранилища............................................................................................................. 19

12 Группы изменений ................................................................................................................................... 22

13 Журнал ревизий ....................................................................................................................................... 23

14 Копирование/перемещение/переименование файлов и папок ........................................................ 24

15 Игнорирование файлов и папок ............................................................................................................. 24

16 Отмена изменений .................................................................................................................................. 26

17 Ветви и метки ........................................................................................................................................... 26

17.1 Создание проекта с необходимой структурой .................................................................................. 26

17.2 Создание ветви или метки .................................................................................................................. 27

18 Обработка конфликтов при слиянии ..................................................................................................... 31

19 Авторство .................................................................................................................................................. 31

20 Дерево версий.......................................................................................................................................... 32

21 Использование с Eclipse .......................................................................................................................... 34

21.1 Подключение к SVN ............................................................................................................................. 34

21.2 Добавление существующих файлов под версионный контроль ..................................................... 36

21.3 Изменение файлов .............................................................................................................................. 38

21.4 Добавление новых файлов ................................................................................................................. 38

21.5 Обновление пространства .................................................................................................................. 39

22 Интеграция с RTC...................................................................................................................................... 40

22.1 Использование TortoiseSVN ................................................................................................................ 40

22.1.1 Настройка соединения ................................................................................................................ 40

22.1.2 Связывание заданий при внесении изменений ....................................................................... 42

22.1.3 Добавление ссылки на изменения ............................................................................................. 43

2

22.2 Использование Eclipse ......................................................................................................................... 45

22.2.1 Установка соединения между хранилищами RTC и SVN .......................................................... 45

22.2.2 Настройка связи SVN проекта ..................................................................................................... 46

22.2.3 Связывание изменений ............................................................................................................... 47

3

1 Установка сервера Visual SVN 1. Запустить инсталлятор.

2. На странице приветствия нажать кнопку Next.

3. На следующей странице согласиться с лицензионным соглашением и нажать кнопку Next.

4. На следующем шаге выбрать компоненты для установки и нажать Next.

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

авторизации. Далее нежно нажать Next/

6. На следующем необходимо начать процесс копирования файлов, нажав кнопку Install, и дождаться

окончания процесса.

7. В окне завершения установки нужно указать необходимые действия по завершению установки и

нажать кнопку Finish.

4

2 Установка клиента TortoiseSVN 1. Запустить инсталлятор.

2. На странице приветствия нажать кнопку Next.

3. На следующей странице согласиться с лицензионным соглашением и нажать кнопку Next.

4. На следующем шаге выбрать компоненты для установки и нажать Next.

5. На следующем необходимо начать процесс копирования файлов, нажав кнопку Install, и дождаться

окончания процесса.

6. В окне завершения установки нужно указать необходимые действия по завершению установки и

нажать кнопку Finish.

3 Создание пользователей и групп 1. Запустить консоль управления сервером SVN

5

2. Нажать правой кнопкой мыши на разделе Users и выбрать Create User.

3. Ввести данные для авторизации и нажать кнопку Ок.

4. Нажать правой кнопкой мыши на разделе Groups и выбрать Create Group.

6

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

Далее нажать кнопку Ок.

6. Дальнейшее редактирование группы выполняется с помощью контекстного меню группы Edit.

4 Создание хранилища 1. В консоли администрирования сервера SVN выбрать пункт Repositories правой кнопкой мыши и

выбрать Create New Repository.

2. Указать наименование и, рекомендуется, указать структуру по умолчанию.

7

3. Нажать кнопку Ок.

4. Задать права доступа к репозиторию вызвав свойства хранилища.

5. Запретить группе Все пользователи доступ.

6. Добавить группу компании.

5 Подключение к серверу 1. Щелкнуть по рабочему столу правой кнопкой мыши и выбрать обозреватель хранилища.

8

2. В появившемся окне ввести адрес репозитория https://RAT-SRV.dev.jazz.net/svn/ProjectDocs/

3. Ввести логин и пароль и запомнить учетные данные.

4. Просмотреть структуру репозитория.

6 Загрузка файлов на локальный компьютер 1. Создать локальный каталог, в который будут загружены данные (например,

C:\WorskSpaces\WorkSpace1).

2. Войти в новый каталог и выбрать извлечение.

9

3. Выбрать необходимые элементы для загрузки и нажать OK.

4. Проверить результаты.

10

5. Создать новый каталог в рабочей области (например, Требования).

6. Добавить новый каталог под версионный контроль.

7. Зафиксировать изменения.

11

8. Проверить результаты с помощью обозревателя хранилища.

7 Импорт данных в хранилище 1. Создать структуру каталогов на локальном диске.

2. Выбрать каталог верхнего уровня и импортировать его.

12

3. Обновить рабочее пространство.

8 Разрешение конфликтов при редактировании текстовых файлов 1. Создать и добавить под версионный контроль произвольный текстовый файл.

13

2. Создать второе рабочее пространство и загрузить в него данные из хранилища.

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

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

14

5. В результате фиксации во втором рабочем пространстве появится информации о конфликте.

6. Обновить конфликтный файл.

7. Если конфликты были автоматически решены, то появится окно фиксации файла.

15

8. Повторить внесение изменений, но внести их в одно и то же место (строку).

9. В данном случае появится предупреждение о конфликте.

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

16

11. В результате появится окно с описанием конфликта.

12. Внести изменения в нижней части окна конфликтов (в ней находится результирующий файл).

13. Пометить конфликт как исправленный.

17

14. Закрыть окно решения конфликтов и зафиксировать изменения.

9 Разрешение конфликтов при редактировании файлов MS Word Примечание: Для слияния документа в нем не должно быть изменений в режиме правки.

1. Сделать изменения документа в первом рабочем пространстве и зафиксировать их.

2. Сделать изменения документа во втором рабочем пространстве и зафиксировать их.

3. Выполнить решение конфликта.

4. В появившемся окне принять необходимые правки и сохранить документ.

5. Все открытые параллельно документы не сохранять.

6. Уладить конфликт.

18

7. Зафиксировать изменения.

10 Блокирование файлов на изменение 1. В первом рабочем пространстве заблокировать файл.

19

2. Попробовать внести изменения из второй рабочей области.

11 Проверка состояния хранилища. 1. В первом рабочем пространстве внести изменения:

1.1. Для некоторых файлов внести изменения содержимого.

1.2. Выбрать любой файл и вызвать его свойства.

20

1.3. Создать дополнительные свойства.

1.4. Ввести наименование и значение свойства.

2. Зафиксировать все изменения.

21

3. Проверить состояние хранилища для второго рабочего пространства.

22

4. В появившемся окне нажать кнопку Проверить хранилище.

12 Группы изменений 1. Изменить несколько файлов документов и текстовых файлов.

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

3. В окне фиксации выбрать документы и переместить их в новую группу.

4. Ввести наименование группы.

5. Выбрать файлы для фиксации и сохранить группу.

23

13 Журнал ревизий 1. Выбрать файл и вызвать журнал версий.

2. Выполнить сравнение версий.

3. Выполнить открытие и сохранение ревизий.

24

14 Копирование/перемещение/переименование файлов и папок 1. Выбрать необходимые для выполнения операции файлы.

2. Перетащить их в целевой каталог.

3. При перетаскивании указать необходимую операцию

4. Зафиксировать изменения

15 Игнорирование файлов и папок 1. Добавить новую папку zip в каталог рабочего пространства.

2. Добавить все файлы zip в список игнорирования.

25

3. Зафиксировать родительский каталог и проверить результат.

4. Добавить новый файл под контроль, затем добавить и удалить шаблон *.zip.

5. Перейти в настройки SVN.

6. Добавить шаблон для zip-файлов.

7. Добавить под версионный контроль и проверить результат фиксации.

26

16 Отмена изменений 1. Внести изменения в несколько файлов.

2. Выбрать родительский каталог и выполнить команду Убрать изменения.

3. В появившемся окне выбрать необходимые для отмены изменений файлы.

17 Ветви и метки

17.1 Создание проекта с необходимой структурой 1. Перейти в консоль администрирования Visual SVN.

2. Создать новое хранилище.

3. При создании хранилища указать типовую структуру.

27

4. В результате появится структура следующего вида:

5. Подключить к новому проекту и наполнить поток trunk.

17.2 Создание ветви или метки 1. Перейти к основному потоку, нажать на нем правой кнопкой мыши и выбрать Ответвление/Метка.

2. Установить путь для метки.

28

3. Попытаться изменить и зафиксировать файлы в версии

4. Создать ветвь для основного потока.

5. Выполнить и зафиксировать изменения в потоке разработки.

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

29

7. Выбрать корневой каталог и выполнить переключение.

8. Выбрать поток разработки.

9. Внести изменения в потоке разработки и зафиксировать их.

10. Переключить рабочую область на основной поток.

11. Выбрать слияние ветви.

30

12. Выбрать тип слияния.

13. Указать исходную ветвь.

14. Указать параметры слияния.

31

15. Нажать кнопку Слияние.

16. Зафиксировать изменения после слияния.

18 Обработка конфликтов при слиянии 1. С помощью переключения ветвей внести изменения в один и тот же файл в основном потоке и

потоке разработки.

2. Выполнить слияние.

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

4. Решить конфликты.

19 Авторство 1. Выбрать любой текстовый файл и вызвать авторство.

32

2. Выбрать диапазон версий для просмотра.

3. Проверить результат.

20 Дерево версий 1. Выбрать любой файл и вызвать дерево версий.

33

2. Проверить результат.

3. Навести на любую из версий и посмотреть результат.

4. Выбрать любую из версий и посмотреть журнал.

5. Обновить рабочую версию до любой ревизии.

34

21 Использование с Eclipse

21.1 Подключение к SVN 1. Открыть проекцию SVN.

2. Добавить новый репозиторий.

3. Загрузить проект локально в проект.

35

4. Открыть окно просмотра проектов.

36

21.2 Добавление существующих файлов под версионный контроль 1. Скопировать файлы из локальной файловой системы.

2. Вставить в необходимый каталог.

3. Обновить каталог.

37

4. Выделить новые файлы и добавить под версионный контроль.

5. Зафиксировать изменения.

6. Выбрать файлы и добавить комментарий.

38

21.3 Изменение файлов 1. Выбрать любой файл в проводника проекта.

2. Внести изменения и сохранить документ.

3. Зафиксировать изменения.

21.4 Добавление новых файлов 1. Выбрать необходимый каталог и создать в нем файл.

39

2. Задать ему название.

3. Наполнить содержимым.

4. Добавить его под версионный контроль и зафиксировать изменения.

21.5 Обновление пространства 1. Выбрать каталог для обновления и обновить до последней версии.

40

22 Интеграция с RTC

22.1 Использование TortoiseSVN

22.1.1 Настройка соединения

1. Вызвать свойства рабочего пространства.

2. Добавить пустое свойство bugtraq:url.

41

3. Выбрать свойство и выполнить его исправление.

4. Указать путь, по которому открываются задания Jazz, и указать расположение тип и идентификатора.

(путь: https://rat-

srv.dev.jazz.net:9443/ccm/resource/itemName/com.ibm.team.workitem.WorkItem/%BUGID%)

5. Добавить дополнительные свойства.

42

6. Сохранить и зафиксировать изменения.

22.1.2 Связывание заданий при внесении изменений

1. Внести изменения в любой файл рабочего пространства и зафиксировать изменения.

2. Указать комментарий и номер задания.

3. Открыть историю файла и проверить результат.

43

4. Открыть задание по ссылке.

22.1.3 Добавление ссылки на изменения

1. Открыть историю необходимого файла.

2. Вызвать обзор хранилища для версии.

44

3. Скопировать ссылку на версию файла.

4. Открыть задание Jazz и добавить новую ссылку на версию SVN.

5. Вставить адрес в появившееся окно.

6. Сохранить изменения.

7. Открыть файл через ссылку.

45

22.2 Использование Eclipse

22.2.1 Установка соединения между хранилищами RTC и SVN

1. Открыть окно соединения jazz с svn.

2. Создать новое соединение.

46

3. Указать путь к хранилищу.

4. Обновить связи.

22.2.2 Настройка связи SVN проекта

1. Открыть свойства проекта.

2. Связать хранилище с проектом Jazz на странице Задания Jazz.

47

3. Применить изменения.

22.2.3 Связывание изменений

1. Запомнить идентификатор задания, по которому будет выполняться работа.

2. Внести изменения в файл и зафиксировать изменения.

3. Указать номер задания при фиксации.

4. Просмотреть историю изменения файла.

48

5. Открыть задание из истории.

6. Выбрать правой кнопкой последнюю запись истории и открыть пункт Связать задание….

49

7. Ввести идентификатор задания (либо создать новое).

8. Открыть связанное задание.

9. Проверить наличие ссылки в задании.

10. Открыть ссылку.

50

11. Сравнить данную версию файл с предыдущей.