10.7 Git зсередини - Обслуговування репозиторію та відновлення даних
Зрідка вам потрібно робити "прибирання" - зробити репозиторій компактнішим, очистити імпортований репозиторій від зайвих файлів або відновити втрачені дані. Цей розділ містить деякі з цих сценаріїв.
Обслуговування репозиторію
Іноді Git виконує автоматичне складання сміття. Найчастіше ця команда нічого не робить. Однак, якщо у вас накопичилося занадто багато "пухких" об'єктів (не в pack-файлах), або, навпаки, окремих pack-файлів, Git запускає повноцінний збирач - git gc (тут "gc" це скорочення від "garbage collect", що означає «складання сміття»). Ця команда виконує кілька дій: збирає всі «пухкі» об'єкти та пакує їх у pack-файли; поєднує кілька упакованих файлів в один великий; видаляє недосяжні об'єкти, що зберігаються довше кількох місяців.
Складання сміття можна запустити вручну таким чином:
Знову ж таки, як правило, ця команда нічого не робить. Потрібно мати приблизно 7000 стиснених об'єктів або більше 50 pack-файлів, щоб запустився справжній gc. Ці значення можна змінити за допомогою параметрів gc.auto та gc.autopacklimit відповідно.
Ще одна дія, що виконується gc - Упаковка посилань в єдиний файл. Припустимо, репозиторій містить такі гілки та теги:
$ find .git/refs -type f .git/refs/heads/experiment .git/refs/heads/master .git/refs/tags/v1.0 .git/refs/tags/v1.1
Якщо виконати git gc, ці файли будуть видалені з каталогу refs. Git перенесе їх у файл .git/packed-refs для ефективності:
$ cat .git/packed-refs # pack-refs with: peeled fully-peeled cac0cab538b970a37ea1e769cbbde608743bc96d refs/heads/experiment ab1afef80fac8e34258ff41fc1b cac0cab538b970a37ea1e769cbbde608743bc96d refs/tags/v1.0 9585191f37f7b0fb9444f35a9bf50de191beadc2 refs/tags/v1.1 ^1a410efbd13591db07496601ebc7a059dd55cfe9
При оновленні посилання Git не редагуватиме цей файл, а додасть новий файл до refs/heads . Для отримання хешу, що відповідає потрібному посиланню, Git спочатку перевірить наявність файлу посилання в каталозі refs , а файл packed-refs звернеться тільки у разі відсутності оного. Так що, якщо ви не можете знайти посилання в каталозі refs, швидше за все воно упаковане у файлі packed-refs.
Зверніть увагу, що останній рядок файлу починається з ^ . Це означає, що попередній рядок є анотованим тегом, а поточний рядок є комітом, на який вказує анотований тег.
Відновлення даних
У якийсь момент під час роботи з Git ви можете ненароком втратити комміт. Як правило, таке трапляється, коли ви видаляєте гілку, в якій знаходилися деякі напрацювання, а потім виявляється, що вони таки були потрібними; або ви виконали git reset --hard, тим самим відмовившись від коммітів, які потім знадобилися. Як же у такому разі повернути свої комміти назад?
Нижче наведено приклад, у якому ми скидаємо гілку master із втратою даних до раннього стану, а потім відновлюємо втрачені комміти. Для початку, давайте подивимося, як зараз виглядає історія змін:
$git log --pretty=oneline ab1afef80fac8e34258ff41fc1b867c702daa24b Modify repo.rb a bit 1a410efbd13591db07496601ebc7a059dd55cfe9 Third commit cac0cab538b970a37ea1e769cbbde608743bc96d Second commit fdf4fc3344e67ab068f836878b6c4951e3b15f3d First commit
Тепер скинемо гілку master на третій коміт:
$ git reset --hard 1a410efbd13591db07496601ebc7a059dd55cfe9 HEAD is now at 1a410ef Third commit $ git log --pretty=oneline 1a410efbd13591db07496 commit cac0cab538b970a37ea1e769cbbde608743bc96d Second commit fdf4fc3344e67ab068f836878b6c4951e3b15f3d First commit
Отже, тепер два останні коміти по-справжньому втрачені — вони не досяжні з жодної гілки.Необхідно знайти SHA-1 хеш останнього комміта і створити гілку, що вказує на нього.
Найчастіше найшвидший спосіб — використання команди git reflog . Справа в тому, що під час вашої роботи Git записує всі зміни HEAD. до речі, хороша причина використовувати саме цю команду, а не вручну записувати SHA-1 ref-файли, як було показано в Посилання в Git.
$ git reflog 1a410ef HEAD@: reset: moving to 1a410ef ab1afef HEAD@: commit: Modify repo.rb a bit 484a592 HEAD@: commit:
Тут ми бачимо два комміти, на які колись вказував HEAD, однак інформації не так вже й багато.
$ git log -g commit 1a410efbd13591db07496601ebc7a059dd55cfe9 Reflog: HEAD@ (Scott Chacon) ab1afef80fac8e34258ff41fc1b867c702daa24b Reflog: HEAD@ (Scott Chacon ) Reflog повідомлень: updating HEAD Автор: Скотт Chacon Date: Fri May 22 18:15:24 2009 -0700
Схоже, що останній комміт - це і є той, який ми втратили, його можна відновити, створивши нову гілку, що вказує на нього.
$ git branch recover-branch ab1afef $ git log --pretty=oneline recover-branch ab1afef80fac8e34258ff41fc1b867c702daa24b 484a59275031909e19aadb7c92262719cfcdf19a Create repo.rb 1a410efbd13591db07496601ebc7a059dd55cfe9 Third commit cac0cab538b970a37ea1e769cbbde608743bc96d Second commit fdf4fc3344e67ab068f836878b6c4951e3b15f3d First commit
Відмінно - тепер у нас є гілка recover-branch, що вказує туди, куди раніше вказувала гілка master, тим самим роблячи втрачені комміти знову доступними. Тепер припустимо, що втрачені зміни відсутні в reflog — для симуляції такого стану видалимо відновлену гілку та очистимо reflog.
$ git branch -D recover-branch $ rm -Rf .git/logs/
У цьому випадку два перші коміти недоступні звідки. Оскільки дані reflog зберігаються в каталозі .git/logs/ , яку ми щойно видалили, тепер у нас немає reflog. Як відновити комміти? Один із варіантів — використання утиліти git fsck, яка перевіряє внутрішню базу даних на цілісність. Якщо виконати її з ключем --full , буде показано всі об'єкти, недосяжні з інших об'єктів:
$ git fsck --full Checking object directories: 100% (256/256), done. Checking objects: 100% (18/18), done. dangling blob d670460b4b4aece5915caf5c68d12f560a9fe3e4 dangling commit ab1afef80fac8e34258ff41fc1b867c702daa24b dangling tree aea790b9a58f6cf6f2804eeac9f0abbe9631e4c9 dangling blob 7108f7ecb345ee9d0084193f147cdad4d2998293
У нашому випадку втрачений коміт вказано після слів «dangling commit» («висячий коміт»). Його можна відновити аналогічним чином, створивши нову гілку, що вказує на цей SHA-1.
Видалення об'єктів
Git - чудовий інструмент з купою класних можливостей, але деякі з них можуть стати джерелом проблем; наприклад, команда git clone завантажує проект разом із усією історією, включаючи всі версії всіх файлів.Це нормально, якщо в репозиторії зберігається лише вихідний код, оскільки Git добре оптимізований під такий тип даних і може ефективно їх стискати. Однак, якщо будь-коли проект був доданий великий файл, кожен, хто потім захоче клонувати проект, буде змушений завантажувати цей файл, навіть якщо він був видалений в наступному коміті. Він буде в базі завжди просто тому, що він доступний в історії.
Це може стати великою проблемою при конвертації Subversion або Perforce репозиторіїв у Git. У цих системах вам не потрібно завантажувати всю історію, тому додавання великих файлів не має особливих наслідків. Якщо при імпорті з іншої системи або за будь-яких інших обставин стало ясно, що ваш репозиторій набагато більше, ніж він має бути, то якраз зараз ми розповімо, як можна знайти та видалити великі об'єкти.
Попереджаємо: подальші дії переписують історію змін. Кожен коміт, починаючи з раннього, з якого потрібно видалити великий файл, буде переписаний. Якщо зробити це безпосередньо після імпорту, поки ніхто ще не працював із репозиторієм, то все окей, інакше доведеться повідомити всіх учасників про необхідність перебазування їхніх правок щодо ваших нових коммітів.
Для прикладу додамо великий файл у тестовий репозиторій, видалимо його в наступному коміті, а потім знайдемо та видалимо його повністю з бази. Спочатку додамо великий файл до нашої історії:
$ curl https://www.kernel.org/pub/software/scm/git/git-2.1.0.tar.gz > git.tgz $ git add git.tgz $ git commit -m 'Add git tarball' [ master 7b30847] Add git tarball 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 git.tgz
Упс, ми ненароком. Нам краще позбутися цього файлу:
$ git rm git.tgz rm 'git.tgz' $ git commit -m 'Oops - remove large tarball' [master dadf725] Oops - remove large tarball 1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 git.tgz
Тепер запустимо збирач сміття та подивимося, скільки місця зараз використовується:
$ git gc Counting objects: 17, done. Delta compression using up до 8 threads. Compressing objects: 100% (13/13), done. Writing objects: 100% (17/17), done. Total 17 (delta 1), reused 10 (delta 0)
Щоб швидко дізнатися, скільки місця зайнято, можна скористатися командою count-objects:
$ git count-objects -v count: 7 size: 32 in-pack: 17 packs: 1 size-pack: 4868 prune-packable: 0 garbage: 0 size-garbage: 0
Рядок size-pack – це розмір pack-файлів у кілобайтах, тобто всього зайнято майже 5 MБ. Перед останнім коммітом використовувалося близько 2 КБ — очевидно видалення файлу не видалило його з історії. Щоразу, коли хтось захоче клонувати цей репозиторій, йому доведеться завантажувати всі 5 МБ для того, щоб отримати цей маленький проект, просто тому, що одного разу ви мали необережність додати великий файл. Давайте виправимо це!
Спочатку знайдемо проблемний файл. В даному випадку ми вже знаємо, що це за файл. Але якби не знали, як можна було визначити, які файли займають багато місця? При виклику git gc усі об'єкти упаковуються в один pack-файл, але, незважаючи на це, визначити найбільші файли можна, запустивши службову команду git verify-pack і відсортувавши її виведення по третій колонці, в якій записано розмір файлу. Так як нас цікавлять найбільші файли, залишимо три останні рядки за допомогою tail :
$ git verify-pack -v .git/objects/pack/pack-29…69.idx \ | sort-k 3-n\| tail -3 dadf7258d699da2c8d89b09ef6670edb7d5f91b4 commit 229159 12 033b4468fa6b2a9547a70d88d1bbe8bf3f9ed0d5 blob2 82c99a3e86bb1267b236a4b6eff7868d97489af1 blob 4975916 4976258 1438
Великий об'єкт унизу списку, його розмір – 5 МБ. Для того, щоб дізнатися, що це за файл, скористаємося командою rev-list , яка вже згадувалась у розділі Перевірка формату повідомлення комміта глави 8. Якщо передати їй ключ --objects , вона видасть хеші всіх коммітів, а також хеші об'єктів та відповідні їм імена файлів.Скористайтеся цим для визначення імені обраного об'єкта:
$ git rev-list --objects --all | grep 82c99a3 82c99a3e86bb1267b236a4b6eff7868d97489af1 git.tgz
Тепер потрібно видалити файл з усіх дерев у минулому. Легко отримати всі комміти, які змінювали цей файл:
$ git log --oneline --branches -- git.tgz dadf725 Oops - remove large tarball 7b30847 Add git tarball
Для повного видалення цього файлу з історії необхідно переписати всі комміти, починаючи з 7b30847. Скористайтеся командою filter-branch, про яку ми писали в розділі Перезапис історії розділу 7:
$ git filter-branch --index-filter \ 'git rm --ignore-unmatch --cached git.tgz' -- 7b30847^.. Rewrite 7b30847d080183a1ab7d18fb202473b3096e9f34 dadf7258d699da2c8d89b09ef6670edb7d5f91b4 (2/2) Ref 'refs/heads/master' was rewritten
Опція --index-filter схожа на --tree-filter , що використовується в розділі Перезапис історії глави 7, за винятком того, що замість передачі команди, що модифікує файли на диску, ми використовуємо команду, яка змінює файли в індексі.
Замість видалення файлу чимось на зразок rm file ми використовуємо git rm --cached , так як нам треба видалити файл з індексу, а не з диска. Причина, через яку ми робимо саме так — швидкість: немає необхідності витягувати кожну ревізію на диск, щоб застосувати фільтр, а це може дуже прискорити процес. Якщо хочете, можете використати і tree-filter для отримання аналогічного результату. Опція --ignore-unmatch команди git rm відключає виведення повідомлення про помилку у разі відсутності файлів, які відповідають шаблону. Ще один момент: ми вказали команді filter-branch переписувати історію, починаючи з комміту 7b30847, тому що ми знаємо, що саме в ньому вперше виникла проблема. За замовчуванням перезапис починається з найпершого комміту, що вимагало б набагато більше часу.
Тепер історія не містить посилань на цей файл.Однак, у reflog і в новому наборі посилань, доданому Git в .git/refs/original після виконання filter-branch, посилання на нього все ще присутні, тому необхідно видалити їх, а потім переупакувати базу. Необхідно позбутися всіх можливих посилань на старі коміти перед перепакуванням:
$ rm -Rf .git/refs/original $ rm -Rf .git/logs/ $ git gc Counting objects: 15, done. Delta compression using up до 8 threads. Compressing objects: 100% (11/11), done. Writing objects: 100% (15/15), done. Total 15 (delta 1), reused 12 (delta 0)
Перевіримо, скільки місця вдалося звільнити:
$ git count-objects -v count: 11 size: 4904 in-pack: 15 packs: 1 size-pack: 8 prune-packable: 0 garbage: 0 size-garbage: 0
Розмір упакованого репозиторію скоротився до 8 КБ, що набагато краще ніж 5 МБ. Зі значення поля size видно, що великий об'єкт все ще зберігається в одному з ваших «пухких» об'єктів, але, що найголовніше, за будь-якої подальшої відправки даних назовні (а значить і при наступних клонуваннях репозиторію) він передаватися не буде. Якщо дуже хочеться, можна видалити його назавжди локально, виконавши git prune --expire:
$ git prune --expire now $ git count-objects -v count: 0 size: 0 in-pack: 15 packs: 1 size-pack: 8 prune-packable: 0 garbage: 0 size-garbage: 0
git revert
Можна сказати, що команда git revert є типовою командою скасування. Однак принцип її дії відрізняється від звичного скасування змін. Замість видалення комміту з історії проекту ця команда скасовує внесені зміни та додає новий коміт з отриманим вмістом. В результаті історія в Git не втрачається, що важливо для забезпечення цілісної історії версій та надійної спільної роботи.
Скасування за допомогою команди revert необхідне, коли потрібно звернути зміни, внесені в якомусь коментарі з історії проекту. Це може бути корисним, якщо баг з'явився в проекті через конкретний комміт.Вам не потрібно вручну переходити до цього комміту, виправляти його та виконувати коміт нового знімка стану – команда git revert зробить це автоматично.
Порядок дій
Команда git revert використовується для відкату змін історії коммітів репозиторію. Інші команди скасування, такі як git checkout та git reset, переміщують покажчик HEAD та покажчики гілки на певний коміт. Команда git revert також працює з певним коммітом, проте використання git revert не переміщує покажчики. Під час операції revert відбувається перехід до зазначеного комміту, звертаються його зміни та створюється новий, «зворотний» коміт. Потім позиція покажчиків оновлюється - вони переміщаються до цього коміту наприкінці гілки.
Для наочності створимо тестовий репозиторій та напишемо у командному рядку наступне:
$ mkdir git_revert_test
$ cd git_revert_test/
$ git init.
Initialized empty Git repository in /git_revert_test/.git/
$ touch demo_file
$ git add demo_file
$ git commit -am"initial commit"
[main (root-commit) 299b15f] initial commit
1 file changed, 0 insertions(+), 0 deletions(-)
create mode 100644 demo_file
$echo "initial content" >> demo_file
$ git commit -am"add новий вміст до demo file"
[main 3602d88] add новий вміст до демо файлу
n 1 file changed, 1 insertion(+)
$ echo "знижка line content" >> demo_file
$ git commit -am"prepend content to demo file"
[main 86bb32e] prepend content to demo file
1 file changed, 1 insertion(+)
$ git log --oneline
86bb32e prepend content to demo file
3602d88 add новий вміст до demo file
299b15f initial commit