DocumentaciónCommerceGuía de Commerce en la infraestructura en la nube

Estructura del proyecto

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Administrador
  • Desarrollador

Un proyecto de Adobe Commerce en la nube incluye archivos esenciales para las credenciales y la configuración de la aplicación. Estos archivos están disponibles en como plantilla según la versión de Adobe Commerce. Consulte las plantillas de nube basadas en la versión de Adobe Commerce en el magento/magento-cloud repositorio de GitHub.

En la tabla siguiente se describen los archivos incluidos en un proyecto de la nube:

Archivo
Descripción
/.magento/routes.yaml
Archivo de configuración que redirige a www al dominio Apex y a la aplicación php para servir HTTP. Consulte Configurar rutas.
/.magento/services.yaml
Archivo de configuración que define una instancia de MySQL (MariaDB), Redis y OpenSearch o un Elasticsearch. Consulte Configurar servicios.
/app
La carpeta code se usa para módulos personalizados. La carpeta design se usa para temáticas personalizadas. La carpeta etc contiene archivos de configuración para la aplicación.
/m2-hotfixes
Se utiliza para parches personalizados.
/update
Carpeta de servicio utilizada por el módulo de soporte técnico.
.gitignore
Especifique los archivos y directorios que desea omitir. Ver .gitignore referencia.
.magento.app.yaml
Archivo de configuración que define las propiedades para generar la aplicación. Consulte Configurar aplicación.
.magento.env.yaml
Archivo de configuración para las fases de compilación, implementación y posterior implementación. El paquete ece-tools incluye una muestra de este archivo. Consulte Configurar entornos.
composer.json
Obtiene Adobe Commerce y los scripts de configuración para preparar la aplicación. Consulte Paquetes requeridos.
composer.lock
Almacena las dependencias de versión de cada paquete. Consulte Paquetes requeridos.
magento-vars.php
Se usa para definir varias tiendas y sitios que usan variables.
NOTE
Cuando inserta los cambios locales en el servidor remoto, el script de implementación utiliza los valores definidos por los archivos de configuración en el directorio .magento y, a continuación, el script elimina el directorio y su contenido. Su entorno de desarrollo local no se ve afectado.

Directorio raíz de la aplicación

La ubicación del directorio raíz de la aplicación depende del entorno.

  • Integración de Starter y Pro: /app
  • Producción inicial: /<project-ID>
  • Ensayo profesional: /<project-ID>_stg
  • Producción profesional: /<project-ID>

Directorios grabables

Los entornos remotos Integration, Staging y Production son de solo lectura. Los siguientes directorios son los directorios grabables only por motivos de seguridad:

  • var
  • pub/static
  • pub/media
  • app/etc
  • /tmp
NOTE
En los entornos Producción y Ensayo, cada nodo del clúster de tres nodos tiene un directorio /tmp que no se comparte con los demás nodos.

Omitir archivos

Hay un archivo base .gitignore con el repositorio de proyectos de Adobe Commerce en la nube. Consulte el archivo .gitignore más reciente en el repositorio de la nube de Magento. Para agregar un archivo que se encuentra en la lista .gitignore, puede usar la opción -f (forzar) al almacenar en zona intermedia una confirmación:

git add <path/filename> -f

Cambiar plantilla base

Puede seguir los siguientes pasos para cambiar la estructura de un proyecto existente y reflejar la plantilla base más reciente para Adobe Commerce en la infraestructura en la nube.

  1. Clone el proyecto en una estación de trabajo local.

  2. Actualice el archivo composer.json con los siguientes valores para la sección extra.

    code language-json 
    "extra": {
    "magento-force": true
    "magento-deploystrategy": "copy"
}

  3. Agregue el archivo .gitignore diseñado para la plantilla base. Por ejemplo, si necesita el archivo .gitignore para la plantilla de la versión 2.2.6, use el archivo .gitignore para 2.2.6 como referencia.

  4. Borre la caché de Git.

    code language-bash 
    git rm -r --cached .

  5. Agregar y confirmar cambios.

    code language-bash 
    git add -A && git commit -m "Update base template"
WARNING
El proceso de implementación comienza cuando se realiza una combinación, inserción o sincronización del entorno, o cuando se déclencheur una reimplementación manual, durante la cual la aplicación Commerce se encuentra en modo de mantenimiento. Para un entorno de producción, Adobe recomienda completar este trabajo durante las horas de menor actividad para evitar interrupciones en el servicio.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26