应用程序配置的属性
此 .magento.app.yaml 文件使用属性来管理对的环境支持 Commerce 应用程序。
路径：
"var": "shared:files/var""app/etc": "shared:files/etc""pub/media": "shared:files/media""pub/static": "shared:files/static"
服务：
database: "mysql:mysql"redis: "redis:redis"opensearch: "opensearch:opensearch"
name
此 name 属性提供中使用的应用程序名称 routes.yaml 文件定义HTTP上游(默认情况下， mymagento:http)。 例如，如果 name 是 app，您必须使用 app:http 在上游字段中。
type 和 build
此 type 和 build 属性提供有关用于构建和运行项目的基本容器图像的信息。
支持的 type 语言是PHP。 按如下方式指定PHP版本：
type: php:<version>
此 build 属性确定构建项目时默认执行的操作。 此 flavor 指定要运行的默认生成任务集。 以下示例显示了的默认配置 type 和 build 从 magento-cloud/.magento.app.yaml：
# The toolstack used to build the application.
type: php:8.3
build:
flavor: none
dependencies:
php:
composer/composer: '2.7.2'
安装和使用Composer 2
此 build: flavor: 属性不用于Composer 2.x；因此，您必须在构建阶段手动安装Composer。 要在入门和专业版项目中安装和使用Composer 2.x，您必须对进行三项更改 .magento.app.yaml 配置：
- 移除
composer作为build: flavor:并添加none. 此更改会阻止Cloud使用默认的1.x版本的Composer来运行构建任务。 - 添加
composer/composer: '^2.0'as aphp与安装Composer 2.x的依赖关系。 - 添加
composer将任务生成到build挂接以使用Composer 2.x运行构建任务。
在您自己的团队中使用以下配置片段 .magento.app.yaml 配置：
# 1. Change flavor to none.
build:
flavor: none
# 2. Add Composer ^2.0 as a php dependency.
dependencies:
php:
composer/composer: '^2.0'
# 3. Add a build hook to run the build tasks using Composer 2.x.
hooks:
build: |
set -e
composer --no-ansi --no-interaction install --no-progress --prefer-dist --optimize-autoloader
请参阅 必需的包 以了解有关Composer的详细信息。
dependencies
指定应用程序在构建过程中可能需要的依赖关系。
Adobe Commerce支持对以下语言的依赖性：
- PHP
- Ruby
- Node.js
这些依赖项与应用程序的最终依赖项无关，并且可在 PATH，在构建过程和应用程序的运行时环境中。
您可以按如下方式指定这些从属关系：
ruby:
sass: "~3.4"
nodejs:
grunt-cli: "~0.3"
runtime
用于在运行时修改PHP配置，如启用扩展。 需要以下扩展：
runtime:
extensions:
- xsl
- newrelic
- sodium
请参阅 PHP设置 以了解有关启用扩展的详细信息。
disk
定义应用程序的永久磁盘大小（以MB为单位）。
disk: 5120
建议的最小磁盘大小为256 MB。 如果您看到此错误 UserError: Error building the project: Disk size may not be smaller than 128MB，将大小增加到256 MB。
mounts 和 disk 应用程序的配置。 在提交票证时，请指明所需的配置更改并包括的更新版本 .magento.app.yaml 文件。relationships
定义应用程序中的服务映射。
关系 name 应用程序可在以下位置使用： MAGENTO_CLOUD_RELATIONSHIPS 环境变量。 此 <service-name>:<endpoint-name> 关系映射到 .magento/services.yaml 文件。
relationships:
<name>: "<service-name>:<endpoint-name>"
以下是默认关系的示例：
relationships:
database: "mysql:mysql"
redis: "redis:redis"
opensearch: "opensearch:opensearch"
rabbitmq: "rabbitmq:rabbitmq"
请参阅 服务 以获取当前支持的服务类型和端点的完整列表。
mounts
其键是相对于应用程序根目录的路径的对象。 装载是磁盘上文件的可写区域。 以下是在中配置的默认装载列表 magento.app.yaml 文件使用 volume_id[/subpath] 语法：
# The mounts that will be performed when the package is deployed.
mounts:
"var": "shared:files/var"
"app/etc": "shared:files/etc"
"pub/media": "shared:files/media"
"pub/static": "shared:files/static"
将装载添加到此列表的格式如下：
"/public/sites/default/files": "shared:files/files"
shared— 在环境中的应用程序之间共享卷。disk— 定义共享卷的可用大小。
mounts 和 disk 应用程序的配置。 在提交票证时，请指明所需的配置更改并包括的更新版本 .magento.app.yaml 文件。通过将装载Web添加到 web 位置块。
subpath 装载名称的一部分。 此值是的唯一标识符 files 区域。 如果更改此名称，则将丢失存储在旧位置的所有站点数据。access
此 access 属性指明允许对环境进行SSH访问的最低用户角色级别。 可用的用户角色包括：
admin— 可以在环境中更改设置并执行操作；具有 参与者 和 查看者 权限。contributor— 可以将代码推送到此环境并从环境分支；具有 查看者 权限。viewer— 只能查看环境。
默认用户角色为 contributor，以限制来自仅具有下列权限的用户的SSH访问： 查看者 权限。 您可以将用户角色更改为 viewer 仅允许具有的用户进行SSH访问 查看者 权限：
access:
ssh: viewer