-
1. Введение
- 1.1 О системе контроля версий
- 1.2 Краткая история Git
- 1.3 Что такое Git?
- 1.4 Командная строка
- 1.5 Установка Git
- 1.6 Первоначальная настройка Git
- 1.7 Как получить помощь?
- 1.8 Заключение
-
2. Основы Git
-
3. Ветвление в Git
- 3.1 О ветвлении в двух словах
- 3.2 Основы ветвления и слияния
- 3.3 Управление ветками
- 3.4 Работа с ветками
- 3.5 Удалённые ветки
- 3.6 Перебазирование
- 3.7 Заключение
-
4. Git на сервере
- 4.1 Протоколы
- 4.2 Установка Git на сервер
- 4.3 Генерация открытого SSH ключа
- 4.4 Настраиваем сервер
- 4.5 Git-демон
- 4.6 Умный HTTP
- 4.7 GitWeb
- 4.8 GitLab
- 4.9 Git-хостинг
- 4.10 Заключение
-
5. Распределённый Git
-
6. GitHub
-
7. Инструменты Git
- 7.1 Выбор ревизии
- 7.2 Интерактивное индексирование
- 7.3 Припрятывание и очистка
- 7.4 Подпись
- 7.5 Поиск
- 7.6 Перезапись истории
- 7.7 Раскрытие тайн reset
- 7.8 Продвинутое слияние
- 7.9 Rerere
- 7.10 Обнаружение ошибок с помощью Git
- 7.11 Подмодули
- 7.12 Создание пакетов
- 7.13 Замена
- 7.14 Хранилище учётных данных
- 7.15 Заключение
-
8. Настройка Git
- 8.1 Конфигурация Git
- 8.2 Атрибуты Git
- 8.3 Хуки в Git
- 8.4 Пример принудительной политики Git
- 8.5 Заключение
-
9. Git и другие системы контроля версий
- 9.1 Git как клиент
- 9.2 Переход на Git
- 9.3 Заключение
-
10. Git изнутри
- 10.1 Сантехника и Фарфор
- 10.2 Объекты Git
- 10.3 Ссылки в Git
- 10.4 Pack-файлы
- 10.5 Спецификации ссылок
- 10.6 Протоколы передачи данных
- 10.7 Обслуживание репозитория и восстановление данных
- 10.8 Переменные окружения
- 10.9 Заключение
-
A1. Приложение A: Git в других окружениях
- A1.1 Графические интерфейсы
- A1.2 Git в Visual Studio
- A1.3 Git в Visual Studio Code
- A1.4 Git в Eclipse
- A1.5 Git в IntelliJ / PyCharm / WebStorm / PhpStorm / RubyMine
- A1.6 Git в Sublime Text
- A1.7 Git в Bash
- A1.8 Git в Zsh
- A1.9 Git в PowerShell
- A1.10 Заключение
-
A2. Приложение B: Встраивание Git в ваши приложения
- A2.1 Git из командной строки
- A2.2 Libgit2
- A2.3 JGit
- A2.4 go-git
- A2.5 Dulwich
-
A3. Приложение C: Команды Git
- A3.1 Настройка и конфигурация
- A3.2 Клонирование и создание репозиториев
- A3.3 Основные команды
- A3.4 Ветвление и слияния
- A3.5 Совместная работа и обновление проектов
- A3.6 Осмотр и сравнение
- A3.7 Отладка
- A3.8 Внесение исправлений
- A3.9 Работа с помощью электронной почты
- A3.10 Внешние системы
- A3.11 Администрирование
- A3.12 Низкоуровневые команды
9.1 Git и другие системы контроля версий - Git как клиент
Наш мир несовершенен. Как правило, вы не можете быстро перевести свой проект на использование Git. Иногда вам придётся иметь дело с проектами, использующими другую систему контроля версий, хотя вам и не нравится, что это не Git. В первой части этого раздела вы узнаете о способах использования Git в качестве клиента для работы с проектом, размещённом в другой системе контроля версий.
В какой-то момент, вы, возможно, захотите перевести свой существующий проект на Git. Во второй части главы вы узнаете о том, как провести миграцию в Git из некоторых специфических систем, а также познакомитесь с методом, который будет работать в нестандартных ситуациях, когда готовых инструментов миграции не существует.
Git как клиент
Git оказывает настолько положительное впечатление на разработчиков, что многие из них придумывают способы, как использовать его на своём компьютере, в случае если остальная часть команды использует другую систему контроля версий. Для этого разработан целый ряд специальных адаптеров, называемых «мостами» («bridges»). Здесь мы рассмотрим те, с которыми вы, скорее всего, столкнётесь при работе над реальными проектами.
Git и Subversion
Весомая часть проектов разработки с открытым исходным кодом, равно как и огромное количество корпоративных проектов, до сих пор используют Subversion (SVN) для управления исходным кодом. Он существует уже более десяти лет и большую часть этого времени был де-факто единственной системой контроля версий для проектов с открытым исходным кодом. Он также во многом похож на CVS, своего предка — «крёстного отца» всех современных систем управления версиями.
Одна из многих замечательных вещей в Git — это поддержка двусторонней интеграции с SVN через git svn
.
Этот инструмент позволяет использовать Git в качестве полноценного SVN клиента; вы можете использовать всю функциональность Git для работы с локальным репозиторием, скомпоновать ревизии и отправить их на сервер, словно вы использовали обычный SVN.
Да, вы не ослышались: можно создавать локальные ветки, производить слияния, использовать индекс для неполного применения изменений, перемещать коммиты и повторно применять их (cherry-pick) и т. д., в то время как ваши коллеги, использующие SVN, застряли в палеолите.
Это отличный способ по-партизански внедрить Git в процесс разработки и помочь соратниками стать более продуктивными, а затем потребовать от инфраструктуры полной поддержки Git.
git svn
— это первый укол наркотика «DVCS», вызывающего сильнейшее привыкание.
git svn
Основная команда для работы с Subversion — это git svn
.
Она принимает несколько дополнительных команд, которые мы рассмотрим далее.
Важно понимать, что каждый раз, когда вы используете git svn
, вы взаимодействуете с Subversion, который работает совсем не как Git.
И хотя вы можете создавать и сливать локальные ветки, всё же лучше сохранять историю линейной настолько, насколько это возможно, используя перемещение коммитов.
Также избегайте одновременной работы с удалённым Git сервером.
Не изменяйте уже опубликованную историю, и не зеркалируйте изменения в Git репозитории, с которым работают люди, использующие Git (они могут изменить историю). В Subversion может быть только одна линейная история коммитов. Если в вашей команде часть людей использует SVN, а часть — Git, убедитесь, что все используют SVN сервер для сотрудничества. Это сделает вашу жизнь проще.
Установка
Чтобы попробовать git svn
в деле вам понадобится обычный SVN репозиторий с правом на запись.
Если вы хотите попробовать примеры ниже, вам понадобится копия нашего тестового репозитория.
К счастью, в Subversion есть инструмент svnsync
, который упростит перенос.
Для тестов мы создали новый Subversion репозиторий на Google Code, являющийся частичной копией проекта protobuf
— библиотеки для сериализации структурированных данных для передачи по сети.
Если вы с нами, создайте локальный Subversion репозиторий:
$ mkdir /tmp/test-svn
$ svnadmin create /tmp/test-svn
Затем, позвольте всем пользователям изменять т. н. revprops
; самый простой способ сделать это — добавить скрипт pre-revprop-change
, всегда возвращающий 0:
$ cat /tmp/test-svn/hooks/pre-revprop-change
#!/bin/sh
exit 0;
$ chmod +x /tmp/test-svn/hooks/pre-revprop-change
Теперь вы можете синхронизировать репозиторий на локальной машине, вызвав svnsync init
, передав входной и выходной репозитории:
$ svnsync init file:///tmp/test-svn \
http://your-svn-server.example.org/svn/
Наконец (SVN вам ещё не надоел?), можно запустить саму синхронизацию. Затем можно будет клонировать собственно код, выполнив:
$ svnsync sync file:///tmp/test-svn
Committed revision 1.
Copied properties for revision 1.
Transmitting file data .............................[...]
Committed revision 2.
Copied properties for revision 2.
[…]
На всё про всё у вас уйдёт несколько минут, но на самом деле вам ещё повезло: если бы вы копировали данные не на свой компьютер, а в другой удалённый репозиторий, понадобился бы почти час, несмотря на то, что в тестовом проекте меньше сотни ревизий. Subversion копирует данные последовательно, скачивая по одной ревизии и отправляя в другой репозиторий — это поразительно неэффективно, но как есть, так есть.
Начало работы
Теперь, когда у вас есть Subversion репозиторий с правами на запись, можно опробовать типичные приёмы работы с ним через git svn
Начнём с команды git svn clone
, которая клонирует Subversion репозиторий целиком в локальный Git репозиторий.
Разумеется, при переносе реального Subversion репозитория нужно будет заменить file:///tmp/test-svn
на настоящий URL:
$ git svn clone file:///tmp/test-svn -T trunk -b branches -t tags
Initialized empty Git repository in /private/tmp/progit/test-svn/.git/
r1 = dcbfb5891860124cc2e8cc616cded42624897125 (refs/remotes/origin/trunk)
A m4/acx_pthread.m4
A m4/stl_hash.m4
A java/src/test/java/com/google/protobuf/UnknownFieldSetTest.java
A java/src/test/java/com/google/protobuf/WireFormatTest.java
…
r75 = 556a3e1e7ad1fde0a32823fc7e4d046bcfd86dae (refs/remotes/origin/trunk)
Found possible branch point: file:///tmp/test-svn/trunk => file:///tmp/test-svn/branches/my-calc-branch, 75
Found branch parent: (refs/remotes/origin/my-calc-branch) 556a3e1e7ad1fde0a32823fc7e4d046bcfd86dae
Following parent with do_switch
Successfully followed parent
r76 = 0fb585761df569eaecd8146c71e58d70147460a2 (refs/remotes/origin/my-calc-branch)
Checked out HEAD:
file:///tmp/test-svn/trunk r75
Приведённая выше команда является композицией двух других — git svn init
и git svn fetch
для указанного URL.
Процесс копирования займёт некоторое время.
Тестовый проект невелик — всего 75 коммитов — но Git вынужден последовательно скачивать SVN ревизии и превращать их в Git коммиты по одной за раз.
Для проекта с сотней или тысячей ревизий это может занять часы или даже дни!
Параметры -T trunk -b branches -t tags
говорят Git о том, что клонируемый репозиторий следует стандартному, принятому в Subversion, расположению каталогов с транком, ветками и тегами.
Если же каталоги названы по-другому, можно указать их явно, используя эти параметры.
Большинство Subversion репозиториев следуют этому соглашению, поэтому для этой комбинации параметров существует сокращение -s
, что означает «стандартное расположение каталогов»
Следующая команда эквивалентна приведённой выше:
$ git svn clone file:///tmp/test-svn -s
На этом этапе у вас должен быть обычный Git репозиторий с импортированными ветками и тегами:
$ git branch -a
* master
remotes/origin/my-calc-branch
remotes/origin/tags/2.0.2
remotes/origin/tags/release-2.0.1
remotes/origin/tags/release-2.0.2
remotes/origin/tags/release-2.0.2rc1
remotes/origin/trunk
Обратите внимание, как git svn
представляет метки Subversion в виде ссылок.
Давайте посмотрим на это повнимательней, используя команду show-ref
:
$ git show-ref
556a3e1e7ad1fde0a32823fc7e4d046bcfd86dae refs/heads/master
0fb585761df569eaecd8146c71e58d70147460a2 refs/remotes/origin/my-calc-branch
bfd2d79303166789fc73af4046651a4b35c12f0b refs/remotes/origin/tags/2.0.2
285c2b2e36e467dd4d91c8e3c0c0e1750b3fe8ca refs/remotes/origin/tags/release-2.0.1
cbda99cb45d9abcb9793db1d4f70ae562a969f1e refs/remotes/origin/tags/release-2.0.2
a9f074aa89e826d6f9d30808ce5ae3ffe711feda refs/remotes/origin/tags/release-2.0.2rc1
556a3e1e7ad1fde0a32823fc7e4d046bcfd86dae refs/remotes/origin/trunk
При работе с Git репозиторием Git поступает иначе, вот как выглядит Git репозиторий сразу после клонирования:
$ git show-ref
c3dcbe8488c6240392e8a5d7553bbffcb0f94ef0 refs/remotes/origin/master
32ef1d1c7cc8c603ab78416262cc421b80a8c2df refs/remotes/origin/branch-1
75f703a3580a9b81ead89fe1138e6da858c5ba18 refs/remotes/origin/branch-2
23f8588dde934e8f33c263c6d8359b2ae095f863 refs/tags/v0.1.0
7064938bd5e7ef47bfd79a685a62c1e2649e2ce7 refs/tags/v0.2.0
6dcb09b5b57875f334f61aebed695e2e4193db5e refs/tags/v1.0.0
Заметили?
Git помещает метки прямиком в refs/tags
, но в случае с Subversion репозиторием они трактуются как удалённые ветки.
Отправка изменений в Subversion
Теперь, когда вы настроили репозиторий, можно проделать некую работу и отправить изменения обратно в Subversion, используя Git как SVN клиент. Если вы отредактируете какой-либо файл и зафиксируете изменения, полученный коммит будет существовать в локальном Git репозитории, но не на сервере Subversion.
$ git commit -am 'Adding git-svn instructions to the README'
[master 4af61fd] Adding git-svn instructions to the README
1 file changed, 5 insertions(+)
Далее следует отправить изменения на сервер.
Обратите внимание как это меняет привычный сценарий работы с Subversion: вы фиксируете изменения без связи с сервером, а затем отправляете их все при удобном случае.
Чтобы отправить изменения на Subversion сервер, следует выполнить команду git svn dcommit
:
$ git svn dcommit
Committing to file:///tmp/test-svn/trunk ...
M README.txt
Committed r77
M README.txt
r77 = 95e0222ba6399739834380eb10afcd73e0670bc5 (refs/remotes/origin/trunk)
No changes between 4af61fd05045e07598c553167e0f31c84fd6ffe1 and refs/remotes/origin/trunk
Resetting to the latest refs/remotes/origin/trunk
Эта команда берёт все изменения, зафиксированные поверх последних ревизий с Subversion сервера, создаёт для каждого новую Subversion ревизию, а затем переписывает их, добавляя уникальный идентификатор.
Это важно, потому что изменяются SHA-1 хеши коммитов.
Это одна из причин, почему не рекомендуется смешивать Subversion и Git сервер в одном проекте.
Если посмотреть на последний коммит, вы увидите, что добавилась строка git-svn-id
:
$ git log -1
commit 95e0222ba6399739834380eb10afcd73e0670bc5
Author: ben <ben@0b684db3-b064-4277-89d1-21af03df0a68>
Date: Thu Jul 24 03:08:36 2014 +0000
Adding git-svn instructions to the README
git-svn-id: file:///tmp/test-svn/trunk@77 0b684db3-b064-4277-89d1-21af03df0a68
Обратите внимание, что SHA-1 хеш, прежде начинавшийся с 4af61fd
, теперь начинается с 95e0222
.
Если всё же хотите работать как с Git, так и с Subversion серверами в одном проекте, сначала следует отправлять (dcommit
) изменения на Subversion сервер, так как это изменяет хеши.
Получение новых изменений
Если вы работаете в команде, рано или поздно кто-то успеет отправить изменения раньше вас и вы не сможете отправить свои изменения на сервер не разрешив возникший конфликт.
Ваши коммиты будут попросту отвергаться сервером, пока вы не произведёте слияние.
В git svn
это выглядит следующим образом:
$ git svn dcommit
Committing to file:///tmp/test-svn/trunk ...
ERROR from SVN:
Transaction is out of date: File '/trunk/README.txt' is out of date
W: d5837c4b461b7c0e018b49d12398769d2bfc240a and refs/remotes/origin/trunk differ, using rebase:
:100644 100644 f414c433af0fd6734428cf9d2a9fd8ba00ada145 c80b6127dd04f5fcda218730ddf3a2da4eb39138 M README.txt
Current branch master is up to date.
ERROR: Not all changes have been committed into SVN, however the committed
ones (if any) seem to be successfully integrated into the working tree.
Please see the above messages for details.
Чтобы решить эту проблему запустите git svn rebase
, которая заберёт все ревизии с сервера, которых у вас пока нет, и переместит (rebase) ваши локальные наработки на них:
$ git svn rebase
Committing to file:///tmp/test-svn/trunk ...
ERROR from SVN:
Transaction is out of date: File '/trunk/README.txt' is out of date
W: eaa029d99f87c5c822c5c29039d19111ff32ef46 and refs/remotes/origin/trunk differ, using rebase:
:100644 100644 65536c6e30d263495c17d781962cfff12422693a b34372b25ccf4945fe5658fa381b075045e7702a M README.txt
First, rewinding head to replay your work on top of it...
Applying: update foo
Using index info to reconstruct a base tree...
M README.txt
Falling back to patching base and 3-way merge...
Auto-merging README.txt
ERROR: Not all changes have been committed into SVN, however the committed
ones (if any) seem to be successfully integrated into the working tree.
Please see the above messages for details.
Теперь история линейна и вы можете успешно выполнить dcommit
:
$ git svn dcommit
Committing to file:///tmp/test-svn/trunk ...
M README.txt
Committed r85
M README.txt
r85 = 9c29704cc0bbbed7bd58160cfb66cb9191835cd8 (refs/remotes/origin/trunk)
No changes between 5762f56732a958d6cfda681b661d2a239cc53ef5 and refs/remotes/origin/trunk
Resetting to the latest refs/remotes/origin/trunk
В отличие от Git, всегда требующего производить слияние свежих изменений из удалённого репозитория с локальными наработками, перед отправкой на сервер, git svn
требует слияний только в случае конфликтующих изменений (так работает Subversion).
Если кто-нибудь изменил один файл, а затем вы изменяете другой, dcommit
сработает гладко:
$ git svn dcommit
Committing to file:///tmp/test-svn/trunk ...
M configure.ac
Committed r87
M autogen.sh
r86 = d8450bab8a77228a644b7dc0e95977ffc61adff7 (refs/remotes/origin/trunk)
M configure.ac
r87 = f3653ea40cb4e26b6281cec102e35dcba1fe17c4 (refs/remotes/origin/trunk)
W: a0253d06732169107aa020390d9fefd2b1d92806 and refs/remotes/origin/trunk differ, using rebase:
:100755 100755 efa5a59965fbbb5b2b0a12890f1b351bb5493c18 e757b59a9439312d80d5d43bb65d4a7d0389ed6d M autogen.sh
First, rewinding head to replay your work on top of it...
Важно помнить про это, потому что в результате такого поведения вы получаете непредсказуемое состояние проекта, до этого не существовавшее ни на одном из компьютеров. Если изменения были несовместимы между собой, но не вызывали конфликта слияния (например, логически противоречивые изменения в разных файлах) в результате подобного произвола могут возникнуть труднодиагностируемые проблемы. С Git сервером дела обстоят иначе: перед отправкой изменений в удалённый репозиторий вы можете полностью протестировать проект локально, в то время как в Subversion вы не можете быть уверенными, что состояние проекта до и после коммита было одинаковым.
Даже если вы не готовы зафиксировать собственные изменения, следует почаще забирать изменения с Subversion сервера.
Для синхронизации можно использовать git svn fetch
, или git svn rebase
; последняя команда не только забирает все изменения из Subversion, но и переносит ваши локальные коммиты наверх.
$ git svn rebase
M autogen.sh
r88 = c9c5f83c64bd755368784b444bc7a0216cc1e17b (refs/remotes/origin/trunk)
First, rewinding head to replay your work on top of it...
Fast-forwarded master to refs/remotes/origin/trunk.
Выполнение git svn rebase
актуализирует состояние локального репозитория.
Для выполнения этой команды ваш рабочий каталог не должен содержать незафиксированных изменений.
Если это не так, вам следует либо «припрятать» (stash) свои наработки, либо на время зафиксировать: иначе git svn rebase
прекратит выполнение в случае конфликта.
Проблемы с Git-ветвлением
После того как вы привыкните к Git, вам понравится создавать тематические ветки, работать в них и сливать их основную ветку разработки.
Если работаете с Subversion сервером через git svn
, вам придётся перемещать изменения, а не проводить слияния.
Причина кроется в линейности истории в Subversion — в нём принята несколько иная концепция ветвления и слияния — так что git svn
учитывает лишь первого родителя любого коммита при преобразовании её в SVN формат.
$ git svn dcommit
Committing to file:///tmp/test-svn/trunk ...
M CHANGES.txt
Committed r89
M CHANGES.txt
r89 = 89d492c884ea7c834353563d5d913c6adf933981 (refs/remotes/origin/trunk)
M COPYING.txt
M INSTALL.txt
Committed r90
M INSTALL.txt
M COPYING.txt
r90 = cb522197870e61467473391799148f6721bcf9a0 (refs/remotes/origin/trunk)
No changes between 71af502c214ba13123992338569f4669877f55fd and refs/remotes/origin/trunk
Resetting to the latest refs/remotes/origin/trunk
Выполнение команды dcommit
на ветке с уже слитой историй пройдёт успешно, за исключением того момента, что при просмотре истории вы заметите, что коммита из ветки experiment
не были переписаны один за другим; вместо этого они схлопнулись в один коммит слияния.
Когда кто-нибудь клонирует этот репозиторий, всё что он увидит — единственное слияние, в котором собраны все изменения, словно вы выполнили git merge --squash
; они не увидят кто и когда производил коммиты.
Subversion-ветвление
Итак, ветвление в Subversion отличается от оного в Git; используйте его как можно реже.
Тем не менее, используя git svn
, вы можете создавать Subversion-ветки и фиксировать изменения в них.
Создание новых SVN-веток
Чтобы создать новую ветку в Subversion, выполните git svn branch [имя ветки]
:
$ git svn branch opera
Copying file:///tmp/test-svn/trunk at r90 to file:///tmp/test-svn/branches/opera...
Found possible branch point: file:///tmp/test-svn/trunk => file:///tmp/test-svn/branches/opera, 90
Found branch parent: (refs/remotes/origin/opera) cb522197870e61467473391799148f6721bcf9a0
Following parent with do_switch
Successfully followed parent
r91 = f1b64a3855d3c8dd84ee0ef10fa89d27f1584302 (refs/remotes/origin/opera)
Это эквивалентно выполнению команды svn copy trunk branches/opera
в Subversion, при этом действия совершаются на Subversion сервере.
Обратите внимание, что создание SVN ветки не переключает вас на неё; если сейчас зафиксировать какие-либо изменения и отправить их на сервер, они попадут в ветку trunk
, а не opera
.
Переключение активных веток
Git определяет ветку, в которую он отправит ваши коммиты при выполнении dcommit
, ища верхушку Subversion-ветки в вашей истории — она должна быть одна и она должна быть последней в текущей истории веток, имеющей метку git-svn-id
.
Если вы хотите работать одновременно с несколькими ветками, вы можете настроить локальные ветки на внесение изменений через dcommit
в конкретные ветки Subversion, отпочковывая их из импортированных SVN-ревизий нужных веток.
Если вам нужна ветка opera
, в которой вы можете поработать отдельно, можете выполнить:
$ git branch opera remotes/origin/opera
Теперь, если вы захотите слить ветку opera
в trunk
(master
), вы сможете сделать это с помощью обычной команды git merge
.
Однако вам потребуется добавить подробное описание к коммиту (через параметр -m
), иначе при слиянии комментарий будет иметь вид «Merge branch opera» вместо чего-нибудь полезного.
Помните, что хотя вы и используете git merge
для этой операции, и слияние, скорее всего, произойдёт намного проще, чем в Subversion (потому что Git автоматически определяет подходящую основу для слияния), оно не является обычным слиянием в Git.
Вы должны передать данные обратно на сервер в Subversion, который не способен справиться с коммитом, имеющим более одного родителя; так что после передачи она будет выглядеть как единое целое, куда будут затолканы все изменения из другой ветки.
После того как вы сольёте одну ветку в другую, вы не сможете просто так вернуться к работе над ней, как могли бы в Git.
Команда dcommit
удаляет всю информацию о том, какая ветка была влита, так что последующие вычисления базы слияния будут неверными — команда dcommit
сделает результаты выполнения git merge
такими же, какими они были бы после выполнения git merge --squash
.
К сожалению, избежать подобной ситуации вряд ли удастся: Subversion не способен сохранять подобную информацию, так что вы всегда будете связаны этими ограничениями.
Во избежание проблем вы должны удалить локальную ветку (в нашем случае opera
) после того, как вы вольёте её в trunk.
Команды Subversion
В git svn
содержится несколько команд для облегчения перехода на Git путём предоставления схожей с Subversion функциональности.
Ниже приведены несколько команд, которые дают вам то, что вы имели в Subversion.
Просмотр истории в стиле SVN
Если вы привыкли к Subversion и хотите просматривать историю в стиле SVN, выполните команду git svn log
, чтобы просматривать историю в таком же формате, как в SVN:
$ git svn log
------------------------------------------------------------------------
r87 | schacon | 2014-05-02 16:07:37 -0700 (Sat, 02 May 2014) | 2 lines
autogen change
------------------------------------------------------------------------
r86 | schacon | 2014-05-02 16:00:21 -0700 (Sat, 02 May 2014) | 2 lines
Merge branch 'experiment'
------------------------------------------------------------------------
r85 | schacon | 2014-05-02 16:00:09 -0700 (Sat, 02 May 2014) | 2 lines
updated the changelog
Вы должны знать две важные вещи о команде git svn log
.
Во-первых, для её работы не требуется доступ к сети, в отличие от оригинальной команды svn log
, которая запрашивает информацию с Subversion сервера.
Во-вторых, эта команда отображает только те коммиты, которые были переданы на Subversion сервер.
Локальные Git коммиты, которые вы ещё не отправили с помощью dcommit
, не будут отображаться, равно как и коммиты, отправленные на Subversion сервер другими людьми с момента последнего выполнения dcommit
.
Результат действия этой команды скорее похож на последнее известное состояние изменений на Subversion сервере.
SVN-Аннотации
Так же как команда git svn log
эмулирует команду svn log
, эквивалентом команды svn annotate
является команда git svn blame [ФАЙЛ]
.
Вывод выглядит следующим образом:
$ git svn blame README.txt
2 temporal Protocol Buffers - Google's data interchange format
2 temporal Copyright 2008 Google Inc.
2 temporal http://code.google.com/apis/protocolbuffers/
2 temporal
22 temporal C++ Installation - Unix
22 temporal =======================
2 temporal
79 schacon Committing in git-svn.
78 schacon
2 temporal To build and install the C++ Protocol Buffer runtime and the Protocol
2 temporal Buffer compiler (protoc) execute the following:
2 temporal
Опять же, эта команда не показывает коммиты, которые вы сделали локально в Git или те, что были отправлены на Subversion сервер с момента последней связи с ним.
Информация о SVN-сервере
Вы можете получить ту же информацию, которую выдаёт svn info
, выполнив команду git svn info
:
$ git svn info
Path: .
URL: https://schacon-test.googlecode.com/svn/trunk
Repository Root: https://schacon-test.googlecode.com/svn
Repository UUID: 4c93b258-373f-11de-be05-5f7a86268029
Revision: 87
Node Kind: directory
Schedule: normal
Last Changed Author: schacon
Last Changed Rev: 87
Last Changed Date: 2009-05-02 16:07:37 -0700 (Sat, 02 May 2009)
Так же, как blame
и log
, эта команда выполняется без доступа к сети и выводит информацию, актуальную на момент последнего обращения к серверу Subversion.
Игнорирование того, что игнорирует Subversion
Если вы клонируете Subversion-репозиторий с установленными svn:ignore
свойствами, скорее всего, вы захотите создать соответствующие им файлы .gitignore
, чтобы ненароком не зафиксировать лишнего.
Для решения этой проблемы в git svn
имеется две команды.
Первая — git svn create-ignore
— автоматически создаст соответствующие файлы .gitignore
, которые вы затем можете зафиксировать.
Вторая команда — git svn show-ignore
— выводит на стандартный вывод строки, которые следует включить в файл .gitignore
; вы можете попросту перенаправить вывод этой команды в файл исключений:
$ git svn show-ignore > .git/info/exclude
Поступая таким образом, вы не захламляете проект файлами .gitignore
.
Это хорошее решение в случае если вы являетесь единственным пользователем Git в команде, использующей Subversion, и ваши коллеги выступают против наличия файлов .gitignore
в проекте.
Заключение по git-svn
Утилиты git svn
полезны в том случае, если ваша разработка по каким-то причинам требует наличия рабочего Subversion-сервера.
Однако, стоит воспринимать их как «функционально урезанный» Git, ибо при использовании всех возможностей Git вы столкнётесь с проблемами в преобразованиях, которые могут сбить с толку вас и ваших коллег.
Чтобы избежать неприятностей, старайтесь следовать следующим рекомендациям:
-
Держите историю в Git линейной, чтобы она не содержала слияний, сделанных с помощью
git merge
. Перемещайте всю работу, которую вы выполняете вне основной ветки обратно в неё; не выполняйте слияний. -
Не устанавливайте отдельный Git-сервер для совместной работы. Можно иметь такой сервер для того, чтобы ускорить клонирование для новых разработчиков, но не отправляйте на него ничего, не имеющего записи
git-svn-id
. Возможно, стоит даже добавить перехватчикpre-receive
, который будет проверять каждое изменение на наличиеgit-svn-id
и отклонять коммиты, если они не имеют такой записи.
При следовании этим правилам, работа с Subversion сервером может быть более-менее сносной. Однако, если возможен перенос проекта на нормальный Git-сервер, преимущества от этого перехода дадут вашему проекту намного больше.
Git и Mercurial
Вселенная распределённых систем контроля версий не заканчивается на Git. На самом деле, существуют и другие системы, каждая со своим подходом к управлению версиями. На втором месте по популярности после Git находится Mercurial и у этих систем много общего.
К счастью, если вам нравится Git, но приходится работать с Mercurial-репозиторием, существует способ использовать Git-клиент для работы с Mercurial.
Учитывая тот факт, что Git работает с серверами через концепцию «удалённых репозиториев» (remotes), неудивительно, что работа с Mercurial-репозиторием происходит через своего рода обёртку над «удалённым репозиторием».
Проект, добавляющий такую интероперабельность, называется git-remote-hg
и расположен по адресу https://github.com/felipec/git-remote-hg.
git-remote-hg
Для начала необходимо установить git-remote-hg
.
Ничего особенного — просто поместите файл в любое место, откуда он будет виден другим программам, типа:
$ curl -o ~/bin/git-remote-hg \
https://raw.githubusercontent.com/felipec/git-remote-hg/master/git-remote-hg
$ chmod +x ~/bin/git-remote-hg
…предполагая, что ~/bin
включён в $PATH
.
Есть ещё одна зависимость: библиотека mercurial
для Python.
Если у вас установлен Python, просто выполните:
$ pip install mercurial
(Если же у вас ещё нет Python, пора исправить это: скачайте установщик с https://www.python.org/.)
Ну и наконец понадобится сам клиент Mercurial. Если он ещё не установлен — скачайте и установите с https://www.mercurial-scm.org/.
Теперь можно отжигать! Всё что потребуется — репозиторий Mercurial с которым вы можете работать. К счастью, подойдёт любой, так что мы воспользуемся репозиторием «привет, мир», используемом для обучения работе с Mercurial.
$ hg clone http://selenic.com/repo/hello /tmp/hello
Основы
Теперь, когда у нас есть подходящий «серверный» репозиторий, мы готовы разобрать типичные приёмы работы с Mercurial. Как вы увидите, эти две системы очень похожи, так что всё пройдёт гладко.
Как и всегда, вначале мы клонируем репозиторий:
$ git clone hg::/tmp/hello /tmp/hello-git
$ cd /tmp/hello-git
$ git log --oneline --graph --decorate
* ac7955c (HEAD, origin/master, origin/branches/default, origin/HEAD, refs/hg/origin/branches/default, refs/hg/origin/bookmarks/master, master) Create a makefile
* 65bb417 Create a standard 'hello, world' program
Наверняка вы обратили внимание, что мы использовали обыкновенный git clone
.
Это потому, что git-remote-hg
работает на довольно низком уровне, подобно тому, как в Git реализован HTTP/S протокол (git-remote-hg
служит как бы в качестве «помощника» для работы с удалённым репозиторием по новому протоколу (hg
), расширяя базовые возможности Git).
Подобно Git, Mercurial рассчитан на то, что каждый клиент хранит полную копию репозитория со всей историей, поэтому приведённая выше команда выполняет полное копирование со всей историей и делает это достаточно быстро.
git log
показывает два коммита, на последний из которых указывает довольно много ссылок.
На самом деле, не все из них реально существуют.
Давайте-ка посмотрим, что хранится внутри каталога .git
:
$ tree .git/refs
.git/refs
├── heads
│ └── master
├── hg
│ └── origin
│ ├── bookmarks
│ │ └── master
│ └── branches
│ └── default
├── notes
│ └── hg
├── remotes
│ └── origin
│ └── HEAD
└── tags
9 directories, 5 files
git-remote-hg
пытается нивелировать различия между Git и Mercurial, преобразовывая форматы за кулисами.
Ссылки на объекты в удалённом репозитории хранятся в каталоге refs/hg
.
Например, refs/hg/origin/branches/default
— это Git-ссылка, содержащая SHA-1 ac7955c
— коммит на который ссылается ветка master
.
Таким образом, каталог refs/hg
— это что-то типа refs/remotes/origin
, с той разницей, что здесь же отдельно хранятся закладки и ветки Mercurial.
Файл notes/hg
— отправная точка для выяснения соответствия между хешами коммитов в Git и идентификаторами ревизий в Mercurial.
Давайте посмотрим что там:
$ cat notes/hg
d4c10386...
$ git cat-file -p d4c10386...
tree 1781c96...
author remote-hg <> 1408066400 -0800
committer remote-hg <> 1408066400 -0800
Notes for master
$ git ls-tree 1781c96...
100644 blob ac9117f... 65bb417...
100644 blob 485e178... ac7955c...
$ git cat-file -p ac9117f
0a04b987be5ae354b710cefeba0e2d9de7ad41a9
Итак, refs/notes/hg
указывает на дерево, которое содержит список других объектов и имён.
Команда git ls-tree
выводит права доступа, тип, хеш и имя файла для содержимого дерева.
Наконец, добравшись до первого элемента дерева, мы обнаружим, что это блоб с названием ac9117f
(SHA-1 коммита, на которую указывает ветка master
), содержащий 0a04b98
(идентификатор последней ревизии ветки default
в Mercurial).
Всё это немного запутанно, но хорошие новости в том, что, по большому счёту, нам не нужно беспокоится об организации данных в git-remote-hg. В целом, работа с Mercurial сервером не сильно отличается от работы с Git сервером.
Ещё одна вещь, которую следует учитывать: список игнорируемых файлов.
Mercurial и Git используют очень похожие механизмы для таких списков, но всё же хранить .gitignore
в Mercurial репозитории — не самая удачная идея.
К счастью, в Git есть механизм игнорирования специфичных для локальной копии репозитория файлов, а формат списка исключений в Mercurial совместим с Git, так что можно просто скопировать .hgignore
кое-куда:
$ cp .hgignore .git/info/exclude
Файл .git/info/exclude
работает подобно .gitignore
, но не фиксируется в истории изменений.
Рабочий процесс
Предположим, вы проделали некую работу, зафиксировали изменения в ветке master
и готовы отправить изменения в удалённый репозиторий.
Вот как выглядит репозиторий сейчас:
$ git log --oneline --graph --decorate
* ba04a2a (HEAD, master) Update makefile
* d25d16f Goodbye
* ac7955c (origin/master, origin/branches/default, origin/HEAD, refs/hg/origin/branches/default, refs/hg/origin/bookmarks/master) Create a makefile
* 65bb417 Create a standard 'hello, world' program
Наша ветка master
опережает origin/master
на два коммита, пока что они есть лишь в локальном репозитории.
Давайте посмотрим, вдруг кто-нибудь сделал важные изменения:
$ git fetch
From hg::/tmp/hello
ac7955c..df85e87 master -> origin/master
ac7955c..df85e87 branches/default -> origin/branches/default
$ git log --oneline --graph --decorate --all
* 7b07969 (refs/notes/hg) Notes for default
* d4c1038 Notes for master
* df85e87 (origin/master, origin/branches/default, origin/HEAD, refs/hg/origin/branches/default, refs/hg/origin/bookmarks/master) Add some documentation
| * ba04a2a (HEAD, master) Update makefile
| * d25d16f Goodbye
|/
* ac7955c Create a makefile
* 65bb417 Create a standard 'hello, world' program
Из-за того, что мы использовали флаг --all
, выводятся ссылки «notes», используемые внутри git-remote-hg
, можно не обращать на них внимания.
В остальном, ничего необычного: origin/master
продвинулся на один коммит и история разошлась.
В отличие от остальных систем контроля версий, рассматриваемых в этой главе, Mercurial умеет работать со слияниями, так что мы не будет вытворять никаких фокусов.
$ git merge origin/master
Auto-merging hello.c
Merge made by the 'recursive' strategy.
hello.c | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
$ git log --oneline --graph --decorate
* 0c64627 (HEAD, master) Merge remote-tracking branch 'origin/master'
|\
| * df85e87 (origin/master, origin/branches/default, origin/HEAD, refs/hg/origin/branches/default, refs/hg/origin/bookmarks/master) Add some documentation
* | ba04a2a Update makefile
* | d25d16f Goodbye
|/
* ac7955c Create a makefile
* 65bb417 Create a standard 'hello, world' program
Отлично! Мы запустили все тесты, они прошли, так что всё готово для отправки изменений на удалённый сервер:
$ git push
To hg::/tmp/hello
df85e87..0c64627 master -> master
Вот и всё! Если теперь посмотреть на Mercurial репозиторий, мы не увидим там ничего необычного:
$ hg log -G --style compact
o 5[tip]:4,2 dc8fa4f932b8 2014-08-14 19:33 -0700 ben
|\ Merge remote-tracking branch 'origin/master'
| |
| o 4 64f27bcefc35 2014-08-14 19:27 -0700 ben
| | Update makefile
| |
| o 3:1 4256fc29598f 2014-08-14 19:27 -0700 ben
| | Goodbye
| |
@ | 2 7db0b4848b3c 2014-08-14 19:30 -0700 ben
|/ Add some documentation
|
o 1 82e55d328c8c 2005-08-26 01:21 -0700 mpm
| Create a makefile
|
o 0 0a04b987be5a 2005-08-26 01:20 -0700 mpm
Create a standard 'hello, world' program
Набор изменений 2 был произведён Mercurial, а изменения 3 и 4 внесены git-remote-hg
после отправки изменений, сделанных через Git.
Ветки и закладки
В Git есть только один тип веток: указатель, который передвигается «вперёд» по мере коммита изменений. В Mercurial такие указатели называются «закладки» и ведут себя схожим с Git образом.
Понятие «ветка» в Mercurial означает немного другое.
Название ветки, в которой происходят изменения, записывается внутри каждого набора изменений и, таким образом, навсегда остаётся в истории.
Например, вот один из коммитов, произведённых в ветке develop
:
$ hg log -l 1
changeset: 6:8f65e5e02793
branch: develop
tag: tip
user: Ben Straub <ben@straub.cc>
date: Thu Aug 14 20:06:38 2014 -0700
summary: More documentation
Обратите внимание на строку, начинающуюся с «branch».
Git устроен по-другому (на самом деле, оба типа веток могут быть представлены как ссылки в Git), но git-remote-hg
вынужден понимать разницу, потому что нацелен на работу с Mercurial.
Создание «закладок» Mercurial не сложнее создания простых веток в Git. Вот что мы делаем в Git:
$ git checkout -b featureA
Switched to a new branch 'featureA'
$ git push origin featureA
To hg::/tmp/hello
* [new branch] featureA -> featureA
А со стороны Mercurial это выглядит так:
$ hg bookmarks
featureA 5:bd5ac26f11f9
$ hg log --style compact -G
@ 6[tip] 8f65e5e02793 2014-08-14 20:06 -0700 ben
| More documentation
|
o 5[featureA]:4,2 bd5ac26f11f9 2014-08-14 20:02 -0700 ben
|\ Merge remote-tracking branch 'origin/master'
| |
| o 4 0434aaa6b91f 2014-08-14 20:01 -0700 ben
| | update makefile
| |
| o 3:1 318914536c86 2014-08-14 20:00 -0700 ben
| | goodbye
| |
o | 2 f098c7f45c4f 2014-08-14 20:01 -0700 ben
|/ Add some documentation
|
o 1 82e55d328c8c 2005-08-26 01:21 -0700 mpm
| Create a makefile
|
o 0 0a04b987be5a 2005-08-26 01:20 -0700 mpm
Create a standard 'hello, world' program
Обратите внимание на метку [featureA]
на пятой ревизии.
Таким образом, со стороны Git «закладки» выглядят как обычные ветки с одним лишь исключением: нельзя удалить закладку через Git (это одно из ограничений обёрток для взаимодействия с другими системами контроля версий).
Можно работать и с полноценными ветками Mercurial — просто поместите Git ветку в пространство имён branches
:
$ git checkout -b branches/permanent
Switched to a new branch 'branches/permanent'
$ vi Makefile
$ git commit -am 'A permanent change'
$ git push origin branches/permanent
To hg::/tmp/hello
* [new branch] branches/permanent -> branches/permanent
Вот как это будет выглядеть со стороны Mercurial:
$ hg branches
permanent 7:a4529d07aad4
develop 6:8f65e5e02793
default 5:bd5ac26f11f9 (inactive)
$ hg log -G
o changeset: 7:a4529d07aad4
| branch: permanent
| tag: tip
| parent: 5:bd5ac26f11f9
| user: Ben Straub <ben@straub.cc>
| date: Thu Aug 14 20:21:09 2014 -0700
| summary: A permanent change
|
| @ changeset: 6:8f65e5e02793
|/ branch: develop
| user: Ben Straub <ben@straub.cc>
| date: Thu Aug 14 20:06:38 2014 -0700
| summary: More documentation
|
o changeset: 5:bd5ac26f11f9
|\ bookmark: featureA
| | parent: 4:0434aaa6b91f
| | parent: 2:f098c7f45c4f
| | user: Ben Straub <ben@straub.cc>
| | date: Thu Aug 14 20:02:21 2014 -0700
| | summary: Merge remote-tracking branch 'origin/master'
[...]
Имя ветки «permanent» было записано внутри набора изменений с номером 7.
Итак, со стороны Git работа с обеими типами Mercurial веток выглядит одинаково: переключаемся на ветку, фиксируем изменения, забираем чужие наработки, производим слияния и отправляем изменения в репозиторий как обычно. И ещё: Mercurial не поддерживает изменение истории, только добавление новых изменений. Вот как будет выглядеть Mercurial репозиторий после интерактивного изменения истории и «принудительной» её отправки назад:
$ hg log --style compact -G
o 10[tip] 99611176cbc9 2014-08-14 20:21 -0700 ben
| A permanent change
|
o 9 f23e12f939c3 2014-08-14 20:01 -0700 ben
| Add some documentation
|
o 8:1 c16971d33922 2014-08-14 20:00 -0700 ben
| goodbye
|
| o 7:5 a4529d07aad4 2014-08-14 20:21 -0700 ben
| | A permanent change
| |
| | @ 6 8f65e5e02793 2014-08-14 20:06 -0700 ben
| |/ More documentation
| |
| o 5[featureA]:4,2 bd5ac26f11f9 2014-08-14 20:02 -0700 ben
| |\ Merge remote-tracking branch 'origin/master'
| | |
| | o 4 0434aaa6b91f 2014-08-14 20:01 -0700 ben
| | | update makefile
| | |
+---o 3:1 318914536c86 2014-08-14 20:00 -0700 ben
| | goodbye
| |
| o 2 f098c7f45c4f 2014-08-14 20:01 -0700 ben
|/ Add some documentation
|
o 1 82e55d328c8c 2005-08-26 01:21 -0700 mpm
| Create a makefile
|
o 0 0a04b987be5a 2005-08-26 01:20 -0700 mpm
Create a standard "hello, world" program
Были созданы изменения 8, 9 и 10 и теперь они принадлежат ветке permanent
, но старые изменения никуда не делись.
Это может очень удивить ваших коллег, привыкших к Mercurial, так что старайтесь так не делать.
Заключение
Git и Mercurial довольно похожи, их относительно просто можно «подружить». Если вы будете избегать изменения уже опубликованной истории (это в целом хорошая идея, не только в контексте взаимодействия с Mercurial), вы даже не заметите что работаете с другой системой контроля версий.
Git и Bazaar
Ещё одна известная распределённая система контроля версий Bazaar. Bazaar — это бесплатная система с открытым исходным кодом, являющаяся частью проекта GNU Project.
Её поведение сильно отличается от Git. Иногда, чтобы сделать то же самое, что и в Git, следует использовать другое ключевое слово, а некоторые такие же ключевые слова имеют другое значение. В частности, управления ветками сильно отличается и может вызвать путаницу, особенно для кого-нибудь из вселенной Git. Тем не менее, с Bazaar репозиторием возможно работать из Git.
Существует много проектов, которые позволяют использовать Git как клиент Bazaar.
Далее, мы будем использовать проект Филипа Контрераса, который можно найти здесь https://github.com/felipec/git-remote-bzr.
Для установки достаточно просто скачать файл git-remote-bzr
и поместить его в один из каталогов вашего $PATH
:
$ wget https://raw.github.com/felipec/git-remote-bzr/master/git-remote-bzr -O ~/bin/git-remote-bzr
$ chmod +x ~/bin/git-remote-bzr
Так же вам понадобится установленный Bazaar. И всё!
Создание репозитория Git из репозитория Bazaar
Им просто пользоваться.
Чтобы клонировать Bazaar репозиторий достаточно добавить префикс bzr::
.
Так как Git и Bazaar полностью клонируют репозиторий на ваш компьютер, то можно добавить клон Git к локальному клону Bazaar, но так делать не рекомендуется.
Гораздо проще связать клон Git с центральным хранилищем — тем же местом, с которым связан клон Bazaar.
Предположим, что вы работали с удалённым репозиторием, находящимся по адресу bzr+ssh://developer@mybazaarserver:myproject
.
Чтобы его клонировать, нужно выполнить следующие команды:
$ git clone bzr::bzr+ssh://developer@mybazaarserver:myproject myProject-Git
$ cd myProject-Git
На текущий момент, созданный Git репозиторий использует дисковое пространство не оптимально. Поэтому вы должны очистить и сжать его, особенно если репозиторий большого размера:
$ git gc --aggressive
Ветки в Bazaar
Bazaar позволяет клонировать только ветки, при этом репозиторий может содержать их несколько, а git-remote-bzr
может клонировать все.
Например, чтобы клонировать ветку выполните:
$ git clone bzr::bzr://bzr.savannah.gnu.org/emacs/trunk emacs-trunk
Чтобы клонировать весь репозиторий, выполните команду:
$ git clone bzr::bzr://bzr.savannah.gnu.org/emacs emacs
Последняя команда клонирует все ветки репозитория emacs; тем не менее, конфигурацией допускается указывать только некоторые из них:
$ git config remote-bzr.branches 'trunk, xwindow'
Некоторые удалённые репозитории не позволяют просматривать список веток, поэтому их перечисление в конфигурации для команды клонирования может оказаться проще в использовании:
$ git init emacs
$ git remote add origin bzr::bzr://bzr.savannah.gnu.org/emacs
$ git config remote-bzr.branches 'trunk, xwindow'
$ git fetch
Игнорируем то, что игнорируется в .bzrignore
При работе с проектом под управлением Bazaar вы не должны создавать файл .gitignore
, потому что можете случайно добавить его в отслеживаемые, чем могут возмутиться другие пользователи, работающие с Bazaar.
Решением может выступать создание файла .git/info/exclude
, который может быть как символической ссылкой, так и обычным файлом.
Позже мы рассмотрим пример решения этой проблемы.
Bazaar использует ту же модель игнорирования файлов что и Git, за исключением двух особенностей, не имеющих эквивалента в Git. Полное описание можно найти в документации. Эти два отличия следующие:
-
!!
позволяет игнорировать определённые шаблоны файлов, даже если они указаны со знаком!
-
RE:
в начале строки позволяет указать регулярное выражение Python. Git допускает только шаблоны оболочки.
Следовательно, возможны две ситуации:
-
Если файл
.bzrignore
не содержит специфических префиксов, то можно просто создать символическую ссылку на него:ln -s .bzrignore .git/info/exclude
-
Иначе, нужно создать файл
.git/info/exclude
и адаптировать его в соответствии с.bzrignore
так, чтобы игнорировались те же файлы.
Вне зависимости от ситуации, вам нужно следить за изменениями в .bzrignore
, чтобы файл .git/info/exclude
всегда соответствовал .bzrignore
.
На самом деле, если в файл .bzrignore
будут добавлены изменения в виде одной или нескольких строк с !!
или RE:
вначале, то Git просто не сможет их интерпретировать и вам понадобиться изменить файл .git/info/exclude
так, чтобы игнорировались те же файлы.
Более того, если файл .git/info/exclude
был символической ссылкой, то сначала нужно его удалить, скопировать .bzrignore
в .git/info/exclude
и адаптировать последний.
Однако, будьте осторожны с его созданием, потому что в Git невозможно повторно включить файл в индекс, если исключен родительский каталог этого файла.
Получение изменений с удалённого репозитория
Используя обычные команды Git можно получить изменения с удалённого репозитория.
Предположим, что изменения находятся в ветке master
, вы сливаете или перебазируете свою работу относительно ветки origin/master
:
$ git pull --rebase origin
Отправка в удалённый репозиторий
Поскольку Bazaar так же имеет концепцию коммитов слияния, то проблем не возникнет при отправке такого коммита.
Таким образом, вы можете работать в ветке, сливать изменения в master
и отправлять их.
Вы можете создавать ветки, делать коммиты и тестировать изменения как обычно.
Наконец, вы отправляете проделанную работу в репозиторий Bazaar:
$ git push origin master
Предупреждение
Существуют ограничения на выполнение операций с удалённым репозиторием. В частности, следующие команды не работают:
-
git push origin :branch-to-delete (Bazaar не понимает удаление ссылок таким способом.)
-
git push origin old:new (будет отправлена 'old')
-
git push --dry-run origin branch (push будет выполнен)
Заключение
Поскольку модели Git и Bazaar схожи, то не так много усилий требуется для их совместной работы. Всё будет в порядке пока вы следите за ограничениями и знаете, что удалённый репозиторий изначально не Git.
Git и Perforce
Perforce — очень распространённая система контроля версий в корпоративной среде. Она появилась в 1995 году, что делает её самой старой системой контроля версий, рассматриваемой в этой главе. Perforce разработан в духе тех времён; он предполагает постоянное подключение к центральному серверу, а локально хранится одна-единственная версия файлов. На самом деле, его возможности, как и ограничения, разрабатывались для решения вполне конкретных проблем; хотя многие проекты, использующие Perforce сегодня, выиграли бы от перехода на Git.
Существует два варианта совместного использования Git и Perforce.
Первый — Git Fusion от разработчиков Perforce — позволяет выставлять поддеревья Perforce-депо в качестве удалённых Git репозиториев.
Второй — git-p4
— клиентская обёртка над Perforce для Git; она не требует дополнительной настройки Perforce сервера.
Git Fusion
У создателей Perforce есть продукт, именуемый Git Fusion (доступен на http://www.perforce.com/git-fusion), который синхронизирует Perforce сервер с Git репозиторием на стороне сервера.
Установка
Для примера мы воспользуемся простейшим способом настройки Git Fusion — подготовленным образом для виртуальной машины с предустановленным Perforce демоном и собственно Git Fusion. Вы можете скачать образ на http://www.perforce.com/downloads/Perforce/20-User, а затем импортировать его в ваше любимое средство виртуализации (мы будем использовать VirtualBox).
Во время первого запуска вам потребуется сконфигурировать пароли трёх Linux пользователей (root
, perforce
и git
) и имя хоста, которое будет идентифицировать компьютер в сети.
По окончании вы увидите следующее:
Запомните IP адрес, он пригодится в будущем.
Далее, создадим пользователя Perforce.
Выберите внизу опцию «Login» и нажмите Enter
(или используйте SSH) и войдите как пользователь root
.
Используйте приведённые ниже команды, чтобы создать пользователя:
$ p4 -p localhost:1666 -u super user -f john
$ p4 -p localhost:1666 -u john passwd
$ exit
Первая команда откроет редактор для уточнения данных пользователя, но вы можете принять настройки по умолчанию, введя :wq
и нажав Enter
.
Вторая команда дважды попросит ввести пароль.
Это всё, что требовалось выполнить в оболочке ОС, можете завершить сессию.
Следующим шагом необходимо запретить Git проверять SSL сертификаты. Хотя виртуальная машина Git Fusion поставляется с сертификатом, он не привязан к домену и IP адресу виртуальной машины, так что Git будет отвергать соединения как небезопасные. Если вы собираетесь использовать эту виртуальную машину на постоянной основе, обратитесь к руководству по Git Fusion, чтобы узнать, как установить другой сертификат; для тестов же хватит следующего:
$ export GIT_SSL_NO_VERIFY=true
Теперь можете проверить что всё работает.
$ git clone https://10.0.1.254/Talkhouse
Cloning into 'Talkhouse'...
Username for 'https://10.0.1.254': john
Password for 'https://john@10.0.1.254':
remote: Counting objects: 630, done.
remote: Compressing objects: 100% (581/581), done.
remote: Total 630 (delta 172), reused 0 (delta 0)
Receiving objects: 100% (630/630), 1.22 MiB | 0 bytes/s, done.
Resolving deltas: 100% (172/172), done.
Checking connectivity... done.
На виртуальной машине уже настроен проект, который вы можете клонировать.
Мы клонируем репозиторий по HTTPS протоколу, используя ранее созданного пользователя john
; Git спросит пароль, но менеджер паролей запомнит его для последующих запросов.
Настройка Fusion
После установки Git Fusion вы, возможно, захотите настроить его.
Это относительно несложно сделать, используя ваш любимый Perforce клиент; просто отобразите каталог //.git-fusion
на Perforce сервере в ваше рабочее пространство.
Структура файлов приведена ниже:
$ tree
.
├── objects
│ ├── repos
│ │ └── [...]
│ └── trees
│ └── [...]
│
├── p4gf_config
├── repos
│ └── Talkhouse
│ └── p4gf_config
└── users
└── p4gf_usermap
498 directories, 287 files
Каталог objects
используется Git Fusion для отображения объектов Perforce в Git и наоборот, вам не следует ничего здесь трогать.
Внутри расположен глобальный конфигурационный файл p4gf_config
, а также по одному такому же файлу для каждого репозитория — эти файлы и определяют поведение Git Fusion.
Заглянем в тот, что в корне:
[repo-creation]
charset = utf8
[git-to-perforce]
change-owner = author
enable-git-branch-creation = yes
enable-swarm-reviews = yes
enable-git-merge-commits = yes
enable-git-submodules = yes
preflight-commit = none
ignore-author-permissions = no
read-permission-check = none
git-merge-avoidance-after-change-num = 12107
[perforce-to-git]
http-url = none
ssh-url = none
[@features]
imports = False
chunked-push = False
matrix2 = False
parallel-push = False
[authentication]
email-case-sensitivity = no
Мы не будем вдаваться в назначение каждой опции, просто обратите внимание, что это обыкновенный INI файл, подобный тем, что использует Git для конфигурации.
Файл, рассмотренный выше, задаёт глобальные опции, которые могут быть переопределены внутри специфичных для репозитория файлов конфигурации, типа repos/Talkhouse/p4gf_config
.
Если откроете этот файл, увидите секцию [@repo]
, переопределяющую некоторые глобальные настройки.
Также, внутри есть секции, подобные этой:
[Talkhouse-master]
git-branch-name = master
view = //depot/Talkhouse/main-dev/... ...
Они задают соответствие между ветками Perforce и ветками Git.
Названия таких секций могут быть произвольными; главное, чтобы они оставались уникальными.
git-branch-name
позволяет преобразовать пути внутри депо, которые смотрелись бы непривычно для Git пользователей.
Параметр view
управляет отображением Perforce файлов на Git репозиторий; используется стандартный синтаксис отображения видов.
Может быть задано более одного отображения, как в примере ниже:
[multi-project-mapping]
git-branch-name = master
view = //depot/project1/main/... project1/...
//depot/project2/mainline/... project2/...
Таким образом, если ваше отображение включает изменения в структуре каталогов, вы можете реплицировать эти изменения здесь.
Последний файл, который мы обсудим, это users/p4gf_usermap
; в нём задаётся отображение пользователей Perforce на пользователей Git.
Возможно, вам не пригодится этот файл.
Когда Git Fusion преобразовывает набор изменений Perforce в Git коммит, он находит пользователя в этом файле и использует хранящиеся здесь адрес электронной почты и полное имя для заполнения полей «автор» и «применяющий изменения» в Git. При обратном процессе ищется пользователь Perforce с адресом электронной почты из поля «автор» Git коммитов и используется далее для изменения.
В большинстве случаев это нормальное поведение, но что будет, если соответствия выглядят так:
john john@example.com "John Doe"
john johnny@appleseed.net "John Doe"
bob employeeX@example.com "Anon X. Mouse"
joe employeeY@example.com "Anon Y. Mouse"
Каждая строка имеет формат <user> <email> "<full name>"
и задаёт соответствие для одного пользователя.
Первые две строчки отображают два разных адреса электронной почты на одного и того же пользователя.
Это может быть полезным если вы фиксировали изменения в Git, используя разные адреса, или если вы поменяли адрес, но хотите отобразить эти изменения на одного и того же Perforce пользователя.
При создании Git коммитов Perforce используется информация из первой совпавшей строки.
Последние две строки скрывают настоящие имена Боба и Джо в созданных Git коммитах. Это может быть полезным, если вы хотите отдать внутренний проект в open-source, но не хотите раскрывать информацию о сотрудниках. Адреса электронной почты и полные имена должны быть уникальными если вы хотите хоть как-то различать авторов в полученном Git репозитории.
Рабочий процесс
Perforce Git Fusion — это двунаправленный «мост» между Perforce и Git. Давайте посмотрим, как выглядит работа со стороны Git. Предполагается, что мы настроили отображение проекта «Jam», используя приведённую выше конфигурацию. Тогда мы можем клонировать его:
$ git clone https://10.0.1.254/Jam
Cloning into 'Jam'...
Username for 'https://10.0.1.254': john
Password for 'https://john@10.0.1.254':
remote: Counting objects: 2070, done.
remote: Compressing objects: 100% (1704/1704), done.
Receiving objects: 100% (2070/2070), 1.21 MiB | 0 bytes/s, done.
remote: Total 2070 (delta 1242), reused 0 (delta 0)
Resolving deltas: 100% (1242/1242), done.
Checking connectivity... done.
$ git branch -a
* master
remotes/origin/HEAD -> origin/master
remotes/origin/master
remotes/origin/rel2.1
$ git log --oneline --decorate --graph --all
* 0a38c33 (origin/rel2.1) Create Jam 2.1 release branch.
| * d254865 (HEAD, origin/master, origin/HEAD, master) Upgrade to latest metrowerks on Beos -- the Intel one.
| * bd2f54a Put in fix for jam's NT handle leak.
| * c0f29e7 Fix URL in a jam doc
| * cc644ac Radstone's lynx port.
[...]
В первый раз этот процесс может занять некоторое время. Git Fusion преобразовывает все наборы изменений Perforce в Git коммиты. Данные преобразуются локально на сервере, так что это вполне быстрый процесс; тем не менее, он может слегка затянуться, если у вас большая история изменений. Последующие скачивания требуют лишь инкрементального преобразования данных, таким образом скорость будет сравнима со скоростью работы обычного Git сервера.
Как видите, наш репозиторий выглядит так же, как выглядел бы любой другой Git репозиторий.
В нём три ветки и Git предусмотрительно создал локальную ветку master
, отслеживающую origin/master
.
Давайте немного поработаем и зафиксируем изменения:
# ...
$ git log --oneline --decorate --graph --all
* cfd46ab (HEAD, master) Add documentation for new feature
* a730d77 Whitespace
* d254865 (origin/master, origin/HEAD) Upgrade to latest metrowerks on Beos -- the Intel one.
* bd2f54a Put in fix for jam's NT handle leak.
[...]
Теперь у нас два новых коммита. Проверим, какие изменения внесли другие:
$ git fetch
remote: Counting objects: 5, done.
remote: Compressing objects: 100% (3/3), done.
remote: Total 3 (delta 2), reused 0 (delta 0)
Unpacking objects: 100% (3/3), done.
From https://10.0.1.254/Jam
d254865..6afeb15 master -> origin/master
$ git log --oneline --decorate --graph --all
* 6afeb15 (origin/master, origin/HEAD) Update copyright
| * cfd46ab (HEAD, master) Add documentation for new feature
| * a730d77 Whitespace
|/
* d254865 Upgrade to latest metrowerks on Beos -- the Intel one.
* bd2f54a Put in fix for jam's NT handle leak.
[...]
Кто-то успел отправить свои изменения раньше нас!
Конечно, из приведённого вывода команды git fetch
не видно, но на самом деле коммит с SHA-1 6afeb15
был создан Perforce клиентом.
Он выглядит так же, как и любой другой коммит, и это именно то, для чего создан Git Fusion.
Давайте посмотрим, как Perforce обработает коммит слияния:
$ git merge origin/master
Auto-merging README
Merge made by the 'recursive' strategy.
README | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
$ git push
Counting objects: 9, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (9/9), done.
Writing objects: 100% (9/9), 917 bytes | 0 bytes/s, done.
Total 9 (delta 6), reused 0 (delta 0)
remote: Perforce: 100% (3/3) Loading commit tree into memory...
remote: Perforce: 100% (5/5) Finding child commits...
remote: Perforce: Running git fast-export...
remote: Perforce: 100% (3/3) Checking commits...
remote: Processing will continue even if connection is closed.
remote: Perforce: 100% (3/3) Copying changelists...
remote: Perforce: Submitting new Git commit objects to Perforce: 4
To https://10.0.1.254/Jam
6afeb15..89cba2b master -> master
Со стороны Git всё работает как положено.
Давайте посмотрим на историю файла README
со стороны Perforce, используя p4v
:
Если вы ни разу не работали с Perforce это окно может показаться вам запутанным, но его концепция аналогичная gitk
.
Мы просматриваем историю файла README
, так что дерево каталогов слева вверху показывает этот файл в разных ветках.
Справа вверху мы видим граф зависимости разных ревизий файла, справа внизу этот же граф показан целиком для быстрого ориентирования.
Оставшаяся часть окна отображает детали выбранной ревизии (в нашем случае это ревизия 2
).
Граф выглядит в точности как в Git.
У Perforce не было именованной ветки для сохранения коммитов 1
и 2
, так что он создал «анонимную» ветку в каталоге .git-fusion
.
Git Fusion поступит так же для именованных Git веток не соответствующих веткам в Perforce, но вы можете задать соответствие в конфигурационном файле.
Большинство происходящей магии скрыто от посторонних глаз, а в результате кто-то в команде может использовать Git, кто-то — Perforce и никто не будет подозревать о выборе других.
Заключение по Git-Fusion
Если у вас есть (или вы можете получить) доступ к Perforce серверу, Git Fusion — это прекрасный способ подружить Git и Perforce. Конечно, требуется небольшая работа напильником, но в целом всё довольно интуитивно и просто. Это один из немногих разделов в этой главе, где мы не будем предупреждать вас об опасности использования всей функциональности Git. Но Perforce не всеяден: если вы попытаетесь переписать опубликованную историю, Git Fusion отклонит изменения. Тем не менее, Git Fusion будет стараться изо всех сил, чтобы не нарушать ваших привычек при работе с Git. Вы даже можете использовать подмодули Git (хотя они и будут выглядеть странными для Perforce пользователей) и сливать ветки (на стороне Perforce это будет выглядеть как интеграция).
И даже в том случае, если вы не можете уговорить администратора настроить Git Fusion есть способ использовать Git и Perforce вместе.
Git-p4
Git-p4 — это двусторонний мост между Git и Perforce. Он работает на стороне клиента, так что вам не нужен будет доступ к Perforce серверу (разумеется, вам по-прежнему понадобятся логин и пароль). Git-p4 не так гибок и полнофункционален, как Git Fusion, но он позволяет совершать большинство необходимых действий.
Примечание
|
Исполняемый файл |
Настройка
Мы будем использовать описанный выше образ виртуальной машины Git Fusion, но мы будем напрямую обращаться к Perforce, минуя Git Fusion.
Для того, чтобы использовать команду p4
(от которой зависит git-p4
), вам нужно будет установить следующие переменные окружения:
$ export P4PORT=10.0.1.254:1666
$ export P4USER=john
Начало работы
Как обычно при работе с Git, первая команда — это клонирование:
$ git p4 clone //depot/www/live www-shallow
Importing from //depot/www/live into www-shallow
Initialized empty Git repository in /private/tmp/www-shallow/.git/
Doing initial import of //depot/www/live/ from revision #head into refs/remotes/p4/master
В терминах Git мы получим так называемую «поверхностную» копию: выкачивается лишь последняя ревизия. Помните, Perforce не предназначен для раздачи всех ревизий всем пользователям. Этого достаточно, чтобы использовать Git как Perforce клиент, но этого недостаточно для других задач.
Как только клонирование завершится, у нас будет Git репозиторий:
$ cd myproject
$ git log --oneline --all --graph --decorate
* 70eaf78 (HEAD, p4/master, p4/HEAD, master) Initial import of //depot/www/live/ from the state at revision #head
Обратите внимание на наличие удалённого репозитория p4
, соответствующего Perforce серверу; всё остальное выглядит как обычный клонированный репозиторий.
Но давайте присмотримся повнимательней: на самом деле нет никакого удалённого репозитория!
$ git remote -v
В этом репозитории нет удалённых серверов.
git-p4
создал несколько ссылок для представления состояния на сервере, и они выглядят как удалённый сервер для git log
, но таковым не являются и вы не можете отправлять изменения в них.
Рабочий процесс
Что ж, приступим к работе. Предположим, вы сделали несколько изменений для очень важной фичи и готовы показать свои наработки остальным членам команды.
$ git log --oneline --all --graph --decorate
* 018467c (HEAD, master) Change page title
* c0fb617 Update link
* 70eaf78 (p4/master, p4/HEAD) Initial import of //depot/www/live/ from the state at revision #head
Мы подготовили два коммита для отправки на Perforce сервер. Давайте посмотрим, успели ли другие члены команды проделать какую-либо работу:
$ git p4 sync
git p4 sync
Performing incremental import into refs/remotes/p4/master git branch
Depot paths: //depot/www/live/
Import destination: refs/remotes/p4/master
Importing revision 12142 (100%)
$ git log --oneline --all --graph --decorate
* 75cd059 (p4/master, p4/HEAD) Update copyright
| * 018467c (HEAD, master) Change page title
| * c0fb617 Update link
|/
* 70eaf78 Initial import of //depot/www/live/ from the state at revision #head
Кажется, успели: master
и p4/master
разошлись.
Система ветвления в Perforce абсолютно непохожа на Git, отправка слияний в Perforce не имеет смысла.
git-p4
рекомендует перемещать коммиты и даже предоставляет команду для этого:
$ git p4 rebase
Performing incremental import into refs/remotes/p4/master git branch
Depot paths: //depot/www/live/
No changes to import!
Rebasing the current branch onto remotes/p4/master
First, rewinding head to replay your work on top of it...
Applying: Update link
Applying: Change page title
index.html | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
Вы, возможно, скажете что git p4 rebase
это всего лишь сокращение для git p4 sync
с последующим git rebase p4/master
.
На самом деле, эта команда немного умнее, особенно при работе с несколькими ветками, но догадка вполне верна.
Теперь наша история снова линейна и мы готовы отправить изменения в Perforce.
Команда git p4 submit
попытается создать новые Perforce ревизии для всех коммитов в Git между p4/master
и master
.
Её запуск откроет ваш любимый редактор с примерно таким содержимым:
# A Perforce Change Specification.
#
# Change: The change number. 'new' on a new changelist.
# Date: The date this specification was last modified.
# Client: The client on which the changelist was created. Read-only.
# User: The user who created the changelist.
# Status: Either 'pending' or 'submitted'. Read-only.
# Type: Either 'public' or 'restricted'. Default is 'public'.
# Description: Comments about the changelist. Required.
# Jobs: What opened jobs are to be closed by this changelist.
# You may delete jobs from this list. (New changelists only.)
# Files: What opened files from the default changelist are to be added
# to this changelist. You may delete files from this list.
# (New changelists only.)
Change: new
Client: john_bens-mbp_8487
User: john
Status: new
Description:
Update link
Files:
//depot/www/live/index.html # edit
######## git author ben@straub.cc does not match your p4 account.
######## Use option --preserve-user to modify authorship.
######## Variable git-p4.skipUserNameCheck hides this message.
######## everything below this line is just the diff #######
--- //depot/www/live/index.html 2014-08-31 18:26:05.000000000 0000
+++ /Users/ben/john_bens-mbp_8487/john_bens-mbp_8487/depot/www/live/index.html 2014-08-31 18:26:05.000000000 0000
@@ -60,7 +60,7 @@
</td>
<td valign=top>
Source and documentation for
-<a href="http://www.perforce.com/jam/jam.html">
+<a href="jam.html">
Jam/MR</a>,
a software build tool.
</td>
Это практически те же данные, что вы увидели бы, запустив p4 submit
, за исключением нескольких строк в конце, любезно вставленных git-p4
.
git-p4
старается учитывать Git и Perforce настройки когда нужно предоставить имя для коммита, но в некоторых случаях вы захотите изменить его.
Например, если коммит в Git был создан человеком, у которого нет Perforce аккаунта, вы всё равно захотите сделать автором коммита его, а не себя.
git-p4
вставил сообщение из коммита Git в содержимое набора изменений Perforce, так что всё что нам остаётся сделать — это дважды сохранить и закрыть редактор (по одному разу на каждый коммит).
В результате мы получим такой вывод:
$ git p4 submit
Perforce checkout for depot path //depot/www/live/ located at /Users/ben/john_bens-mbp_8487/john_bens-mbp_8487/depot/www/live/
Synchronizing p4 checkout...
... - file(s) up-to-date.
Applying dbac45b Update link
//depot/www/live/index.html#4 - opened for edit
Change 12143 created with 1 open file(s).
Submitting change 12143.
Locking 1 files ...
edit //depot/www/live/index.html#5
Change 12143 submitted.
Applying 905ec6a Change page title
//depot/www/live/index.html#5 - opened for edit
Change 12144 created with 1 open file(s).
Submitting change 12144.
Locking 1 files ...
edit //depot/www/live/index.html#6
Change 12144 submitted.
All commits applied!
Performing incremental import into refs/remotes/p4/master git branch
Depot paths: //depot/www/live/
Import destination: refs/remotes/p4/master
Importing revision 12144 (100%)
Rebasing the current branch onto remotes/p4/master
First, rewinding head to replay your work on top of it...
$ git log --oneline --all --graph --decorate
* 775a46f (HEAD, p4/master, p4/HEAD, master) Change page title
* 05f1ade Update link
* 75cd059 Update copyright
* 70eaf78 Initial import of //depot/www/live/ from the state at revision #head
Выглядит так, словно мы только что выполнили git push
, что на самом деле очень близко к тому, что произошло.
Обратите внимание, что во время этого процесса каждый коммит в Git превращается в отдельный набор изменений Perforce; если вы хотите слепить их воедино, вы можете сделать это с помощью интерактивного переноса коммитов до выполнения git p4 submit
.
Ещё один важный момент: SHA-1 хеши коммитов, превращённых в наборы изменений Perforce изменились: это произошло из-за того, что git-p4
добавил строку в конец каждого сообщения:
$ git log -1
commit 775a46f630d8b46535fc9983cf3ebe6b9aa53145
Author: John Doe <john@example.com>
Date: Sun Aug 31 10:31:44 2014 -0800
Change page title
[git-p4: depot-paths = "//depot/www/live/": change = 12144]
Что произойдёт если вы попробуете отправить коммит слияния? Давайте попробуем. Допустим, мы имеем такую историю:
$ git log --oneline --all --graph --decorate
* 3be6fd8 (HEAD, master) Correct email address
* 1dcbf21 Merge remote-tracking branch 'p4/master'
|\
| * c4689fc (p4/master, p4/HEAD) Grammar fix
* | cbacd0a Table borders: yes please
* | b4959b6 Trademark
|/
* 775a46f Change page title
* 05f1ade Update link
* 75cd059 Update copyright
* 70eaf78 Initial import of //depot/www/live/ from the state at revision #head
История в Git разошлась с Perforce на коммит 775a46f
.
В Git мы имеем два дополнительные коммита, затем слияние с состоянием Perforce, затем ещё один коммит.
Мы собираемся отправить эту историю в Perforce.
Давайте посмотрим, что произойдёт:
$ git p4 submit -n
Perforce checkout for depot path //depot/www/live/ located at /Users/ben/john_bens-mbp_8487/john_bens-mbp_8487/depot/www/live/
Would synchronize p4 checkout in /Users/ben/john_bens-mbp_8487/john_bens-mbp_8487/depot/www/live/
Would apply
b4959b6 Trademark
cbacd0a Table borders: yes please
3be6fd8 Correct email address
Флаг -n
— это сокращение для --dry-run
, который, в свою очередь, пытается вывести результат выполнения отправки, как если бы отправка на самом деле произошла.
В этом случае, похоже мы создадим три ревизии в Perforce, по одной для каждой не являющейся слиянием коммита в Git.
Звучит логично, давайте посмотрим что произойдёт на самом деле:
$ git p4 submit
[…]
$ git log --oneline --all --graph --decorate
* dadbd89 (HEAD, p4/master, p4/HEAD, master) Correct email address
* 1b79a80 Table borders: yes please
* 0097235 Trademark
* c4689fc Grammar fix
* 775a46f Change page title
* 05f1ade Update link
* 75cd059 Update copyright
* 70eaf78 Initial import of //depot/www/live/ from the state at revision #head
История стала линейной, словно мы переместили изменения перед отправкой (что на самом деле и произошло). Это означает, что вы можете свободно создавать ветки в Git, работать в них, сливать их, не боясь, что ваша история станет несовместима с Perforce. Если вы можете переместить изменения, вы можете отправить их на Perforce сервер.
Ветвление
Если в вашем Perforce проекте несколько веток, не переживайте: git-p4
может организовать работу с ними, не сложнее, чем с обычными Git ветками.
Предположим, ваш Perforce репозиторий имеет следующую структуру:
//depot
└── project
├── main
└── dev
Также предположим, что ветка dev
настроена следующим образом:
//depot/project/main/... //depot/project/dev/...
git-p4
может автоматически распознать эту ситуацию и выполнить нужные действия:
$ git p4 clone --detect-branches //depot/project@all
Importing from //depot/project@all into project
Initialized empty Git repository in /private/tmp/project/.git/
Importing revision 20 (50%)
Importing new branch project/dev
Resuming with change 20
Importing revision 22 (100%)
Updated branches: main dev
$ cd project; git log --oneline --all --graph --decorate
* eae77ae (HEAD, p4/master, p4/HEAD, master) main
| * 10d55fb (p4/project/dev) dev
| * a43cfae Populate //depot/project/main/... //depot/project/dev/....
|/
* 2b83451 Project init
Обратите внимание на @all
в пути; она говорит git-p4
клонировать не только последнюю ревизию для указанного поддерева, но все ревизии, затрагивающие указанные пути.
Это ближе к оригинальной концепции клонирования в Git, но если вы работаете с большим репозиторием, это может занять некоторое время.
Флаг --detect-branches
указывает git-p4
использовать настройки веток Perforce для отображения на Git ветки.
Если же таких настроек на Perforce сервере нет (что вполне корректно для Perforce), вы можете указать их git-p4
вручную, получив аналогичный результат:
$ git init project
Initialized empty Git repository in /tmp/project/.git/
$ cd project
$ git config git-p4.branchList main:dev
$ git clone --detect-branches //depot/project@all .
Задав конфигурационный параметр git-p4.branchList
равным main:dev
мы указали git-p4
, что «main» и «dev» — это ветки, и что вторая является потомком первой.
Если мы теперь выполним git checkout -b dev p4/project/dev
и зафиксируем в ветке dev
некоторые изменения, git-p4
будет достаточно смышлёным, чтобы догадаться, в какую ветку отправлять изменения при выполнении git p4 submit
.
К сожалению, git-p4
не позволяет использовать несколько веток в поверхностных копиях репозиториев; если у вас есть большой проект и вы хотите работать более чем в одной ветке, вам придётся выполнять git p4 clone
для каждой ветки, в которую вы хотите отправлять изменения.
Для создания и интеграции веток вам нужно будет использовать Perforce клиент.
git-p4
может только забирать изменения из Perforce и отправлять линейную историю обратно.
Если вы произведёте слияние двух веток в Git и отправите изменения в Perforce, сохранятся лишь данные об изменении файлов, все метаданные об исходных ветках, участвующих в интеграции, будут потеряны.
Заключение по Git и Perforce
git-p4
позволяет использовать Git для работы с Perforce и он достаточно хорош в этом.
Тем не менее, не стоит забывать, что источником данных по-прежнему остаётся Perforce, а Git используется лишь для локальной работы.
Будьте осторожны с публикацией Git коммитов: если у вас есть удалённый репозиторий, который используют другие люди, не публикуйте в нём коммиты, не отправленные на Perforce сервер.
Если вы хотите свободно смешивать Git и Perforce для контроля версий, уговорите администратора установить Git Fusion — он позволяет использовать Git в качестве полноценного клиента для Perforce сервера.