Table of Contents
- Инструкция по синхронизации форка с оригинальным репозиторием (Upstream)
- 🛠 1. Первоначальная настройка (выполняется один раз)
- 🛑 2. Золотое правило разработки
- 🔄 3. Процесс обновления (когда в оригинале вышел новый код)
- Шаг 3.1: Обновление локальной копии оригинала
- Шаг 3.2: Синхронизация локального main
- Шаг 3.3: Накатывание ваших изменений поверх обновлений (Rebase)
- ⚠️ Что делать, если возникли конфликты?
- 🚀 4. Отправка обновленного кода в Hamy Git
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Инструкция по синхронизации форка с оригинальным репозиторием (Upstream)
Чтобы получать новые обновления из оригинального репозитория (апстрима) и при этом не терять свои локальные изменения, мы используем стратегию изолированных веток и команду git rebase.
🛠 1. Первоначальная настройка (выполняется один раз)
После того как вы скопировали проект к себе и склонировали его на компьютер, ваш локальный Git знает только про ваш сервер (origin). Нужно добавить ссылку на оригинальный репозиторий GitHub и назвать её upstream.
Откройте терминал в папке с проектом и выполните:
git remote add upstream https://github.com/veselcraft/freekate
Проверьте, что всё добавилось правильно:
git remote -v
В выводе вы должны увидеть четыре строчки: две с вашим адресом git.hamystudio.ru (origin) и две с адресом оригинального гитхаба (upstream).
🛑 2. Золотое правило разработки
Никогда не пишите свой код и не делайте коммиты в ветке
main(илиmaster)!
Оставьте ветку main идеальной, чистой копией оригинального проекта. Для всех своих изменений всегда создавайте отдельные фиче-ветки.
Как правильно вносить свои изменения:
- Переключитесь на чистый
main:git checkout main - Создайте свою ветку (например,
my-custom-features) и перейдите в неё:git checkout -b my-custom-features - Делайте изменения в коде и фиксируйте их коммитами (
git add .иgit commit -m "my logs") только внутри этой ветки.
🔄 3. Процесс обновления (когда в оригинале вышел новый код)
Когда автор оригинального репозитория выпустил обновления, и вы хотите подтянуть их в свою сборку, выполните этот цикл команд.
Шаг 3.1: Обновление локальной копии оригинала
Скачиваем все новые коммиты и ветки из апстрима:
git fetch upstream
Шаг 3.2: Синхронизация локального main
Переходим в ветку main, вливаем в неё свежие изменения из оригинала и отправляем в Hamy Git:
git checkout main
git merge upstream/main
git push origin main
Теперь ваш main на компьютере и на сервере git.hamystudio.ru полностью соответствует оригиналу на GitHub.
Шаг 3.3: Накатывание ваших изменений поверх обновлений (Rebase)
Переключитесь обратно на свою рабочую ветку и примените rebase. Эта команда временно "отложит" ваши коммиты, обновит ветку до самого свежего состояния из upstream/main, а затем по очереди применит ваши коммиты поверх нового кода:
git checkout my-custom-features
git rebase upstream/main
⚠️ Что делать, если возникли конфликты?
Если вы и автор оригинала изменили одну и ту же строчку в коде, процесс rebase остановится, и Git напишет: «CONFLICT (content): Merge conflict in...». Не пугайтесь, это нормальный рабочий процесс.
Ваш алгоритм действий:
- Откройте файлы, в которых Git обнаружил конфликты (они будут подсвечены в вашем редакторе кода).
- Выберите, какой код оставить: оригинальный, ваш, или объединить их вместе. Удалите технические маркеры конфликта (
<<<<<<<,=======,>>>>>>>). - После исправления файлов в терминале добавьте их в индекс:
git add . - Продолжите процесс ребэйза:
(Если конфликтов было много в разных коммитах, Git может остановиться снова на следующем коммите. Повторите процедуру).git rebase --continue
🚀 4. Отправка обновленного кода в Hamy Git
После успешного завершения rebase ваша ветка содержит и весь новый код оригинала, и ваши личные изменения. Чтобы отправить её на ваш сервер, выполните:
git push origin my-custom-features --force-with-lease
💡 Важно: Флаг
--force-with-leaseобязателен после каждого успешногоrebase. Так как ребэйз переписывает историю коммитов, обычныйgit pushсервер отклонит. Данный флаг безопасно перезапишет ветку на сервере.