S.Gromov
1a14df9366
- добавлены каноны и VitePress-сайт стратегии обновления шаблонов - подключена карточка документации на главной странице - добавлены сборочные скрипты, Caddy-маршрут и Docker-сборка - добавлена git-иконка для карточки и сгенерированы публичные артефакты
112 lines
3.2 KiB
Markdown
112 lines
3.2 KiB
Markdown
---
|
||
title: Обычное обновление шаблона
|
||
description: Повторяемый процесс доставки изменений шаблона в приложение после первичной настройки.
|
||
---
|
||
|
||
# Обычное обновление шаблона
|
||
|
||
Эта инструкция подходит после любого стартового сценария:
|
||
|
||
- [Новый проект от шаблона](../setup/clean-repository.md).
|
||
- [Миграция существующего master](../setup/existing-master-migration.md).
|
||
|
||
Целевой маршрут:
|
||
|
||
```text
|
||
templates/master -> template -> sync/* -> master
|
||
```
|
||
|
||
## 1. Обновить слепок шаблона
|
||
|
||
В репозитории приложения:
|
||
|
||
```bash
|
||
cd /path/to/app-repo
|
||
git switch template
|
||
git pull --ff-only
|
||
git push
|
||
```
|
||
|
||
Этот вариант работает, если для ветки `template` настроено:
|
||
|
||
```text
|
||
pull из templates/master
|
||
push в origin/template
|
||
```
|
||
|
||
Явная форма без зависимости от tracking-настроек:
|
||
|
||
```bash
|
||
git fetch templates
|
||
git switch template
|
||
git merge --ff-only templates/master
|
||
git push origin template
|
||
```
|
||
|
||
Если `--ff-only` падает, значит `template` перестал быть чистым слепком шаблона. Остановитесь и разберите причину до продолжения.
|
||
|
||
Проверьте, что `origin/template` обновился до шаблона:
|
||
|
||
```bash
|
||
git fetch origin
|
||
git fetch templates
|
||
git --no-pager log --oneline -1 origin/template
|
||
git --no-pager log --oneline -1 templates/master
|
||
```
|
||
|
||
Оба коммита должны совпадать.
|
||
|
||
## 2. Создать ветку обновления приложения
|
||
|
||
После обновления `template` создайте временную ветку от текущего приложения:
|
||
|
||
```bash
|
||
git fetch origin
|
||
git switch -c sync/update-template-v2 origin/master
|
||
git merge origin/template
|
||
```
|
||
|
||
Имя ветки можно менять под версию или дату:
|
||
|
||
```text
|
||
sync/update-template-v2
|
||
sync/update-template-2026-05-09
|
||
sync/update-template-1.8.0
|
||
```
|
||
|
||
Проверьте, что временная ветка реально отличается от `origin/master` изменениями шаблона:
|
||
|
||
```bash
|
||
git --no-pager diff --stat origin/master...HEAD
|
||
```
|
||
|
||
Если diff пустой, значит обновлённый `origin/template` не был влит в `sync/*` ветку или в шаблоне нет новых изменений.
|
||
|
||
## 3. Решить конфликты
|
||
|
||
Если есть конфликты, решайте их именно в `sync/*`.
|
||
|
||
После решения конфликтов:
|
||
|
||
```bash
|
||
git add .
|
||
git commit
|
||
```
|
||
|
||
Если конфликтов не было, Git сам создаст merge-коммит или выполнит fast-forward, в зависимости от истории.
|
||
|
||
## 4. Запушить sync-ветку
|
||
|
||
```bash
|
||
git push -u origin sync/update-template-v2
|
||
```
|
||
|
||
Дальше откройте PR/MR:
|
||
|
||
```text
|
||
source: sync/update-template-v2
|
||
target: master
|
||
```
|
||
|
||
Правила merge описаны в [Review и merge](./review-and-merge.md).
|