ru/history.txt

   1 == Уроки истории ==
   2
   3 Вследствие распределенной природы Git, историю изменений можно легко редактировать. Однако, если вы вмешиваетесь в прошлое, будьте осторожны: изменяйте только ту часть истории, которой владеете вы и только вы. Иначе, как народы вечно выясняют, кто же именно совершил и какие бесчинства, так и у вас будут проблемы с примирением при попытке совместить разные деревья истории.
   4
   5 Некоторые разработчики убеждены, что история должна быть неизменна со всеми огрехами и прочим. Другие считают, что деревья нужно делать презентабельными перед выпуском их в публичный доступ.
   6 Git учитывает оба мнения. Переписывание истории, как и клонирование, ветвление и слияние, — лишь еще одна возможность, которую дает вам Git. Разумное ее использование зависит только от вас.
   7
   8 === Оставаясь корректным ===
   9
  10 Только что сделали коммит и поняли, что должны были ввести другое описание? Запустите
  11
  12  $ git commit --amend
  13
  14 чтобы изменить последнее описание. Осознали, что забыли добавить файл? Запустите *git add*, чтобы это сделать, затем выполните вышеуказанную команду.
  15
  16 Захотелось добавить еще немного изменений в последний коммит? Так сделайте их и запустите
  17
  18  $ git commit --amend -a
  19
  20 === …И кое-что еще ===
  21
  22 Давайте представим, что предыдущая проблема на самом деле в десять раз хуже. После длительной работы вы сделали ряд коммитов; но вы не очень-то довольны тем, как они организованы, и кое-какие описания коммитов надо бы слегка переформулировать. Тогда запустите
  23
  24  $ git rebase -i HEAD~10
  25
  26 и последние десять коммитов появятся в вашем любимом редакторе (задается переменной окружения $EDITOR). Например:
  27
  28     pick 5c6eb73 Добавил ссылку repo.or.cz
  29     pick a311a64 Переставил аналогии в «Работай как хочешь»
  30     pick 100834f Добавил цель для push в Makefile
  31
  32 Теперь вы можете:
  33
  34 - Убирать коммиты, удаляя строки.
  35 - Менять порядок коммитов, переставляя строки.
  36 - Заменять «pick» на:
  37    * «edit» для внесения правок в коммиты;
  38    * «reword» для изменения описания в журнале;
  39    *  «squash» для слияния коммита с предыдущим;
  40    *  «fixup», чтобы слить коммит с предыдущим, отбросив его описание.
  41
  42 Сохраните файл и закройте редактор. Если вы отметили коммит для исправлений, запустите
  43
  44  $ git commit --amend
  45
  46 Если нет, запустите
  47
  48  $ git rebase --continue
  49
  50 Одним словом, делайте коммиты как можно раньше и как можно чаще — вы всегда сможете навести порядок при помощи rebase.
  51
  52 === Локальные изменения сохраняются ===
  53
  54 Предположим, вы работаете над активным проектом. За какое-то время вы делаете несколько коммитов, затем синхронизируетесь с официальным деревом через слияние. Цикл повторяется несколько раз, пока вы не будете готовы влить изменения в центральное дерево.
  55
  56 Однако теперь история изменений в локальном клоне Git представляет собой кашу из ваших и официальных изменений. Вам бы хотелось видеть все свои изменения непрерывной линией, а затем — все официальные изменения.
  57
  58 Это работа для команды *git rebase*, описанной выше. Зачастую, имеет смысл использовать флаг *--onto* и убрать переплетения.
  59
  60 Также смотрите *git help rebase* для получения подробных примеров использования этой замечательной команды. Вы можете расщеплять коммиты. Вы можете даже переупорядочивать ветки.
  61
  62 === Переписывая историю ===
  63
  64 Время от времени вам может понадобиться в системе управления версиями аналог «замазывания» людей на официальных фотографиях, как бы стирающего их из истории в духе сталинизма. Например, предположим, что мы уже собираемся выпустить релиз проекта, но он содержит файл, который не должен стать достоянием общественности по каким-то причинам. Возможно, я сохранил номер своей кредитки в текстовый файл и случайно добавил его в проект. Удалить файл недостаточно: он может быть доступен из старых коммитов. Нам надо удалить файл из всех ревизий:
  65
  66  $ git filter-branch --tree-filter 'rm совершенно/секретный/файл' HEAD
  67
  68 Смотрите *git help filter-branch*, где обсуждается этот пример и предлагается более быстрый способ решения. Вообще, *filter-branch* позволяет изменять существенные части истории при помощи одной-единственной команды.
  69
  70 После этой команды каталог +.git/refs/original+ будет описывать состояние, которое было до ее вызова. Убедитесь, что команда filter-branch сделала то, что вы хотели, и если хотите опять использовать эту команду, удалите этот каталог.
  71
  72 И, наконец, замените клоны вашего проекта исправленной версией, если собираетесь в дальнейшем с ними взаимодействовать.
  73
  74 === Создавая Историю ===
  75
  76 [[makinghistory]]
  77 Хотите перевести проект под управление Git? Если сейчас он находится под управлением какой-либо из хорошо известных систем управления версиями, то вполне вероятно, что кто-нибудь уже написал необходимые скрипты для экспорта всей истории проекта в Git.
  78
  79 Если нет, то смотрите в сторону команды *git fast-import*, которая считывает текстовый ввод в специальном формате для создания истории Git с нуля. Обычно скрипт, использующий эту команду, бывает слеплен наспех для единичного запуска, переносящего весь проект за один раз.
  80
  81 В качестве примера вставьте такие строки во временный файл, вроде '/tmp/history':
  82 ----------------------------------
  83 commit refs/heads/master
  84 committer Alice <alice@example.com> Thu, 01 Jan 1970 00:00:00 +0000
  85 data <<EOT
  86 Начальный коммит.
  87 EOT
  88
  89 M 100644 inline hello.c
  90 data <<EOT
  91 #include <stdio.h>
  92
  93 int main() {
  94   printf("Hello, world!\n");
  95   return 0;
  96 }
  97 EOT
  98
  99 commit refs/heads/master
 100 committer Bob <bob@example.com> Tue, 14 Mar 2000 01:59:26 -0800
 101 data <<EOT
 102 Заменен printf() на write()
 103 EOT
 104
 105 M 100644 inline hello.c
 106 data <<EOT
 107 #include <unistd.h>
 108
 109 int main() {
 110   write(1, "Hello, world!\n", 14);
 111   return 0;
 112 }
 113 EOT
 114
 115 ----------------------------------
 116
 117 Затем создайте хранилище Git из этого временного файла при помощи команд:
 118
 119 $ mkdir project; cd project; git init
 120 $ git fast-import --date-format=rfc2822 < /tmp/history
 121
 122 Вы можете извлечь последнюю версию проекта с помощью
 123
 124  $ git checkout master .
 125
 126 Команда *git fast-export* преобразует любое хранилище в формат, понятныый команде *git fast-import*. Ее вывод можно использовать как образец для написания скриптов преобразования, или для переноса хранилищ в понятном человеку формате. Конечно, с помощью этих команд можно пересылать хранилища текстовых файлов через каналы передачи текста.
 127
 128 === Когда же все пошло не так? ===
 129
 130 Вы только что обнаружили, что кое-какой функционал вашей программы не работает, но вы совершенно отчетливо помните, что он работал всего несколько месяцев назад. Ох… Откуда же взялась ошибка? Вы же это проверяли сразу как разработали.
 131
 132 В любом случае, уже слишком поздно. Однако, если вы фиксировали свои изменения достаточно часто, то Git сможет точно указать проблему:
 133
 134  $ git bisect start
 135  $ git bisect bad HEAD
 136  $ git bisect good 1b6d
 137
 138 Git извлечет состояние ровно посередине. Проверьте работает ли то, что сломалось, и если все еще нет,
 139
 140  $ git bisect bad
 141
 142 Если же работает, то замените «bad» на «good». Git снова переместит вас в состояние посередине между «хорошей» и «плохой» ревизиями, сужая круг поиска. После нескольких итераций, этот двоичный поиск приведет вас к тому коммиту, на котором возникла проблема. После окончания расследования, вернитесь в исходное состояние командой
 143
 144  $ git bisect reset
 145
 146 Вместо ручного тестирования каждого изменения автоматизируйте поиск, запустив
 147
 148  $ git bisect run my_script
 149
 150 По возвращаемому значению заданной команды, обычно одноразового скрипта, Git будет отличать хорошее состояние от плохого. Скрипт должен вернуть 0, если нынешний коммит хороший; 125, если его надо пропустить; и любое другое число от 1 до 127, если он плохой. Отрицательное возвращаемое значение прерывает команду bisect.
 151
 152 Вы можете сделать многим больше: страница помощи поясняет, как визуализировать bisect, проанализировать или воспроизвести ее журнал, или исключить заведомо хорошие изменения для ускорения поиска.
 153
 154 === Из-за кого все пошло не так? ===
 155
 156 Как и во многих других системах управления версиями, в Git есть команда blame (ответственность, прим. пер.):
 157
 158  $ git blame bug.c
 159
 160 Она снабжает каждую строку выбранного файла примечаниями, раскрывающими, кто и когда последним ее редактировал. В отличие же от многих других систем управления версиями, эта операция происходит без соединения с сетью, выбирая данные с локального диска.
 161
 162 === Личный опыт ===
 163
 164 В централизованных системах управления версиями изменения истории — достаточно сложная операция, и доступна она лишь администраторам. Клонирование, ветвление и слияние невозможны без взаимодействия по сети. Так же обстоят дела и с базовыми операциями, такими как просмотр истории или фиксация изменений. В некоторых системах сетевое соединение требуется даже для просмотра собственных изменений, или открытия файла для редактирования.
 165
 166 Централизованные системы исключают возможность работы без сети и требуют более дорогой сетевой инфраструктуры, особенно с увеличением количества разработчиков. Что важнее, все операции происходят медленнее, обычно до такой степени, что пользователи избегают пользоваться «продвинутыми» командами без крайней необходимости. В радикальных случаях это касается даже большинства базовых команд. Когда пользователи вынуждены запускать медленные команды, производительность страдает из-за прерываний рабочего процесса.
 167
 168 Я испытал этот феномен на себе. Git был моей первой системой управления версиями. Я быстро привык к нему и стал относится к его возможностям как к должному. Я предполагал, что и другие системы похожи на него: выбор системы управления версиями не должен отличаться от выбора текстового редактора или браузера.
 169
 170 Когда немного позже я был вынужден использовать централизованную систему управления версиями, я был шокирован. Ненадежное интернет-соединение не имеет большого значения при использовании Git, но делает разработку невыносимой, когда от него требуют надежности как у жесткого диска. Вдобавок я обнаружил, что стал избегать некоторых команд из-за задержек в их выполнении, что помешало мне следовать предпочтительному рабочему процессу.
 171
 172 Когда мне было нужно запустить медленную команду, нарушение хода моих мыслей оказывало несоизмеримый ущерб разработке. Ожидая окончания связи с сервером, я вынужден был заниматься чем-то другим, чтобы скоротать время; например, проверкой почты или написанием документации. К тому времени, как я возвращался к первоначальной задаче, выполнение команды было давно закончено, но мне приходилось тратить уйму времени, чтоб вспомнить, что именно я делал. Люди не очень приспособлены для переключения между задачами.
 173
 174 Кроме того, есть интересный эффект «трагедии общественных ресурсов»: предвидя будущую перегруженность сети, некоторые люди в попытке предотвратить грядущие задержки начинают использовать более широкие каналы, чем им реально требуется для текущих задач. Суммарная активность увеличивает загрузку сети, поощряя людей задействовать всё более высокоскоростные каналы для предотвращения еще больших задержек.