import{_ as a,o as i,c as t,ae as e}from"./chunks/framework.B1nRs-GM.js";const g=JSON.parse('{"title":"Миграция существующего master","description":"Как одноразово связать master приложения с историей шаблона, если проект был создан отдельно.","frontmatter":{"title":"Миграция существующего master","description":"Как одноразово связать master приложения с историей шаблона, если проект был создан отдельно."},"headers":[],"relativePath":"setup/existing-master-migration.md","filePath":"setup/existing-master-migration.md"}'),p={name:"setup/existing-master-migration.md"};function n(h,s,l,k,d,r){return i(),t("div",null,[...s[0]||(s[0]=[e(`

Миграция существующего master ​

Этот сценарий нужен, если в репозитории приложения уже есть master, но он был создан не от шаблона.

Проблема ​

Если master приложения и template имеют разные корневые коммиты, Git видит две несвязанные истории.

Плохое состояние:

text
template: T1---T2---T3

master:   A1---A2

При попытке выполнить обычный merge Git может ответить:

text
fatal: отказ слияния несвязанных историй изменений

Это означает, что у веток нет общего предка.

Цель миграции ​

Нужно один раз связать истории, чтобы дальше обновления шаблона шли обычным merge-процессом.

После миграции история будет выглядеть примерно так:

text
template: T1---T2---T3
                     \\
master:   A1---A2-----M

Где M — одноразовый merge-коммит, который связал историю приложения с историей шаблона.

Подключить репозиторий шаблона ​

В репозитории приложения:

bash
cd /path/to/app-repo
git remote add templates <template-repo-url>
git fetch templates
git fetch origin

Если remote templates уже существует:

bash
git fetch templates
git fetch origin

Создать или обновить template ​

Если ветки template ещё нет:

bash
git switch -c template templates/master
git push -u origin template

Если ветка template уже есть:

bash
git switch template
git merge --ff-only templates/master
git push origin template

Опционально настройте удобное поведение pull и push:

bash
git config branch.template.remote templates
git config branch.template.merge refs/heads/master
git config branch.template.pushRemote origin
git remote set-url --push templates DISABLED

Связать master с template ​

Создайте временную ветку от текущего приложения:

bash
git fetch origin
git switch -c sync/bootstrap-template origin/master

Слейте шаблон с разрешением несвязанных историй:

bash
git merge --allow-unrelated-histories origin/template

Если есть конфликты, решите их в ветке sync/bootstrap-template:

bash
git add .
git commit

Если конфликтов не было, Git сам создаст merge-коммит.

Запушьте ветку:

bash
git push -u origin sync/bootstrap-template

Дальше через UI или локально смержите:

text
sync/bootstrap-template -> master

Что проверить перед merge ​

Посмотрите граф истории:

bash
git --no-pager log --oneline --graph --decorate --all --max-count=50

Убедитесь, что sync/bootstrap-template содержит и историю приложения, и историю шаблона.

Посмотрите итоговый diff:

bash
git --no-pager diff origin/master...sync/bootstrap-template

Когда миграцию делать не стоит ​

Не стоит связывать истории, если приложение только что создано и его можно безопасно пересоздать от шаблона.

Для нового проекта лучше сделать чистый старт по инструкции Новый проект от шаблона.

`,48)])])}const F=a(p,[["render",n]]);export{g as __pageData,F as default};