SuperAPI AI 工具集

1c-bitrix-cms-update

部署与运维

查看项目

更新于 10-16 10:44

技能介绍

用途

1c-bitrix-cms-update 用于「1С-Битрикс: Управление сайтом」站点的安全更新。其核心原则是:先分析冲突并完成备份,再执行更新;始终先在副本或预发布环境验证,之后才应用到生产环境。编排器门禁仍然有效。

主要能力

该技能提供完整更新周期的步骤指引,包括:

  • 版本内省:核心、模块以及 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

使用方式

该技能根据环境提供不同操作路径:

  • 实时 Bitrix 环境:可以读取版本、检查更新并应用更新。
  • 仅文件环境:可离线分析冲突,包括核心修改、/local、版本信息。

相关工具与配套能力:

  • ../../shared/scripts/check-conventions.sh <项目> 可用于分析,包括核心修改和 /local 之外的代码。
  • 备份、恢复以及环境间迁移属于子技能 1c-bitrix-cms-setup。

适用场景

适用于需要对 1С-Битрикс 站点进行核心、模块与 Marketplace 应用更新的场景,尤其在需要评估更新风险、检查核心修改与覆盖、诊断更新错误、迁移编码、更新 Marketplace 解决方案或进行主版本迁移时。也适用于在副本或预发布环境上做安全测试更新,验证后再推送到生产。

限制与注意事项

更新是潜在具有破坏性的操作。应用更新到生产前,必须完成:最新备份、在副本或预发布环境试运行、兼容性与许可证检查(有效的更新优惠券)。

完成标准:更新后站点能够启动,check-conventions 不出现 [FAIL],关键场景可正常工作;否则执行回滚。

其他限制:原始资料未提供具体收费、价格、平台支持范围或效果保证。