S.Gromov
bdb99ade62
- перенесены каноны и VitePress-конфиги в projects/<slug> - добавлены корневой и проектные build.ts для сборки артефактов - добавлены shared-библиотеки сборки в projects/_shared/lib - обновлены CI, Dockerfile, package.json, gitignore и README - удалена сборка frontend-агента
145 lines
4.1 KiB
Markdown
145 lines
4.1 KiB
Markdown
---
|
||
title: Миграция существующего master
|
||
description: Как одноразово связать master приложения с историей шаблона, если проект был создан отдельно.
|
||
---
|
||
|
||
# Миграция существующего 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
|
||
```
|
||
|
||
## Когда миграцию делать не стоит
|
||
|
||
Не стоит связывать истории, если приложение только что создано и его можно безопасно пересоздать от шаблона.
|
||
|
||
Для нового проекта лучше сделать чистый старт по инструкции [Новый проект от шаблона](./clean-repository.md).
|