文档CommerceCommerce KB

Adobe Commerce部署疑难解答程序

最近更新： 2025年3月7日
  • 主题：
  • 版本
  • 部署

创建对象：

  • 开发人员

使用Deployment Troubleshooter工具可解决Adobe Commerce上的停滞部署和失败部署。 单击每个问题以显示故障诊断程序每个步骤的答案。

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

云基础架构服务上的Adobe Commerce是否已启动？

停滞的部署 — Adobe Commerce云基础架构服务是否已启动？ 检查Adobe Commerce Cloud。

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

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

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

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

magento-cloud --state=in_progress

要获取正在进行的活动列表，请使用magento-cloud CLI运行以下命令（如果已添加到多个项目）：

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

查找有关现有部署活动的信息(请参阅如果Cloud UI出现“日志截断”错误，请检查部署日志
详细信息)您可以运行此命令以获取该活动的运行日志：

magento-cloud activity:log <activity-id> [OPTIONAL: <-p project-id or project-url>]

a.是 — 对现有环境中阻止部署的其他环境进行故障排除。 继续执行步骤3。

b.否 — 对当前环境进行故障排除。 继续执行步骤3。

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

是否对所有节点成功执行<>SSH？
a.是 — 继续执行步骤4。
b.否 — 提交支持票证。

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

所有服务都在运行？
a.是 — 继续执行步骤5。
b.否 — 提交支持票证。

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

使用Bitbucket？
a.是 — 检查status.bitbucket.com。
b.否 — 检查生成和部署日志中的部署日志错误。 继续执行步骤6。

步骤6 — 检查错误代码

报告错误代码？
a.是 — 继续执行步骤7。
b.否 — 继续执行步骤8。

步骤7 - 403禁止出现错误

403禁止访问？
a.是 — 继续执行步骤16。
b.否 — 继续执行步骤9。

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

当前是否正在运行CRON作业？<>在分支上通过ssh登录并运行ps aufxx |grep cron。
a.是 — 通过ssh在受影响的分支（例如，主分支）上登录。 杀掉并解锁cron作业。 这将终止cron作业并重置状态。 运行php vendor/bin/ece-tools cron:kill，然后运行php vendor/bin/ece-tools cron:unlock。 如果您正在将一个环境合并到另一个环境，请检查这两个环境是否正在运行cron。
b.否 — 继续执行步骤17。

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

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

步骤10 — 检查足够的存储

可用存储空间还好吗？
a.是 — 继续执行步骤11。
b.否 — 查看管理磁盘空间。

步骤11 — 验证磁盘空间

无法写入<>文件警告<>？
a.是 — 请增加.magento.app.yaml中的磁盘值并重新部署。 如果此项不起作用，提交支持票证。
b.否 — 继续执行步骤12。

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

环境重新部署失败错误？
a.是 — 继续执行步骤13。
b.否 — 继续执行步骤8。

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

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

步骤14 — 检查空间限制

文件系统用完inode或空间不足？
a.是 — 请参阅管理磁盘空间。
b.否 — 继续执行步骤15。

步骤15 - Elasticsearch版本错误

有关Elasticseach版本的<>错误？
a.是 — 继续执行步骤16。
b.否 — 继续执行步骤21。

步骤16 — 验证编辑器配置

编辑器配置是否正确？
a.是 — 继续执行步骤10。
b.否 — 查看Composer疑难解答网页。

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

个长时间运行的进程？

a. YES — 确定长时间运行的进程，然后终止进程：

  1. 在终端中运行以下命令： ps aufx。
  2. 找到长时间运行的进程的PID。
  3. 使用kill -9 <PID>终止进程。

监控部署以便再次发生。

b.否 — 继续执行步骤18。

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

发布挂接失败/挂起？
a.是 — 数据库： 可用磁盘空间，损坏，表不完整/损坏。
b.否 — 继续执行步骤19。

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

使用第三方扩展？
a.是 — 尝试禁用第三方扩展并运行部署（查看它们是否是问题的原因），尤其是如果任何错误中都有扩展名。
b.否 — 继续执行步骤20。

步骤20 — 检查慢查询

长时间运行的查询？

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

a.是 — 终止任何长时间运行的查询。 查看MySQL Kill语法。
b.否 — 提交支持票证。

步骤21 — 降级Elasticsearch版本

正在降级Elasticsearch版本？
a.是 — 无法通过配置完成。 提交支持票证。
b.否 — 提交支持票证。

返回步骤1

recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a