文档Commerce云基础架构上的 Commerce 指南

恢复环境

Last update: Thu Sep 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：
  • 云

创建对象：

  • 开发人员

如果您在集成环境中遇到问题，并且没有有效的备份，或者希望将环境重置为空白板，则可以使用以下方法之一还原/重置环境：

  • 重置或还原Git分支中的代码
  • 卸载Commerce应用程序
  • 强制重新部署
  • 手动重置数据库
TIP
要获得停滞部署的帮助，请使用​_Adobe Commerce帮助中心_​中的Commerce部署疑难解答程序。

重置Git分支

重置Git分支会将代码恢复到以前的稳定状态。

重置分支：

  1. 在本地工作站上，转到您的项目目录。

  2. 查看Git提交历史记录。 使用--oneline在一行中显示缩写提交：

    code language-bash 
    git log --oneline

    示例响应：

    code language-none 
    6bf9f45 (HEAD -> master, magento/master, magento/develop, magento/HEAD, develop) Create composer.lock
34d7434 2.4.6 upgrade
b69803c Update composer.lock
c1bca24 Add sample data
ec604c3 Update magento/ece-tools
...

  3. 选择表示代码的最后一个已知稳定状态的提交哈希。

    要将分支重置为其初始初始化状态，请查找创建分支的第一个提交。 您可以使用--reverse以反向时间顺序显示历史记录。

  4. 使用硬重置选项重置分支。 使用此命令时请务必小心，因为它会丢弃自选定的提交后所做的所有更改。

    code language-bash 
    git reset --hard <commit>

  5. 推送更改以触发重新部署，从而重新安装Adobe Commerce。

    code language-bash 
    git push --force <origin> <branch>

卸载Commerce

通过还原数据库、删除部署配置并清除var/子目录，卸载Commerce应用程序可将环境返回到原始状态。 本指导还会将您的Git分支重置为以前的稳定状态。 如果您最近没有备份，但可以使用SSH访问远程环境，请按照以下步骤恢复环境：

  • 禁用配置管理
  • 卸载Adobe Commerce
  • 重置Git分支

卸载Adobe Commerce软件将删除并还原数据库，删除部署配置，并清除var/子目录。 禁用配置管理很重要，这样它就不会在下次部署期间自动应用以前的配置设置。 确保您的app/etc/目录不包含config.php文件。

要卸载Adobe Commerce软件：

  1. 在本地工作站上，转到您的项目目录。

  2. 使用SSH登录到远程环境。

    code language-bash 
    magento-cloud ssh

  3. 删除配置文件。

    • 对于Adobe Commerce 2.2及更高版本：

      code language-bash 
      rm app/etc/config.php

    • 对于Adobe Commerce 2.1：

      code language-bash 
      rm app/etc/config.local.php

  4. 卸载Adobe Commerce应用程序。

    code language-bash 
    php bin/magento setup:uninstall -n

  5. 确认Adobe Commerce已成功卸载。

    将显示以下消息以确认卸载成功：

    code language-none 
    [SUCCESS]: Magento uninstallation complete.

  6. 清除var/子目录。

    code language-bash 
    rm -rf var/*

  7. 注销。

TIP
或者，清除生成缓存是一种良好做法。
code language-bash 
magento-cloud project:clear-build-cache

强制重新部署

如果您尝试卸载Adobe Commerce但部署仍然失败，则可以尝试手动强制重新部署。

git commit --allow-empty -m "<message>" && git push <origin> <branch>

重置数据库

如果您尝试卸载Adobe Commerce，但命令失败或无法完成，则可以手动重置数据库。

要重置数据库：

  1. 在本地工作站上，转到您的项目目录。

  2. 使用SSH登录到远程环境。

    code language-bash 
    magento-cloud ssh

  3. 连接到数据库。

    code language-bash 
    mysql -h database.internal

  4. 删除main数据库。

    code language-shell 
    drop database main;

  5. 创建空的main数据库。

    code language-shell 
    create database main;

  6. 删除以下配置文件。

    • config.php
    • config.php.bak
    • env.php
    • env.php.bak

  7. 注销并触发重新部署。

    code language-bash 
    magento-cloud environment:redeploy
WARNING
当您执行合并、推送或同步环境时，或者当您触发手动重新部署（期间的Commerce应用程序处于维护模式）时，部署过程将开始。 对于生产环境，Adobe建议在非高峰时间完成此工作，以避免服务中断。
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26