项目结构

云基础架构项目上的Adobe Commerce包括凭据和应用程序配置的基本文件。 根据Adobe Commerce版本,这些文件在中作为模板提供。 在magento/magento-cloud GitHub存储库中查看基于Adobe Commerce版本的云模板。

下表介绍了云项目中包含的文件:

文件
描述
/.magento/routes.yaml
www重定向到Apex域和php应用程序以提供HTTP的配置文件。 请参阅配置路由
/.magento/services.yaml
定义MySQL实例(MariaDB)、Redis和OpenSearch或Elasticsearch的配置文件。 请参阅配置服务
/app
code文件夹用于自定义模块。 design文件夹用于自定义主题etc文件夹包含应用程序的配置文件。
/m2-hotfixes
用于自定义修补程序。
/update
支持模块使用的服务文件夹。
.gitignore
指定要忽略的文件和目录。 请参阅.gitignore引用
.magento.app.yaml
定义用于构建应用程序的属性的配置文件。 请参阅配置应用程序
.magento.env.yaml
生成、部署和部署后阶段的配置文件。 ece-tools包包含此文件的示例。 请参阅配置环境
composer.json
获取Adobe Commerce和配置脚本以准备您的应用程序。 请参阅必需包
composer.lock
存储每个包的版本依赖关系。 请参阅必需包
magento-vars.php
用于定义多个商店和使用变量的网站。
NOTE
将本地更改推送到远程服务器时,部署脚本将使用.magento目录中的配置文件定义的值,然后脚本将删除该目录及其内容。 您的本地开发环境不受影响。

应用程序根目录

应用程序根目录的位置取决于环境。

  • 入门和专业集成/app
  • 入门级产品/<project-ID>
  • 专业暂存/<project-ID>_stg
  • 专业生产/<project-ID>

可写目录

远程集成、暂存和生产环境是只读的。 出于安全原因,以下目录是​ only ​可写目录:

  • var
  • pub/static
  • pub/media
  • app/etc
  • /tmp
NOTE
在生产环境和暂存环境中,三节点群集中的每个节点都有一个/tmp目录,该目录不与其他节点共享。

忽略文件

云基础架构项目存储库上存在具有Adobe Commerce的基本.gitignore文件。 在magento-cloud存储库🔗中查看最新的.gitignore文件。 要添加位于.gitignore列表中的文件,您可以在暂存提交时使用-f (强制)选项:

git add <path/filename> -f

更改基本模板

您可以使用以下步骤更改现有项目的结构,以反映云基础架构上Adobe Commerce的最新基础模板。

  1. 将项目克隆到本地工作站。

  2. 使用extra部分的以下值更新composer.json文件。

    code language-json
    "extra": {
        "magento-force": true
        "magento-deploystrategy": "copy"
    }
    
  3. 添加为基本模板设计的.gitignore文件。 例如,如果您需要版本2.2.6模板的.gitignore文件,请使用2.2.6🔗的.gitignore文件作为引用。

  4. 清除Git缓存。

    code language-bash
    git rm -r --cached .
    
  5. 添加和提交更改。

    code language-bash
    git add -A && git commit -m "Update base template"
    
WARNING
当您执行合并、推送或同步环境时,或者当您触发手动重新部署(期间的Commerce应用程序处于维护模式)时,部署过程将开始。 对于生产环境,Adobe建议在非高峰时间完成此工作,以避免服务中断。
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26