1 Инструкция
Хомячок edited this page 2026-09-25 20:26:16 +05:00
This file contains ambiguous Unicode characters

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 идеальной, чистой копией оригинального проекта. Для всех своих изменений всегда создавайте отдельные фиче-ветки.

Как правильно вносить свои изменения:

  1. Переключитесь на чистый main:
    git checkout main
    
  2. Создайте свою ветку (например, my-custom-features) и перейдите в неё:
    git checkout -b my-custom-features
    
  3. Делайте изменения в коде и фиксируйте их коммитами (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...». Не пугайтесь, это нормальный рабочий процесс.

Ваш алгоритм действий:

  1. Откройте файлы, в которых Git обнаружил конфликты (они будут подсвечены в вашем редакторе кода).
  2. Выберите, какой код оставить: оригинальный, ваш, или объединить их вместе. Удалите технические маркеры конфликта (<<<<<<<, =======, >>>>>>>).
  3. После исправления файлов в терминале добавьте их в индекс:
    git add .
    
  4. Продолжите процесс ребэйза:
    git rebase --continue
    
    (Если конфликтов было много в разных коммитах, Git может остановиться снова на следующем коммите. Повторите процедуру).

🚀 4. Отправка обновленного кода в Hamy Git

После успешного завершения rebase ваша ветка содержит и весь новый код оригинала, и ваши личные изменения. Чтобы отправить её на ваш сервер, выполните:

git push origin my-custom-features --force-with-lease

💡 Важно: Флаг --force-with-lease обязателен после каждого успешного rebase. Так как ребэйз переписывает историю коммитов, обычный git push сервер отклонит. Данный флаг безопасно перезапишет ветку на сервере.