Propiedades para la configuración de aplicaciones

El archivo .magento.app.yaml utiliza propiedades para administrar la compatibilidad con el entorno para la aplicación Commerce.

name

La propiedad name proporciona el nombre de aplicación utilizado en el archivo routes.yaml para definir el flujo ascendente HTTP (de forma predeterminada, mymagento:http). Por ejemplo, si el valor de name es app, debe utilizar app:http en el campo ascendente.

type y build

Las propiedades type y build proporcionan información sobre la imagen del contenedor base para generar y ejecutar el proyecto.

El idioma type admitido es PHP. Especifique la versión de PHP de la siguiente manera:

type: php:<version>

La propiedad build determina qué sucede de forma predeterminada al crear el proyecto. flavor especifica un conjunto predeterminado de tareas de generación para ejecutar. El siguiente ejemplo muestra la configuración predeterminada para type y build de magento-cloud/.magento.app.yaml:

# The toolstack used to build the application.
type: php:8.4
build:
    flavor: none

dependencies:
    php:
        composer/composer: '2.7.2'

Instalación y uso de Composer 2

La propiedad build: flavor: no se usa para Composer 2.x; por lo tanto, debe instalar Composer manualmente durante la fase de compilación. Para instalar y usar Composer 2.x en sus proyectos de Starter y Pro, debe realizar tres cambios en la configuración de .magento.app.yaml:

Use los siguientes fragmentos de configuración en su propia configuración de .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

Consulte Paquetes requeridos para obtener más información sobre Composer.

dependencies

Especifique las dependencias que la aplicación pueda necesitar durante el proceso de generación.

Adobe Commerce admite dependencias en los siguientes idiomas:

Estas dependencias son independientes de las dependencias finales de la aplicación y están disponibles en PATH, durante el proceso de compilación y en el entorno de tiempo de ejecución de la aplicación.

Puede especificar esas dependencias de la siguiente manera:

ruby:
   sass: "~3.4"
nodejs:
   grunt-cli: "~0.3"

runtime

Use para modificar la configuración de PHP en tiempo de ejecución, como habilitar extensiones. Se requieren las siguientes extensiones:

runtime:
    extensions:
        - xsl
        - newrelic
        - sodium

Consulte Configuración de PHP para obtener detalles sobre cómo habilitar extensiones.

disk

Define el tamaño del disco persistente de la aplicación en MB.

disk: 5120

El tamaño de disco mínimo recomendado es 256 MB. Si ve el error UserError: Error building the project: Disk size may not be smaller than 128MB, aumente el tamaño a 256 MB.

relationships

Define la asignación de servicios en la aplicación.

La relación name está disponible para la aplicación en la variable de entorno MAGENTO_CLOUD_RELATIONSHIPS. La relación <service-name>:<endpoint-name> se asigna a los valores de nombre y tipo definidos en el archivo .magento/services.yaml.

relationships:
    <name>: "<service-name>:<endpoint-name>"

A continuación se muestra un ejemplo de las relaciones predeterminadas:

relationships:
    database: "mysql:mysql"
    redis: "redis:redis"
    opensearch: "opensearch:opensearch"
    rabbitmq: "rabbitmq:rabbitmq"

Consulte Servicios para obtener una lista completa de los tipos de servicios y extremos admitidos actualmente.

mounts

Un objeto cuyas claves son rutas relativas a la raíz de la aplicación. El montaje es un área de escritura en el disco para archivos. A continuación se muestra una lista predeterminada de montajes configurados en el archivo magento.app.yaml con la sintaxis 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"

El formato para agregar el montaje a esta lista es el siguiente:

"/public/sites/default/files": "shared:files/files"

Puede hacer accesible el Web de montaje agregándolo al bloque de ubicaciones web.

access

La propiedad access indica un nivel mínimo de rol de usuario al que se permite el acceso SSH a los entornos. Las funciones de usuario disponibles son:

La función de usuario predeterminada es contributor, que restringe el acceso SSH de los usuarios con solo derechos de visor. Puede cambiar la función del usuario a viewer para permitir el acceso SSH a los usuarios con solo derechos de visor:

access:
    ssh: viewer