1c-bitrix-cms-update
Безопасное обновление проекта на Битрикс. Принцип: сначала анализ конфликтов и бэкап, потом применение, всегда на копии/стейдже до прода. Гейты оркестратора в силе.
Среда
- «живой Битрикс» → можно прочитать версии, проверить обновления, применить; «только файлы» → анализ конфликтов офлайн (модификации ядра, /local, версии).
Полный цикл → рецепты (../../shared/kb/recipes/update/)
- интроспекция версий (ядро + модули + приложения Marketplace) →
update/01-introspect-versions.md
- поиск доступных обновлений (SiteUpdate + Marketplace) →
update/02-find-updates.md
- анализ конфликтов и рисков (правки ядра, переопределения /local, кастом-модули, PHP/СУБД, лицензия) →
update/03-conflict-analysis.md
- применение (бэкап → ядро → модули → решения) →
update/04-apply-update.md
- пост-проверка и откат →
update/05-rollback-verify.md
- диагностика ошибок обновления / симптом → фикс (требования php.ini, неполный апдейт, коды ошибок) →
update/06-troubleshooting.md
- миграция кодировки cp1251 → UTF-8 (БД, файлы, сериализованные данные, поиск) →
update/07-utf8-migration.md
- обновление решений Marketplace / партнёрских / собственных модулей →
update/08-marketplace-solutions.md
- безопасное тест-обновление на копии («Установка для разработки», ERROR_WRONG_CODE, защита ключа) →
update/09-staging-clone-safety.md
- версионные переходы ядра (SiteUpdate, порядок ядро→модули→решения, переход между мажорами 24→25→26, лицензия/купон) →
update/10-version-transitions.md
Инструменты
../../shared/scripts/check-conventions.sh <проект> — поможет в анализе (модификации ядра, код вне /local).
- Бэкап/restore и миграции между средами — под-скилл
1c-bitrix-cms-setup.
⚠️ Главное
Обновление — потенциально разрушительная операция: обязателен свежий бэкап, прогон на копии/стейдже, проверка совместимости и лицензии (активный купон обновлений) до применения на проде.
Завершение
После обновления: сайт поднимается, check-conventions без [FAIL], ключевые сценарии работают; иначе — откат.
1---2name: 1c-bitrix-cms-update3description: Обновление сайта на «1С-Битрикс: Управление сайтом» — проверка установленных версий ядра и приложений Marketplace, поиск доступных обновлений, анализ рисков и конфликтов (модификации ядра, переопределения в /local, кастом-модули, совместимость PHP/СУБД, лицензия/купон), безопасное применение с бэкапом и откатом, диагностика ошибок обновления, миграция кодировки cp1251 → UTF-8, обновление решений Marketplace и тест-обновление на копии. Используй для проверки/планирования/применения обновлений Битрикс (не Битрикс24).4---5# 1c-bitrix-cms-update67Безопасное обновление проекта на Битрикс. Принцип: **сначала анализ конфликтов и бэкап, потом применение, всегда на копии/стейдже до прода.** Гейты оркестратора в силе.89## Среда10- «живой Битрикс» → можно прочитать версии, проверить обновления, применить; «только файлы» → анализ конфликтов офлайн (модификации ядра, /local, версии).1112## Полный цикл → рецепты (`../../shared/kb/recipes/update/`)131. интроспекция версий (ядро + модули + приложения Marketplace) → `update/01-introspect-versions.md`142. поиск доступных обновлений (SiteUpdate + Marketplace) → `update/02-find-updates.md`153. анализ конфликтов и рисков (правки ядра, переопределения /local, кастом-модули, PHP/СУБД, лицензия) → `update/03-conflict-analysis.md`164. применение (бэкап → ядро → модули → решения) → `update/04-apply-update.md`175. пост-проверка и откат → `update/05-rollback-verify.md`186. диагностика ошибок обновления / симптом → фикс (требования php.ini, неполный апдейт, коды ошибок) → `update/06-troubleshooting.md`197. миграция кодировки cp1251 → UTF-8 (БД, файлы, сериализованные данные, поиск) → `update/07-utf8-migration.md`208. обновление решений Marketplace / партнёрских / собственных модулей → `update/08-marketplace-solutions.md`219. безопасное тест-обновление на копии («Установка для разработки», ERROR_WRONG_CODE, защита ключа) → `update/09-staging-clone-safety.md`2210. версионные переходы ядра (SiteUpdate, порядок ядро→модули→решения, переход между мажорами 24→25→26, лицензия/купон) → `update/10-version-transitions.md`2324## Инструменты25- `../../shared/scripts/check-conventions.sh <проект>` — поможет в анализе (модификации ядра, код вне /local).26- Бэкап/restore и миграции между средами — под-скилл `1c-bitrix-cms-setup`.2728## ⚠️ Главное29Обновление — потенциально разрушительная операция: **обязателен свежий бэкап**, прогон на копии/стейдже, проверка совместимости и лицензии (активный купон обновлений) до применения на проде.3031## Завершение32После обновления: сайт поднимается, `check-conventions` без `[FAIL]`, ключевые сценарии работают; иначе — откат.