Основные понятия СКВ
Зачем контролировать версии?
Выводы:
- Вы разрабатываете большой и длительный проект.
- Большинство работы происходит в текстовых файлах.
- Вы часто вносите изменения и, бывает, откатываетесь назад.
- Вам нужно запоминать некоторые состояния (например, гарантированно стабильно работающие, или окончательные).
- Несколько человек работает одновременно над одним проектом.
- Вы хотите проводить ревизию изменений другого участника.
- Вы или другие работаете распределенно и вам нужно облачное хранилище
- Как Timeshift в Linux.
- Вы хотите отслеживать, кто вносит какие изменения.
- Могут происходить конфликты версий
Как происходит контроль версий в ручном режиме?
Выводы:
- История прошлых версий файла/файлов.
- В простых случаях - рабочий вариант.
- Быстро становится неуправляемой.
- Если работает несколько человек - адище.
- Конфликты версий приходится разрешать в ручном режиме.
- Занимает много места.
- Нет индексации, статистики, blame, синхронизации и прочих плюшек.
Какие есть СКВ?
Выводы:
- Subversion, Mercurial, Team Foundation Server.
- Git - сегодня самая популярная.
- Была создана Линусом Торвальдсом, когда его достали человеки.
- Создана в первую очередь для программистов.
- Знать git - сегодня это обязательно для любого айтишника.
Как СКВ меняет рабочий процесс?
Выводы:
- Ничего не удаляется. Информация не потеряется.
- Нужно решить, как часто делать коммиты.
- Позволяют создавать разные варианты одного документа, т. н. ветки, с общей историей изменений до точки ветвления и с разными — после неё.
- Дают возможность узнать, кто и когда добавил или изменил конкретный набор строк в файле.
- Ведут журнал изменений, в который пользователи могут записывать пояснения о том, что и почему они изменили в данной версии.
- Контролируют права доступа пользователей, разрешая или запрещая чтение или изменение данных, в зависимости от того, кто запрашивает это действие.
Какие основные понятия СКВ?
Выводы:
- Рабочая директория - папка, в которой хранятся все файлы проекта и в которой работает СКВ.
- Отслеживание файла - файлы в рабочей директории могут быть добавлены под СКВ или нет. Это сделано для того, чтобы не отслеживать часто меняющиеся, но неважные для рабочего процесса файлы, например: объектные файлы, настройки сборщика и IDE, временные файлы, кэш и так далее.
- **Состояние **- снимок рабочей директории в определенный момент времени.
- Репозиторий - служебное хранилище СКВ, в котором хранится информация о всех зафиксированных состояниях рабочей директории. Обычно является скрытой подпапкой в рабочей директории, но не входит в нее.
- Коммит - фиксация изменений в новое состояние.
- История - упорядоченная последовательность коммитов конкретного проекта начиная от исходного.
- Удаленный репозиторий - другой репозиторий, часто расположенный на другой машине, с которым можно наладить взаимодействие (синхронизацию). Используется для организации распределенной работы над проектом.
- Клонирование - создание локальной копии удаленного репозитория. Может происходить по протоколу ssh, HTTPS или просто копи{: .align-center style=”width: 800px;”}рованием архива.
- Апстрим - обычное название репозитория, служащего исходным для текущего. Обычно обозначается origin.
Основы работы с Git
Как установить и настроить git?
Выводы:
- Для работы нужно установить клиент git. Обычно это свободные и бесплатные программы.
- Существуют консольные и графические клиенты.
- Существуют под все стандартные платформы.
- В Linux консольный клиент - чаще всего установлен в дистрибутиве по умолчанию.
- Самая распространенная программа под Windows - git-scm.
- После установки нужно произвести первоначальную настройку - ввести имя пользователя и e-mail. Это требуется только для идентификации пользователя. Это не регистрация.
Какой простейший алгоритм использования СКВ?
1
2
3
4
5
6
| cd project/
git init
git add main.py
git commit -m “Initial commit”
# . . .
git commit -m “New feature added”
|
Выводы:
- Установить и настроить клиент git
- Создать репозиторий в папке с проектом
- Добавить необходимые файлы под СКВ
- Сделать первоначальный коммит
- Сделать логически завершенный участок работы
- Сделать новый коммит с поясняющим сообщением
- Повторить сколько нужно
- Если что-то сломалось, вы всегда сможете вернуться на любое состояние.
Как Git хранит состояния?
Выводы:
- Связный список - у состояния есть родитель.
- Вычисляет патч между состоянием и его родителем.
- Работает строго построчно.
Как посмотреть историю коммитов?
Выводы:
- Команда git log выводит описание последних коммитов.
- Обратите внимание, что коммиты идентифицируются хешем. Вы можете использовать этот хэш как ссылку на коммит. Необязательно использовать весь хеш, только уникальную часть.
- при каждом коммите фиксируется дата, время, пользователь, совершивший коммит, сообщение, ссылка на родителя, хеш коммита.
Как перейти к другому состоянию?
Выводы:
- Команда git checkout приводит состояние рабочей директории в соответствие с выбранным коммитом.
- Если в это время какие-то файлы были изменены, изменения потеряются.
- Можно возвращать не всю рабочую директорию, а только определенные файлы.
- Всегда можно воспользоваться встроенной справкой по командам.
Как посмотреть изменения?
Выводы:
- Команда git diff показывает изменения каждого файла по сравнению с содержанием индекса или, при указании, с любым коммитом.
- Команда показывает, какой текст был удален, а какой - добавлен.
- Очень полезная команда для просмотра изменений.
- Эта команда работает построчно. Если строка изменена, то это будет отображаться как удаление старой версии и вставка новой.
- Существует множество графических реализаций данного функционала
Каков жизненный цикл файла в git?
Выводы:
- В Git различают три области: историю зафиксированных состояний, текущее состояние рабочей директории и индекс.
- Рабочая директория - это то, что мы видим в окне проводника. Мы работаем с файлами в ней, можем их редактировать любыми программами как обычно.
- Индекс - это набор файлов рабочей директории, которые отслеживаются СКВ. Когда мы делаем коммит, содержимое индекса записывается в историю состояний.
- Если мы создадим файл в рабочей директории, он не будет отслеживаться СКВ. Это сделано для того, чтобы не вычищать постоянно мусор из служебный файлов.
- Файл можно добавить под СКВ командой git add. в дальнейшем будем говорить только о файлах, отслеживаемых СКВ.
- Если мы изменили файл в рабочей директории, он становится модифицированным по сравнению с последним коммитом.
- Когда мы делаем коммит, мы записываем новое состояние и все файлы опять становятся неизмененными.
- Во многих графических средах состояние файла отображается цветом для удобства.
Как начать работу с репозиторием?
Выводы:
- Нативно, гит имеет командный интерфейс. Даже если вы планируете использовать только графические клиенты или IDE с интеграцией, полезно знать основные команды и их применение.
- Команда git init инициализирует пустой репозиторий в текущей папке.
- Команда git add добавляет файлы в индекс.
- Команда git commit фиксирует изменения. При этом в командной строке откроется редактор по умолчанию, чтобы вы могли записать сообщение коммита. Рекомендуется использовать форму git commit -m “Описание изменений”.
- Можно сделать коммит и добавить все новые файлы автоматически с помощью git commit -a
- Коммиту можно назначить метку для упрощения ориентации по истории.
Работа с ветвлением
Зачем нужны ветки?
Выводы:
- Ветвление происходит, когда мы произвели два разных изменения, основываясь на одном и том же состоянии.
- Часто происходит при командной работе.
- Кажется, что это что-то плохое.
- Git позволяет работать с ветками комфортно и, при необходимости, объединять их.
- Ветвление - это способ изолировать одни изменения от других. Например, разработка одной фичи независимо от хода работ над другой.
Как создать новую ветку?
Выводы:
- Ветки - это специальные указатели на коммиты, которые перемещаются с каждым новым коммитом.
- Создать новую ветку можно командой git branch <name>
- Команда git branch выводит все ветки.
- Ветка по умолчанию по соглашению называется master.
- Git хранит специальный указатель HEAD - он показывает, на какой ветке вы сейчас находитесь
- Чтобы перейти на существующую ветку, вам надо выполнить команду git checkout
- Ветка, на которую указывает HEAD, движется вперёд с каждым коммитом.
- Теперь коммиты, которые мы будем делать, будут относиться к новой ветке.
Как переключиться на другую ветку?
Выводы:
- В любой момент можно перейти в другую ветку и начать коммитить в нее.
- При переходе в другую ветку состояние рабочей директории приводится в соответствие с состоянием последнего коммита в этой ветке. Поэтому все изменения будут основываться на том состоянии.
- Переход между ветками откатывает изменения, которые вы делали в другой ветке, но не удаляет их. Все фиксированные изменения сохраняются в истории веток.
- При использовании веток история коммитов уже не будет линейной.
Как объединять ветки?
Выводы:
- Две ветки можно объединить (слить). Это значит, что мы применяем к файлам изменения, которые произошли и в одной ветке и во второй.
- Команда git merge <branch> сливает указанную ветку в текущую. Это значит, что создастся новый коммит в текущей ветке, учитывающий изменения в указанной.
- Коммиты слияния имеют двух родителей.
- Git автоматически определяет наилучшего общего предка для слияния веток.
- После слияния ветка не уничтожается и над ней можно продолжать работать.
Как разрешать конфликты слияния?
Выводы:
- Если вы изменили одну и ту же часть файла по-разному в двух ветках, которые собираетесь слить, Git не сможет сделать это чисто. Такая ситуация называется конфликтом слияния.
- В таком случае, git приостанавливает слияние до тех пор, пока вы не разрешите конфликт.
- Посмотреть, какие файлы не прошли слияние можно командой git status.
- Содержимое спорных файлов в рабочей директории будет отражать оба конфликтующих варианта текста.
- Чтобы разрешить конфликт, вы должны либо выбрать одну из этих частей, либо как-то объединить содержимое по своему усмотрению.
- После этого необходимо выполнить добавление этих файлов к индексу и коммит для завершения слияния веток.
Работа с удаленными репозиториями
Зачем нужны удаленные репозитории?
Выводы:
- При командной разработке приходится синхронизировать работу нескольких программистов в одном месте.
- Даже одному разработчику иногда приходится работать и вносить изменения в проект из разных мест.
- Для этого в системах контроля версий предусмотрена возможность связать локальный репозиторий с другим - удаленным.
- При связывании репозиториев возникает возможность отправить изменения, сделанные в локальном репозитории в удаленный и наоборот - скачать изменения из удаленного репозитория в локальный.
- Чтобы просмотреть, какие удалённые серверы у вас уже настроены, следует выполнить команду git remote. Она перечисляет список имён-сокращений для всех уже указанных удалённых дескрипторов. Если вы склонировали ваш репозиторий, у вас должен отобразиться, по крайней мере, origin — это имя по умолчанию, которое Git присваивает серверу, с которого вы склонировали.
Что такое DVCS?
Выводы:
- Распределенная модель git позволяет гибко взаимодействовать разработчикам в командном проекте.
- В централизованных системах все разработчики являются узлами сети, более или менее одинаково работающими на центральном хабе.
- Это означает, что если два разработчика склонируют репозиторий и каждый внесет изменения, то первый из них сможет отправить свои изменения в репозиторий без проблем. Второй разработчик должен слить изменения, сделанные первым разработчиком, чтобы избежать их перезаписи во время отправки на сервер.
- Однако, в Git’е каждый разработчик потенциально является и узлом, и хабом. То есть каждый разработчик может как вносить код в другие репозитории, так и содержать публичный репозиторий, на основе которого работают другие разработчики, и в который они вносят свои изменения.
Как связать текущий репозиторий с другим?
1
2
3
4
5
6
| $ git remote
origin
$ git remote add pb git://github.com/paulboone/ticgit.git
$ git remote -v
origin git://github.com/schacon/ticgit.git
pb git://github.com/paulboone/ticgit.git
|
Выводы:
- Чтобы добавить новый удалённый Git-репозиторий под именем-сокращением, к которому будет проще обращаться,** выполните git remote add [сокращение] [url]**
- Теперь вы можете использовать в командной строке имя pb вместо полного URL.
- Если вы хотите извлечь (fetch) всю информацию, которая есть в удаленном репозитории, но нет в вашем, вы можете выполнить git fetch pb.
- Ветка master удаленного репозитория теперь доступна локально как pb/master. Вы можете слить (merge) её в одну из своих веток или перейти на эту ветку, если хотите её проверить.
Как склонировать репозиторий?
Выводы:
- Для получения копии существующего Git-репозитория, например, проекта, в который вы хотите внести свой вклад, необходимо использовать команду git clone.
- Вместо того, чтобы просто получить рабочую копию, Git получает копию практически всех данных, которые есть на сервере.
- Эта команда создаёт директорию “libgit2”, инициализирует в ней поддиректорию .git, скачивает все данные для этого репозитория и создаёт (checks out) рабочую копию последней версии. Если вы зайдёте в новую директорию libgit2, то увидите в ней файлы проекта, готовые для работы или использования.
- В Git реализовано несколько транспортных протоколов, которые вы можете использовать. В предыдущем примере использовался протокол https://, вы также можете встретить git:// или user@server:path/to/repo.git, использующий протокол передачи SSH.
Как получить изменения из апстрима?
Важно отметить, что команда git fetch забирает данные в ваш локальный репозиторий, но не модифицирует то, над чем вы работаете в данный момент.
Можно использовать команду git pull чтобы автоматически получить изменения из удалённой ветви и слить их со своей текущей ветвью.
Выполнение git pull, как правило, извлекает (fetch) данные с сервера, с которого вы изначально склонировали, и автоматически пытается слить (merge) их с кодом, над которым вы в данный момент работаете.
Выводы:
- Для получения изменений используется команда
git fetch
.
- Чтобы автоматически слить изменения, используется команда
git pull
.
- Если необходимо, при выполнении
git pull
могут создаваться коммиты слияния.
Как отправить изменения в апстрим?
1
| $ git push origin master
|
Когда вы хотите поделиться своими наработками, вам необходимо отправить (push) их в главный репозиторий.
Команда для этого действия: git push [удал. сервер] [ветка].
Если вы и кто-то ещё одновременно клонируете, затем он выполняет команду push, а затем команду push выполняете вы, то ваш push точно будет отклонён.
Выводы:
- Для отправки своих изменений на сервер применяют команду
git push
.
- Эта команда не будет производить автоматических слияний.
- Если на сервере что-то изменилось, ваш
git push
будет отклонен.
- В таком случае, нужно выполнить
git pull
и затем опять git push
.
Работа с GitHub
Что это такое и зачем это нужно?
Выводы:
- Гитхаб это крупнейшее хранилище Git репозиториев, а также центр сотрудничества для миллионов разработчиков и проектов.
- Огромный процент репозиториев хранится на Гитхабе.
- Многие проекты с открытым исходным кодом используют его ради Git хостинга, баг-трекера, рецензирования кода и других вещей.
- Гитхаб даже используется для отслеживания динамики популярности языков программирования.
Как создать репозиторий?
Выводы:
- Первым делом нужно создать беcплатную учетную запись.
- В панели управления справа нажмите кнопку “New repository”.
- Всё, что в действительности нужно сделать, так это указать название проекта, все остальные поля опциональны.
- Теперь ваш проект хостится на GitHub и вы можете предоставить ссылку на него любому желающему.
- Все проекты на GitHub доступны как по HTTP https://github.com/<пользователь>/<имя_проекта>, так по SSH.
- Git производит контроль доступа на основании учётных данных пользователя, осуществляющего подключение.
Что такое форк?
Если вы хотите вносить свой вклад в уже существующие проекты, в которых у нас нет прав на внесения изменений путем отправки (push) изменений, вы можете создать свое собственное ответвление (“fork”) проекта.
Это означает, что GitHub создаст вашу собственную копию проекта, данная копия будет находиться в вашем пространстве имен и вы сможете легко делать изменения путем отправки (push) изменений.
Таким образом, проекты не обеспокоены тем, чтобы пользователи, которые хотели бы выступать в роли соавторов, имели право на внесение изменений путем их отправки (push). Люди просто могут создавать свои собственные ветвления (fork), вносить туда изменения, а затем отправлять свои внесенные изменения в оригинальный репозиторий проекта путем создания запроса на принятие изменений (Pull Request)
Для того, чтобы создать ответвление проекта (fork), зайдите на страницу проекта и нажмите кнопку “Cоздать ответвление” (“Fork”), которая расположена в правом верхнем углу.
Выводы:
- Форки нужны для внесения изменений в чужие репозитории.
- Форк - это ваша собственная копия проекта со всеми коммитами и историей.
- При создании форка автоматически проставляется ссылка на изначальный репозиторий.
- Автор репозитория может увидеть, кто его форкнул.
Что такое пулл реквест?
Выводы:
- При работе над форком чужого репозитория возникает необходимость отправить свои изменения в апстрим.
- Напрямую писать в репозиторий может только его автор или члены команды разработчика проекта, то есть его владельцы.
- Это сделано для разграничения прав доступа в репозитории.
- Поэтому, вы не сможете напрямую выполнить push в чужой репозиторий.
- Вместо этого вы отправляете pull request - запрос на внесение изменений.
- Этот запрос становится виден автору оригинального репозитория. Он может просмотреть вашу работу и затем либо принять его, либо отклонить.
- Пулл реквесты на гитхабе оформляются как публичные посты, где все участники могут оставлять свои комментарии.
Использование GitFlow
Для чего это нужно?
Выводы:
- Методология работы с git
- Стандартизировать рабочий процесс с использованием веток
- Вводит некоторые полезные и распространенные понятия
- Регламентирует правила слияния веток
- Сводит к минимуму риск выложить нестабильный код в мастер
- Хорошо использовать с непрерывной интеграцией
- Есть инструментальные решения.
Какие типы веток используются?
Выводы:
- У нас есть две основные ветки: master и develop.
- В ветке master содержится ровно тот же код, что и в рабочей (читай, продакт) версии проекта. А вся работа делается в ветке develop.
- Во время работы на основе develop создаются так называемые feature-ветки. Их может быть неограниченное количество.
- Ветка release используется для подготовки к новому релизу проекта.
- Ветка hotfix служит для срочного исправления багов, найденных, например, на продакте.
- Основа работы с гитфлоу - хранить в мастере только релизный код. Там не допускается рабочий процесс, потенциально приводящий к ошибкам.
Как происходит рабочий процесс?
Выводы:
- После создания репозитория создается ветка develop. Она является основной рабочей.
- Начинается работа на ветке develop.
- Возникает необходимость опробовать новую штуку – создается feature-ветка и делаются коммиты
- Закончив работу на feature-ветке, вы сливаете ее с develop.
- Если вы довольны текущей версией, но хотите продолжить работу, создается ветка release, куда перемещается текущая версия. Правка багов будет происходить на этой же ветке.
- Когда с веткой release покончено, время слить ее в master и продолжить работу с develop.
Как работать с веткой develop?
Выводы:
- Ветвь master создаётся при инициализации репозитория, что должно быть знакомо каждому пользователю Git.
- Параллельно ей также мы создаём ветку для разработки под названием develop.
- Мы считаем ветку origin/master главной. То есть, исходный код в ней должен находиться в состоянии production-ready в любой произвольный момент времени.
- Ветвь origin/develop мы считаем главной ветвью для разработки.
- Эту ветку также можно назвать «интеграционной».
- Когда исходный код в ветви develop готов к релизу, все изменения должны быть влиты в ветвь master и помечены тегом с номером релиза.
Как создавать фичи?
1
2
3
4
5
6
7
8
9
10
11
| $ git checkout -b myfeature develop
Switched to a new branch "myfeature"
# . . .
$ git checkout develop
Switched to branch 'develop'
$ git merge --no-ff myfeature
Updating ea1b82a..05e9557
(Отчёт об изменениях)
$ git branch -d myfeature
Deleted branch myfeature (was 05e9557).
$ git push origin develop
|
Ветви функциональностей (feature branches), также называемые иногда тематическими ветвями (topic branches), используются для разработки новых функций, которые должны появиться в текущем или будущем релизах.
Смысл существования ветви функциональности (feature branch) состоит в том, что она живёт так долго, сколько продолжается разработка данной функциональности (фичи).
Когда работа в ветви завершена, последняя вливается обратно в главную ветвь разработки или же удаляется (в случае неудачного эксперимента).
Выводы:
- Ветви feature используются для разработки новых функций, которые должны появиться в текущем или будущем релизах.
- Смысл существования ветви feature состоит в том, что она живёт так долго, сколько продолжается разработка данной фичи.
- Когда работа в ветви завершена, последняя вливается обратно в главную ветвь разработки или же удаляется.
Как происходит работа с релизами?
1
2
3
4
5
6
7
8
9
10
11
12
13
| $ git checkout -b release-1.2 develop
Switched to a new branch "release-1.2"
$ ./bump-version.sh 1.2
Files modified successfully, version bumped to 1.2.
$ git commit -a -m "Bumped version number to 1.2"
[release-1.2 74d9424] Bumped version number to 1.2
1 files changed, 1 insertions(+), 1 deletions(-)
$ git checkout master
Switched to branch 'master'
$ git merge --no-ff release-1.2
Merge made by recursive.
(Отчёт об изменениях)
$ git tag -a 1.2
|
Выводы:
- Ветви release используются для подготовки к выпуску новых версий продукта.
- Они позволяют расставить финальные точки над i перед выпуском новой версии.
- Кроме того, в них можно добавлять минорные исправления, а также подготавливать метаданные для очередного релиза .
- Очередной релиз получает свой номер версии только в тот момент, когда для него создаётся новая ветвь, но ни в коем случае не раньше.
Для чего нужны ветки hotfix?
1
2
3
4
5
6
7
8
9
10
| $ git checkout -b hotfix-1.2.1 master
Switched to a new branch "hotfix-1.2.1"
$ ./bump-version.sh 1.2.1
Files modified successfully, version bumped to 1.2.1.
$ git commit -a -m "Bumped version number to 1.2.1"
[hotfix-1.2.1 41e61bb] Bumped version number to 1.2.1
1 files changed, 1 insertions(+), 1 deletions(-)
$ git commit -m "Fixed severe production problem"
[hotfix-1.2.1 abbe5d6] Fixed severe production problem
5 files changed, 32 insertions(+), 17 deletions(-)
|
Выводы:
- Ветви hotfix создаются из главной (master) ветви.
- Они нужны для срочного внесения критичных исправлений в текущий релиз, если новый релиз еще не готов.