
- •Введение
- •Об управлении версиями
- •Локальные системы управления версиями
- •Централизованные системы управления версиями
- •Распределённые системы контроля версий
- •Краткая история Git
- •Основы Git
- •Слепки вместо патчей
- •Почти все операции — локальные
- •Git следит за целостностью данных
- •Чаще всего данные в Git только добавляются
- •Три состояния
- •Установка Git
- •Установка из исходников
- •Установка в Linux
- •Установка на Mac
- •Установка в Windows
- •Первоначальная настройка Git
- •Имя пользователя
- •Выбор редактора
- •Утилита сравнения
- •Проверка настроек
- •Как получить помощь?
- •Итоги
- •Основы Git
- •Создание репозитория Git
- •Создание репозитория в существующем каталоге
- •Клонирование существующего репозитория
- •Запись изменений в репозиторий
- •Определение состояния файлов
- •Отслеживание новых файлов
- •Индексация измененных файлов
- •Игнорирование файлов
- •Просмотр индексированных и неиндексированных изменений
- •Фиксация изменений
- •Игнорирование индексации
- •Удаление файлов
- •Перемещение файлов
- •Просмотр истории коммитов
- •Ограничение вывода команды log
- •Использование графического интерфейса для визуализации истории
- •Отмена изменений
- •Изменение последнего коммита
- •Отмена индексации файла
- •Отмена изменений файла
- •Работа с удалёнными репозиторями
- •Отображение удалённых репозиториев
- •Добавление удалённых репозиториев
- •Fetch и Pull
- •Push
- •Инспекция удалённого репозитория
- •Удаление и переименование удалённых репозиториев
- •Работа с метками
- •Просмотр меток
- •Создание меток
- •Аннотированные метки
- •Подписанные метки
- •Легковесные метки
- •Верификация меток
- •Выставление меток позже
- •Обмен метками
- •Полезные советы
- •Автоматическое дополнение
- •Псевдонимы в Git
- •Итоги
- •Ветвление в Git
- •Что такое ветка?
- •Основы ветвления и слияния
- •Основы ветвления
- •Основы слияния
- •Основы конфликтов при слиянии
- •Управление ветками
- •Приемы работы с ветками
- •Долгоживущие ветки
- •Тематические ветки
- •Удалённые ветки
- •Отправка изменений
- •Отслеживание веток
- •Удаление веток на удалённом сервере
- •Перемещение
- •Основы перемещения
- •Более интересные перемещения
- •Возможные риски перемещения
- •Итоги
- •Git на сервере
- •Протоколы
- •Локальный протокол
- •Преимущества
- •Недостатки
- •Протокол SSH
- •Достоинства
- •Недостатки
- •Git-протокол
- •Достоинства
- •Недостатки
- •Протокол HTTP/S
- •Достоинства
- •Недостатки
- •Установка Git на сервер
- •Размещение «голого» репозитория на сервере
- •Малые установки
- •SSH доступ
- •Создание открытого SSH-ключа
- •Настраиваем сервер
- •Открытый доступ
- •GitWeb
- •Gitosis
- •Gitolite
- •Установка
- •Изменение параметров установки
- •Конфигурационный файл и правила контроля доступа
- •Продвинутый контроль доступа с запрещающими правилами
- •Ограничение push-ей на основе изменённых файлов
- •Персональные ветки
- •«Шаблонные» репозитории
- •Другие функции
- •Git-демон
- •Git-хостинг
- •GitHub
- •Настройка учётной записи
- •Создание нового репозитория
- •Импорт из Subversion
- •Добавление участников
- •Ваш проект
- •Ответвления проектов
- •Заключение о GitHub
- •Итоги
- •Распределённый Git
- •Распределённые рабочие процессы
- •Централизованный рабочий процесс
- •Рабочий процесс с менеджером по интеграции
- •Рабочий процесс с диктатором и его помощниками
- •Содействие проекту
- •Рекомендации по созданию коммитов
- •Отдельная маленькая команда
- •Отдельная команда с менеджером
- •Небольшой открытый проект
- •Большой открытый проект
- •Итоги
- •Сопровождение проекта
- •Работа с тематическими ветками
- •Применение патчей, отправленных по почте
- •Применение патчей с помощью команды apply
- •Применение патчей с помощью команды am
- •Проверка удалённых веток
- •Определение вносимых изменений
- •Интегрирование чужих наработок
- •Процессы слияния
- •Рабочие процессы с крупными слияниями
- •Рабочие процессы с перемещениями и отбором лучшего
- •Отметка релизов
- •Генерация номера сборки
- •Подготовка релиза
- •Команда shortlog
- •Итоги
- •Инструменты Git
- •Выбор ревизии
- •Одиночные ревизии
- •Сокращенный SHA
- •Небольшое замечание о SHA-1
- •Ссылки на ветки
- •RefLog-сокращения
- •Ссылки на предков
- •Диапазон коммитов
- •Две точки
- •Множество вершин
- •Три точки
- •Интерактивное индексирование
- •Добавление и удаление файлов из индекса
- •Индексирование по частям
- •Прятанье
- •Прятанье своих трудов
- •Откат применения спрятанных изменений
- •Создание ветки из спрятанных изменений
- •Перезапись истории
- •Изменение последнего коммита
- •Изменение сообщений нескольких коммитов
- •Переупорядочение коммитов
- •Уплотнение коммитов
- •Разбиение коммита
- •Крайнее средство: filter-branch
- •Удаление файла изо всех коммитов
- •Сделать подкаталог новым корнем
- •Отладка с помощью Git
- •Аннотация файла
- •Бинарный поиск
- •Подмодули
- •Начало использования подмодулей
- •Клонирование проекта с подмодулями
- •Суперпроекты
- •Проблемы с подмодулями
- •Слияние поддеревьев
- •Итоги
- •Настройка Git
- •Конфигурирование Git
- •Основные настройки клиента
- •core.editor
- •commit.template
- •core.pager
- •user.signingkey
- •core.excludesfile
- •help.autocorrect
- •Цвета в Git
- •color.ui
- •color.*
- •Внешние утилиты merge и diff
- •Форматирование и пробельные символы
- •core.autocrlf
- •core.whitespace
- •Настройка сервера
- •receive.fsckObjects
- •receive.denyNonFastForwards
- •receive.denyDeletes
- •Git-атрибуты
- •Бинарные файлы
- •Определение бинарных файлов
- •Получение дельты для бинарных файлов
- •Документы MS Word
- •Текстовые файлы в формате OpenDocument
- •Изображения
- •Развёртывание ключа
- •Экспорт репозитория
- •export-ignore
- •export-subst
- •Стратегии слияния
- •Перехватчики в Git
- •Установка перехватчика
- •Перехватчики на стороне клиента
- •Перехватчики для работы с коммитами
- •Другие клиентские перехватчики
- •Перехватчики на стороне сервера
- •update
- •Пример навязывания политики с помощью Git
- •Перехватчик на стороне сервера
- •Установка особого формата сообщений коммитов
- •Настройка системы контроля доступа для пользователей
- •Перехватчики на стороне клиента
- •Итоги
- •Git и Subversion
- •Настройка
- •Приступим к работе
- •Коммит в Subversion
- •Получение новых изменений
- •Проблемы с ветвлением в Git
- •Ветвление в Subversion
- •Создание новой ветки в SVN
- •Переключение активных веток
- •Команды Subversion
- •Просмотр истории в стиле SVN
- •SVN-Аннотации
- •Игнорирование того, что игнорирует Subversion
- •Заключение по Git-Svn
- •Миграция на Git
- •Импортирование
- •Subversion
- •Perforce
- •Собственная утилита для импорта
- •Итоги
- •Git изнутри
- •Сантехника и фарфор
- •Объекты в Git
- •Объекты-деревья
- •Объекты-коммиты
- •Хранение объектов
- •Ссылки в Git
- •HEAD
- •Метки
- •Ссылки на удалённые ветки
- •Pack-файлы
- •Спецификации ссылок
- •Спецификации ссылок для команды push
- •Удаление ссылок
- •Протоколы передачи
- •Тупой протокол
- •Умный протокол
- •Загрузка данных
- •Скачивание данных
- •Обслуживание и восстановление данных
- •Обслуживание
- •Восстановление данных
- •Удаление объектов
- •Итоги
Scott Chacon Pro Git |
Раздел 4.8 Gitolite |
большей сложности, так как теперь отсутствие разрешающего правила — не единственный
способ получить запрет доступа, так что порядок правил теперь имеет значение!
Предположим, в описанной выше ситуации мы хотим, чтобы инженеры могли откатить назад любую ветку кроме master и integ. Вот как это сделать:
RW |
master integ |
= @engineers |
- |
master integ |
= @engineers |
RW+ |
|
= @engineers |
|
|
|
Снова, вы просто идёте по правилам сверху вниз, пока не наткнётесь на соответствующее вашему режиму доступа или на запрет. Неоткатывающий push в master или integ разрешается первым правилом. Откатывающий push для этих ссылок не соответствует первому правилу,
переходит ко второму и поэтому запрещается. Любой push (откатывающий или неоткатывающий)
по ссылкам, отличным от master и integ, не совпадёт с первыми двумя правилами, а третье правило его разрешает.
4.8.5 Ограничение push-ей на основе изменённых файлов
Вдобавок к ограничению веток, в которые пользователю можно отправлять изменения, вы можете также ограничить файлы, которые он может трогать. Например, возможно, Makefile (или какая-то другая программа) не предназначен для изменения кем угодно, так как многие вещи зависят от него или сломаются, если изменения не будут сделаны правильно. Вы можете сказать gitolite-у:
repo foo |
|
|
|
RW |
|
= |
@junior_devs @senior_devs |
RW |
NAME/ |
= |
@senior_devs |
- |
NAME/Makefile |
= |
@junior_devs |
RW |
NAME/ |
= |
@junior_devs |
|
|
|
|
Это мощное средство продокументировано в conf/example.conf.
4.8.6 Персональные ветки
Gitolite также имеет средство, которое называется «персональные ветки» (или даже «персональное пространство имён веток»), которое может быть весьма полезным в корпоративных средах.
Очень часто обмен кодом в мире git происходит через запросы «пожалуйста, заберите
(pull)». В корпоративных средах, однако, неаутентифицированный доступ под строгим запретом,
и рабочая станция разработчика не может выполнить аутентификацию. Так что вы вынуждены отправить (push) работу на центральный сервер и попросить кого-нибудь забрать (pull) её оттуда.
Это обычно вызывает такой же беспорядок с именами веток, что и в централизованных СУВ, плюс настройка прав доступа для этого становится ежедневной обязанностью админа.
Gitolite позволяет определить «персональный» или «рабочий» префикс пространства имён для каждого разработчика (например, refs/personal/<devname>/*); подробное описание есть в разделе «personal branches» в doc/3-faq-tips-etc.mkd.
99

Глава 4 Git на сервере |
Scott Chacon Pro Git |
4.8.7 «Шаблонные» репозитории
Gitolite позволяет указывать репозитории с помощью шаблонов (на самом деле регулярных выражений perl), таких как, например, assignments/s[0-9][0-9]/a[0-9][0-9]. Это
очень мощная функция, которая включается с помощью установки $GL_WILDREPOS = 1; в rc файле. Она позволяет назначать новый режим доступа («C»), который позволяет пользователям создавать репозитории на основе подобных шаблонов, автоматически назначает владельцем пользователя, который создал репозиторий, позволяет ему раздавать R и RW права другим
пользователям и т.п. Эта функция описана в документе doc/4-wildcard-repositories.mkd.
4.8.8 Другие функции
Мы закончим это обсуждение рассмотрением подборки других функций, все они и многие другие описаны в мельчайших подробностях в документе «faqs, tips, etc» и некоторых других.
Логирование: Gitolite регистрирует все успешные действия. Если вы несколько легкомысленно раздали людям права на откатывание изменений (RW+) и кто-то снёс «master», лог-файл спасёт
вам жизнь, и вы легко и быстро найдёте потерянный SHA.
Git не в обычном PATH: Одна крайне полезная и удобная функция в gitolite — это поддержка git, установленного вне обычного $PATH (это совсем не такая редкость, как вы думаете; в
некоторых корпоративных средах или даже у некоторых хостинг-провайдеров запрещается устанавливать что-либо в систему, и всё заканчивается тем, что вы кладёте всё в свои личные каталоги). Обычно вы вынуждены каким-то образом заставить git на стороне клиента учитывать это нестандартное расположение бинарников git-а. С gitolite просто выберите «подробную» установку и задайте $GIT_PATH в «rc» файлах. Никаких изменений на стороне клиента после этого не требуется.
Уведомление о правах доступа: Другая удобная функция проявляется в момент, когда вы просто проверяете и заходите по ssh на сервер. Gitolite показывает, к каким репозиториям у вас есть доступ и какого типа доступ может быть получен. Вот пример:
hello sitaram, the gitolite version here is v1.5.4-19-ga3397d4 the gitolite config gives you the following access:
Ranu-wsd
Rentrans
RW git-notes
RW gitolite
RW gitolite-admin
Rindic_web_input
Rshreelipi_converter
Делегирование: При действительно больших установках вы можете делегировать ответственность за группы репозиториев различным людям, которые будут независимо управлять этими частями.
Это уменьшает нагрузку на главного админа и делает его не таким критичным элементом. Эта функция описана в отдельном файле в каталоге doc/.
* Поддержка Gitweb*: Gitolite имеет поддержку gitweb в нескольких аспектах. Вы можете указать, какие репозитории видны через gitweb. Вы можете назначить «владельца» и «описание» для gitweb из конфигурационного файла для gitolite. В gitweb есть механизм организации контроля доступа через аутентификацию по HTTP, и вы можете заставить его использовать
100