Контекст

Разрыв с BitKeeper ускорил создание свободного распределённого VCS.

Создать репозиторий, проверить diff и записать осмысленный атомарный commit.

Commit — снимок и объяснение

История связывает состояние проекта с намерением изменения.

Аналогия: подписанные страницы лабораторного журнала вместо папки final_final.

Три области Git

Рабочая папка, index и история — разные состояния.

Аналогия: стол с черновиками, конверт на отправку и зарегистрированное письмо.

Что хранить в репозитории

Храним исходники и рецепты восстановления среды.

Аналогия: в книге рецептов хранится инструкция, а не холодильник со всеми продуктами.

Наблюдение механизмов

git log --oneline --graph --all
git cat-file -p HEAD
git ls-tree HEAD
git diff
git diff --staged

Команды и наблюдения

Ubuntu / Bash, lab

cd ~/devops-course/lab
git init -b main
git config user.name "Student"
git config user.email "student@example.invalid"
git status
git add app.py models/model.json Dockerfile compose.yaml README.md .gitignore
git diff --staged --stat
git commit -m "feat: add reproducible StudyPulse service"
git log --oneline -3

Разбор результата

main содержит первый commit; .venv и .env отсутствуют среди отслеживаемых файлов.

Имя и email настраиваются локально для учебного репозитория; не меняем глобальные настройки ноутбука.

На macOS

Git-команды переносимы. Первый запуск git может предложить установку Apple Command Line Tools; выполните её заранее. Сохраняйте .gitignore и проверку секретов.

git --version
git status
git diff
git diff --staged
git log --oneline -3

История исправления README

1. Создайте репозиторий в своей копии lab и проверьте .gitignore.
2. Измените README: добавьте диагностику неверного порта.
3. Просмотрите diff, подготовьте только README и выполните docs: commit.
4. Измените файл после add в отдельном опыте; покажите различие diff и diff --staged.

Что должно получиться

Два осмысленных commit и пример staged/unstaged различия.

git ls-files не содержит .venv, .env или личных данных; изменения README понятны.

Ошибка для диагностики

Студент считает git add сохранением всей последующей работы.

Основные выводы

1. Содержимое index, а не автоматически все текущие правки.
2. Нет, Git — система контроля версий, GitHub — платформа вокруг репозиториев.

После пары

Оформить историю Linux-чекпоинта и передать SHA проверяемого состояния.

История Git: две линии изменения

Контекст

Ветка не создаёт отдельную полную копию проекта.

Объединить два изменения и разрешить конфликт по смыслу, сохранив историю.

Ветка — указатель на историю

Ветка не создаёт отдельную полную копию проекта.

Аналогия: отдельная линия эксперимента с точкой возврата в журнале.

Конфликт — вопрос смысла

Git не может автоматически решить противоречие в одной области.

Аналогия: два редактора меняют одну фразу; программа не знает намерения авторов.

Возврат изменений

revert создаёт обратное изменение в истории.

Аналогия: бухгалтерская корректировка добавляется новой записью, а не стиранием старой.

Команды и наблюдения

Ubuntu / Bash, lab

git switch -c docs/health
printf "Health endpoint: /healthz
" > route-note.txt
git add route-note.txt
git commit -m "docs: describe health endpoint"
git switch main
printf "Health endpoint: /readyz
" > route-note.txt
git add route-note.txt
git commit -m "docs: record alternate endpoint"
git merge docs/health
# Resolve route-note.txt using the actual API contract
git status

Разбор результата

add/add conflict в route-note.txt; правильное решение сохраняет реально существующий /healthz.

Этот конфликт создаётся в отдельном учебном файле, не ломая README и код сервиса.

На macOS

Ветки, конфликты и revert устроены одинаково. На APFS без различения регистра переименование только регистра имени требует осторожности; тестируйте checkout на Linux, если проект туда доставляется.

git switch -c docs/health
git status
git merge docs/health
git log --graph --oneline --all

Парное review

1. Создайте конфликт по демонстрации в собственной копии.
2. Сосед объясняет, какой endpoint действительно существует, используя app.py и curl.
3. Исправьте файл, git add route-note.txt и git commit завершат merge.
4. Сделайте отдельный неправильный docs: commit и отмените его через revert; проверьте log.

Что должно получиться

Разрешённый merge, revert и краткая запись review.

В файле нет маркеров; актуальный endpoint подтверждён; история сохранена.

Ошибка для диагностики

Выбрана красивая, но несуществующая версия URL.

Основные выводы

1. Нет, он требует решения неоднозначного объединения.
2. Он сохраняет след исходного изменения и его отмены.

После пары

Составить чеклист review: назначение, тест, конфигурация, секреты и обратимость.