Adobe Commerce部署疑难解答程序

描述 description

环境

云基础架构上的Adobe Commerce

问题/症状

  • 部署在环境中卡住或失败
  • 由于其他环境中正在进行的活动而阻止部署
  • 对节点的SSH访问问题
  • 服务未运行(例如,Elasticsearch、cron、与编辑器相关)
  • 磁盘空间不足或inode限制
  • 403/Elasticsearch版本/配置错误
  • 远程群集上载失败或重新部署错误
  • 长时间运行的进程、挂接后故障或第三方扩展冲突
  • 查询速度缓慢和数据库端问题(MySQL)
  • Composer配置问题或修补约束

解决方法 resolution

步骤1 — 验证服务是否正在运行

云基础架构上的Adobe Commerce是否已启动?

停滞的部署 — Adobe Commerce云基础架构服务是否已启动? 检查Adobe Commerce Cloud(在 Experience Cloud状态 页面上的Adobe下)。

  • 是 — 继续执行步骤2。
  • 否 — 维护或全球中断。 检查预计持续时间和更新。

步骤2 — 检查其他环境中的部署

其他环境中是否有部署阻止现有环境中的部署?

要获取正在进行的活动列表,请使用magento-cloud CLI运行以下命令(如果您仅添加到一个云项目)。 注意:请检查您是否使用最新版本的magento-cloud CLI。 有关步骤,请参阅Commerce on Cloud指南中的更新CLI

code language-none
magento-cloud --state=in_progress

要获取正在进行的活动的列表,请使用magento-cloud运行以下命令(如果您已被添加到多个项目):

code language-none
magento-cloud -p <project-id or project-url> --state=in_progress

要查找有关现有部署活动的信息(有关详细信息,请参阅如果Cloud UI出现“日志已提供”错误,请检查部署日志),可以运行此命令以获取该活动的运行日志。

code language-none
magento-cloud activity:log <activity-id>[ OPTIONAL: <-p project-id or project-url>]
  • 是 — 对阻止部署的其他环境进行故障排除。 继续执行步骤3。
  • 否 — 对当前环境进行故障排除。 继续执行步骤3。

步骤3 — 验证所有节点上的SSH

是否对所有节点成功执行SSH?

步骤4 — 验证所有服务是否正在运行

所有服务都在运行吗?

步骤5 — 验证Bitbucket是否正在运行

使用Bitbucket?

步骤6 — 检查错误代码

是否报告了错误代码?
  • 是 — 继续执行步骤7。
  • 否 — 继续执行步骤8。

步骤7 - 403禁止出现错误

403禁止访问?
  • 是 — 继续执行步骤16。
  • 否 — 继续执行步骤9。

步骤8 — 验证cron作业是否正在运行

cron作业当前是否正在运行?
code language-none
ps aufxx | grep cron
  • 是 — 终止和解锁cron作业:

    code language-none
    php vendor/bin/ece-tools cron:kill
    

    php vendor/bin/ece-tools cron:unlock

  • 否 — 继续执行步骤17。

步骤9 — 应用程序可部署到远程群集错误

无法将应用程序上载到远程群集错误?
  • 是 — 继续执行步骤10。
  • 否 — 继续执行步骤11。

步骤10 — 检查足够的存储

可用存储,还好吗?

步骤11 — 验证磁盘空间

无法写入文件警告?
  • 是 —

    • 对于集成/入门环境:在.magento.app.yaml中增加磁盘值并重新部署。 如果此项不起作用,提交支持票证。 或者,删除大型日志文件:
    code language-none
    ls -la var/log
    
  • 否 — 继续执行步骤12。

步骤12 — 环境重新部署失败错误

环境重新部署失败错误?
  • 是 — 继续执行步骤13。
  • 否 — 继续执行步骤8。

步骤13 — 检查Elasticsearch升级是否失败

要升级或部署的Elasticsearch?
  • 是 — Elasticsearch升级步骤失败。 请参阅Elasticsearch软件兼容性。 如果Elasticsearch升级仍然无法正常工作,请提交支持票证注意:在云基础架构上的Adobe Commerce上,请注意,如果没有48个工作小时的通知,无法将服务升级推送到生产环境。 这是必需的,因为我们需要确保有一名基础架构支持工程师在所需时间范围内更新您的配置,同时最大限度地减少生产环境的停机时间。 因此,在更改需要投入生产环境的48小时前,请提交支持工单,其中详细记录所需的服务升级,并注明希望升级过程开始的时间。
  • 否 — 继续执行步骤14。

步骤14 — 检查空间限制

文件系统是否用完inode或空间?

步骤15 - Elasticsearch版本错误

有关Elasticsearch版本错误?
  • 是 — 继续执行步骤16。
  • 否 — 继续执行步骤21。

步骤16 — 验证编辑器配置

编辑器配置是否正确?

步骤17 — 检查长时间运行的进程

长时间运行的进程?
  • 是 — 终止进程:

    1. 运行: ps aufx
    2. 找到PID
    3. 终止: kill -9 <PID>
  • 否 — 继续执行步骤18。

步骤18 — 检查开机自检挂钩故障

挂机后失败/挂起?
  • 是 — 数据库:可用磁盘空间,损坏,表不完整/损坏。
  • 否 — 继续执行步骤19。

步骤19 — 检查第三方扩展是否阻止部署

是否使用第三方扩展?

步骤20 — 检查慢查询

长时间运行查询?

检查慢查询日志和MySQL显示进程列表

步骤21 — 降级Elasticsearch版本

降级Elasticsearch版本?
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f