{"canonical_url":"https://engineer.company/uk/glossary/repository/","content_markdown":"# Репозиторій\n\n## Що це таке\n\nРепозиторій, у розмові найчастіше просто «репо», англійською repository, — це\nмісце, де система контролю версій тримає повний запис проєкту: кожен\nзафіксований стан кожного файлу, хто вніс кожну зміну і навіщо, а також імена,\nщо ведуть усередину цієї історії. Файли в редакторі — лише один його вигляд;\nрепозиторій — це все, що стоїть за ним.\n\nGit дає цьому слову досить точне визначення у власному глосарії: набір посилань\n(refs) разом із базою об'єктів, що містить усі об'єкти, досяжні з цих посилань.\nОбидві половини варто розгорнути. База об'єктів тримає вміст. Кожну версію\nфайлу, кожен перелік каталогу і кожен коміт записано як об'єкт, названий за\nхешем його вмісту; книга Git описує це як файлову систему з адресацією за\nвмістом, де ключ обчислюється із самого значення. Два однакові файли — це один\nоб'єкт, а будь-яка зміна, хоч яка мала, дає нове ім'я. Посилання — людський бік:\nгілки й теги, короткі імена, кожне з яких вказує на один коміт і дає людям вхід.\n\nБільшість репозиторіїв, з якими працюють люди, мають прикріплене робоче дерево.\nФайли, які відкривають у редакторі, лежать у каталозі проєкту, а сам репозиторій\nживе поруч у прихованому каталозі `.git`. Голий (bare) репозиторій робочого\nдерева не має взагалі. Назва його каталогу за домовленістю закінчується на\n`.git`, він містить тільки історію, і саме в такій формі його тримає сервер, бо\nфайли там ніхто не редагує; туди надсилають зміни і звідти їх забирають.\nГлосарій Git каже те саме: ті, хто публікує відкриті репозиторії, зазвичай\nроблять доступними саме голі. Книга Git показує, як створити такий з наявного\nпроєкту: `git clone --bare my_project my_project.git`.\n\nКлонування — місце, де задум Git видно найкраще. Клон отримує майже всі дані,\nякі має сервер: типово разом із ним надходить кожна версія кожного файлу за всю\nісторію проєкту. Тож кожен клон — повноцінний репозиторій, здатний заступити\nсервер, якщо той буде втрачено. Винятки невеликі, але важливі, і книга Git їх\nназиває: хуки на боці сервера та подібні налаштування лишаються позаду.\n\nДва різновиди трапляються часто. Неглибокий (shallow) репозиторій, створений\nклонуванням із `--depth`, тримає лише недавні коміти; глосарій каже, що старших\nбатьків у нього «cauterized away», тобто відсічено, а історію згодом можна\nпоглибити через fetch. Підмодуль — це репозиторій усередині іншого, зі своєю\nісторією, який зовнішній репозиторій прив'язує до одного конкретного коміту.\n\n## Чому це важливо\n\nРепозиторій — пам'ять проєкту. Коли рядок коду виглядає неправильно, історія\nрозповідає, коли він з'явився, у якому коміті та з яким поясненням. Користь від\nцього не більша за коміти, які пишуть люди, тому команди, яким не байдужа власна\nісторія, встановлюють правила для повідомлень комітів і застосовують їх хуками,\nа не доброю волею.\n\nЦе також одиниця, з якою працює більшість інструментів. Доступ надають на рівні\nрепозиторію, хуки виконуються в репозиторії, а безперервна інтеграція зазвичай\nстартує з одного репозиторію. Провести межу репозиторію означає провести межу\nтого, що охоплює один перегляд, одна перевірка й один дозвіл.\n\nРепозиторій тримає все, що йому дали. Коміт, який видаляє файл, додає новий\nстан; усі попередні стани лишаються на місці, у кожному клоні, що вже їх має. Ця\nтривкість — сама суть контролю версій, і вона ріже в обидва боки: стару версію\nзавжди можна повернути, як і пароль, який хтось помилково закомітив.\n\nЗрештою, репозиторій може містити значно більше, ніж код застосунку. Опис\nінфраструктури, документація та конфігурація отримують із нього те саме:\nісторію, крок перегляду і спосіб відновити відомий стан. Сервер, чиє\nналаштування лежить у репозиторії, може відбудувати людина, яка ніколи його не\nбачила.\n\n## Як це виглядає на практиці\n\n[Чотири репозиторії, збудовані за вісімнадцять місяців однією людиною](/uk/portfolio/held-4-repositories-to-one-history-standard/),\nмають один стандарт комітів: конвенційний префікс, що називає різновид зміни,\nобласть, тему, коротшу за встановлену межу, без емодзі й без рядків приписування. Хук на\nповідомлення коміту відхиляє все, що порушує цей стандарт, у кожному\nрепозиторії, що несе роботу, тож стандарт є властивістю репозиторію, а не того,\nхто комітить. Тоді історія показує, якою була робота. На зафіксованому етапі\nреалізації в липні 2026 року історія найбільшого репозиторію містила 156 комітів\nіз новими функціями, 133 із виправленнями, 128 із документацією, 81 зі службовими змінами, 26\nіз рефакторингом, 20 зі стильовими змінами, 5 з оптимізацією продуктивності та 3 з тестами. Сторінка називає й межу:\nформат перевіряють, а вміст — ні.\n\nДля власної інфраструктури компанії, розгорнутих публічних сервісів і конфігурації інших компонентів завданням було [мати опис у репозиторії, а не в голові](/uk/portfolio/servers-you-can-rebuild-from-scratch/). Зафіксована реалізація містила 12 065 рядків YAML, розподілених між 19 плейбуками й 34 ролями; ці числа описують той етап, а не поточний репозиторій. Там налаштовано автоматизацію резервного копіювання й пошти, але її введення в дію є окремим кроком. Інфраструктуру можна відтворити з репозиторію: хост належить до групи рівня, змінні якої оголошують його ролі, а хост, уже приведений до заданого стану, звітує про нуль змін. Кожна зміна займає більше часу, ніж редагування безпосередньо на сервері, а перед приведенням до заданого стану згодом додано попередній перевірочний сценарій.\n\nРепозиторій тримає й те, що потрапило в нього, поки увага була деінде.\n[Робота, зроблена для іншої компанії, проїхала разом із перебудовою репозиторію](/uk/portfolio/wrote-a-scope-rule-after-a-credential-leak/),\nа з нею чорновий журнал із чинними обліковими даними відкритим текстом, який\nлишався в дереві непоміченим усіма перевірками більшу частину історії репозиторію. Нічого з\nцього не виконувалося, і саме тому воно вижило. Відповіддю стало правило меж на\nпочатку набору інструкцій репозиторію, інфраструктура однієї компанії і тільки\nїї, а також карантин замість видалення, щоб історія лишалася читною, тоді як\nсканер секретів, перевірка сховища секретів та перевірка емодзі й далі читають файли в\nкарантині.\n\n## Де виникають проблеми\n\n- **Секрет, закомічений один раз, переживає своє видалення.** Якщо файл прибрати\n  в наступному коміті, він лишається в попередньому та в кожному клоні,\n  зробленому відтоді. Облікові дані варто вважати публічними: спершу замінити\n  їх, а тоді вирішити, чи варте переписування історії незручностей для всіх, хто\n  має копію.\n- **Надсилання (push) влучає в поточну гілку.** Push до репозиторію з робочим\n  деревом, поточна гілка якого саме оновлюється, розсинхронізував би робоче\n  дерево з історією, тому Git типово відхиляє такий push через\n  `receive.denyCurrentBranch`. Репозиторій, до якого надсилають зміни, має бути\n  голим.\n- **Неглибокий клон відповідає на питання про історію за її частиною.** Клон,\n  зроблений із `--depth`, має лише недавні коміти, тож `git log`, `git blame` і\n  будь-який скрипт, що виводить версію з останнього тегу, бачать тільки цей\n  зріз. Завданням збирання й випуску, яким потрібне минуле, слід забирати повну\n  історію.\n- **Локальний хук зупиняється на наступному клоні.** Хуки на боці клієнта лежать\n  у `.git/hooks`, і книга Git прямо каже, що клон лишає їх позаду. Політика, яку\n  застосовують лише там, закінчується того дня, коли хтось клонує наново.\n  Скрипти хуків варто тримати під контролем версій у репозиторії й спрямувати на\n  них `core.hooksPath` або застосовувати правило на боці сервера через\n  `pre-receive`.\n- **Великі двійкові файли роздувають кожен клон назавжди.** Оскільки клон несе\n  кожну версію кожного файлу, кожна замінена копія великого двійкового файлу\n  лишається в історії, і кожен новий клон завантажує їх усі.\n- **Файли, які ніщо не запускає, оминають перегляд.** Вимкнене завдання,\n  застарілий інвентар чи чорновий журнал лежать у кожному клоні, проте тести,\n  збирання й розгортання до них не торкаються. Вміст репозиторію має\n  обмежуватися тим, за що проєкт несе відповідальність, а все інше слід прибрати\n  або відкласти туди, де захисти й далі його бачать.\n\n## Що почитати далі\n\n- [gitglossary: repository](https://git-scm.com/docs/gitglossary#def_repository)\n  — власне визначення Git поруч із bare repository, worktree, shallow repository\n  і submodule.\n- [Getting a Git Repository](https://git-scm.com/book/en/v2/Git-Basics-Getting-a-Git-Repository)\n  — два способи отримати репозиторій, створити в каталозі з нуля або клонувати,\n  і що приносить клон.\n- [Git Objects](https://git-scm.com/book/en/v2/Git-Internals-Git-Objects) — як\n  база об'єктів записує вміст під хешем самого вмісту.\n- [gitrepository-layout](https://git-scm.com/docs/gitrepository-layout) — для\n  чого кожен файл і каталог усередині репозиторію.\n- [Getting Git on a Server](https://git-scm.com/book/en/v2/Git-on-the-Server-Getting-Git-on-a-Server)\n  — як перетворити наявний репозиторій на голий і відкрити до нього доступ.\n- [Git Hooks](https://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks) — хуки\n  на боці клієнта й сервера, і чому клон лишає клієнтські позаду.\n\n\u003chttps://engineer.company/uk/glossary/repository/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як репозиторій Git складається з об'єктів і посилань, чому клон несе з собою все минуле та що репозиторій пам'ятає довше, ніж хотілося б.","formats":{"gemtext":"https://engineer.company/uk/glossary/repository/index.gmi","gopher":"https://engineer.company/uk/glossary/repository/gophermap","html":"https://engineer.company/uk/glossary/repository/","json":"https://engineer.company/uk/glossary/repository/index.json","markdown":"https://engineer.company/uk/glossary/repository/index.md","pdf":"https://engineer.company/uk/glossary/repository/index.pdf"},"kind":"page","language":"uk","title":"Що таке репозиторій?","url":"https://engineer.company/uk/glossary/repository/","version":1}