DocumentaciónCommerceGuía de configuración

Detalles técnicos

Last update: Wed Aug 16 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Experimentado
  • Administrador
  • Desarrollador

En este tema se describen los detalles de implementación técnica de la canalización en Commerce 2.2 y versiones posteriores. Las mejoras se pueden dividir en las siguientes áreas:

En este tema también se analiza la flujo de trabajo recomendado para la implementación de canalizaciones y proporciona algunos ejemplos para ayudarle a comprender cómo funciona.

Antes de empezar, revise las Requisitos previos para los sistemas de desarrollo, compilación y producción.

Administración de configuración

Para permitirle sincronizar y mantener la configuración de sus sistemas de desarrollo y producción, utilice el siguiente esquema de anulación.

Cómo se determinan los valores de las variables de configuración

Como se muestra en el diagrama, los valores de configuración se utilizan en el siguiente orden:

  1. Las variables de entorno, si existen, anulan todos los demás valores.
  2. Desde los archivos de configuración compartidos env.php y config.php. Valores en env.php omitir valores en config.php.
  3. A partir de los valores almacenados en la base de datos.
  4. Si no existe ningún valor en ninguno de estos orígenes, se utiliza el valor predeterminado o NULL.

Administrar la configuración compartida

La configuración compartida se almacena en app/etc/config.php, que debe estar en el control de código fuente.

Establezca la configuración compartida en Admin en su infraestructura de desarrollo (o en Adobe Commerce en la nube) integración) y escriba la configuración en config.php uso del magento app:config:dump mando.

Administrar la configuración específica del sistema

La configuración específica del sistema se almacena en app/etc/env.php, que debería no estar en el control de código fuente.

Establezca la configuración específica del sistema en el Administrador del sistema de desarrollo (o Adobe Commerce en la integración de la infraestructura en la nube) y escriba la configuración en env.php uso del magento app:config:dump mando.

Este comando también escribe la configuración confidencial en env.php.

Administrar la configuración confidencial

La configuración confidencial también se almacena en app/etc/env.php.

Puede administrar la configuración confidencial de cualquiera de las siguientes maneras:

Ajustes de configuración bloqueados en el administrador

Cualquier configuración de config.php o env.php están bloqueados en el Administrador; es decir, dicha configuración no se puede cambiar en el Administrador.
Utilice el magento config:set o magento config:set --lock para cambiar la configuración en la config.php o env.php archivos.

El administrador de Commerce

El administrador muestra el siguiente comportamiento mientras está en modo de producción:

  • No puede habilitar ni deshabilitar los tipos de caché en el Administrador

  • La configuración de desarrollador no está disponible (Tiendas > Configuración > Configuración > Avanzado > Desarrollador), incluido:

    • Minimizar CSS, JavaScript y HTML

    • Combinar CSS y JavaScript

    • Compilación LESS del lado del servidor o del lado del cliente

    • Traducciones en línea

    • Como se ha mencionado anteriormente, cualquier configuración en config.php o env.php está bloqueado y no se puede editar en el administrador.

    • Puede cambiar la configuración regional del administrador solo a los idiomas utilizados por las temáticas implementadas

      En la siguiente figura se muestra un ejemplo de la función Configuración de cuenta > Configuración regional de interfaz en la lista Administrador solo se muestran dos configuraciones regionales implementadas:

      Solo puede cambiar la configuración regional de administración a configuraciones regionales implementadas

  • No puede cambiar las configuraciones de configuración regional de ningún ámbito mediante el Administrador.

    Se recomienda realizar estos cambios antes de cambiar al modo de producción.

    Puede seguir configurando la configuración regional mediante variables de entorno o la variable config:set Comando CLI con la ruta general/locale/code.

Instalar y eliminar cron

En la versión 2.2 por primera vez, le ayudamos a configurar su trabajo cron proporcionando la magento cron:install mando. Este comando configura un crontab como el usuario que ejecuta el comando.

Además, puede quitar el crontab mediante el magento cron:remove comando.

Flujo de trabajo de implementación de canalización recomendado

El diagrama siguiente muestra cómo se recomienda utilizar la implementación de canalización para administrar la configuración.

Flujo de trabajo de implementación de canalización recomendado

Sistema de desarrollo

En el sistema de desarrollo, realice cambios de configuración en Admin y genere la configuración compartida, app/etc/config.php y la configuración específica del sistema, app/etc/env.php. Compruebe el código de Commerce y la configuración compartida en el control de código fuente y empújelo al servidor de compilación.

También debe instalar extensiones y personalizar el código de Commerce en el sistema de desarrollo.

En su sistema de desarrollo:

  1. Establezca la configuración en el Administrador de.

  2. Utilice el magento app:config:dump para escribir la configuración en el sistema de archivos.

    • app/etc/config.php es la configuración compartida, que contiene todas las configuraciones excepto configuración específica del sistema y confidencial. Este archivo debe estar en el control de código fuente.
    • app/etc/env.php es la configuración específica del sistema, que contiene opciones exclusivas de un sistema concreto (por ejemplo, nombres de host y números de puerto). Este archivo debería no estar en el control de código fuente.

  3. Agregue el código modificado y la configuración compartida al control de código fuente.

  4. Para eliminar el código php generado y los archivos de recursos estáticos mientras se encuentra en desarrollo, ejecute los siguientes comandos:

    code language-bash 
    rm -r var/view_preprocessed/*
rm -r pub/static/*/*
rm -r generated/*/*

Después de ejecutar los comandos para borrar los recursos, Commerce genera archivos de trabajo.

WARNING
Tenga cuidado con el enfoque anterior. Eliminación del .htaccess en el generated o pub Esta carpeta puede causar problemas.

Sistema de compilación

El sistema de compilación compila el código y genera archivos de vista estática para las temáticas registradas en Commerce. No necesita una conexión con la base de datos de Commerce; solo necesita la base de código de Commerce.

En su sistema de compilación:

  1. Extraer el archivo de configuración compartida del control de código fuente.
  2. Utilice el magento setup:di:compile para compilar el código.
  3. Utilice el magento setup:static-content:deploy -f para actualizar los archivos de vista de archivos estáticos.
  4. Comprobar las actualizaciones en el control de código fuente.
INFO
Consulte Estrategias de implementación para archivos de vista estática.

Sistema de producción

En el sistema de producción (es decir, en la tienda activa) se extraen los recursos generados y las actualizaciones de código del control de código fuente y se establecen los valores de configuración específicos del sistema y confidenciales mediante la línea de comandos o las variables de entorno.

En su sistema de producción:

  1. Inicie el modo de mantenimiento.
  2. Extraer actualizaciones de código y configuración del control de código fuente.
  3. Si utiliza Adobe Commerce, detenga los trabajadores en cola.
  4. Utilice el magento app:config:import para importar los cambios de configuración en el sistema de producción.
  5. Si ha instalado componentes que han cambiado el esquema de la base de datos, ejecute magento setup:upgrade --keep-generated para actualizar el esquema y los datos de la base de datos, conservando los archivos estáticos generados.
  6. Para establecer la configuración específica del sistema, utilice magento config:set variables de entorno o comando.
  7. Para establecer la configuración confidencial, utilice magento config:sensitive:set variables de entorno o comando.
  8. Limpiar (también conocido como vaciar) la caché.
  9. Finalizar modo de mantenimiento.

Comandos de administración de configuración

Proporcionamos los siguientes comandos para ayudarle a administrar la configuración:

  • magento app:config:dump para escribir las opciones de configuración de administración en config.php y env.php (excepto para configuraciones confidenciales)

  • magento config:set para establecer los valores de la configuración específica del sistema en el sistema de producción.

    Utilice el opcional --lock para bloquear la opción en Admin (es decir, hacer que la configuración no se pueda editar). Si una configuración ya está bloqueada, use el --lock para cambiar la configuración.

  • magento config:sensitive:set para establecer los valores de configuración confidencial en el sistema de producción.

  • magento app:config:import para importar los cambios de configuración de config.php y env.php al sistema de producción.

Ejemplos de administración de configuración

Esta sección muestra ejemplos de administración de la configuración para que pueda ver cómo se realizan los cambios en config.php y env.php.

Cambiar la configuración regional predeterminada

Esta sección muestra los cambios realizados en config.php al cambiar la unidad de peso predeterminada mediante el administrador (Tiendas > Configuración > Configuración > General > General > Opciones de configuración regional).

Después de realizar el cambio en el Administrador, ejecute bin/magento app:config:dump para escribir el valor en config.php. El valor se escribe en general matriz debajo de locale como el siguiente fragmento de config.php muestra:

'general' =>
    array (
        'locale' =>
        array (
            'code' => 'en_US',
            'timezone' => 'America/Chicago',
            'weight_unit' => 'kgs'
        )
    )

Cambiar varias opciones de configuración

En esta sección se explica cómo realizar los siguientes cambios en la configuración:

  • Adición de un sitio web, tienda y vista de tienda (Tiendas > Configuración > Todas las tiendas)
  • Cambiar el dominio de correo electrónico predeterminado (Tiendas > Configuración > Configuración > Clientes > Configuración del cliente)
  • Configuración del nombre de usuario y la contraseña de la API de PayPal (Tiendas > Configuración > Configuración > Ventas > Métodos de pago > PayPal > Configuración de PayPal requerida)

Después de realizar el cambio en el Administrador, ejecute bin/magento app:config:dump en su sistema de desarrollo. Esta vez, no todos los cambios se escriben en config.php; de hecho, sólo el sitio web, la tienda y la vista de la tienda se escriben en ese archivo como se muestra en los siguientes fragmentos.

config.php

config.php contiene:

  • Cambios en el sitio web, tienda y vista de tienda.
  • Configuración de motor de búsqueda no específica del sistema
  • Configuración de PayPal no confidencial
  • Comentarios que le informan de configuraciones confidenciales que se omitieron en config.php

websites matriz:

      'new' =>
      array (
        'website_id' => '2',
        'code' => 'new',
        'name' => 'New website',
        'sort_order' => '0',
        'default_group_id' => '2',
        'is_default' => '0',
      ),

groups matriz:

      2 =>
      array (
        'group_id' => '2',
        'website_id' => '2',
        'code' => 'newstore',
        'name' => 'New store',
        'root_category_id' => '2',
        'default_store_id' => '2',
      ),

stores matriz:

     'newview' =>
      array (
        'store_id' => '2',
        'code' => 'newview',
        'website_id' => '2',
        'group_id' => '2',
        'name' => 'New store view',
        'sort_order' => '0',
        'is_active' => '1',
      ),

payment matriz:

      'payment' =>
      array (
        'paypal_express' =>
        array (
          'active' => '0',
          'in_context' => '0',
          'title' => 'PayPal Express Checkout',
          'sort_order' => NULL,
          'payment_action' => 'Authorization',
          'visible_on_product' => '1',
          'visible_on_cart' => '1',
          'allowspecific' => '0',
          'verify_peer' => '1',
          'line_items_enabled' => '1',
          'transfer_shipping_options' => '0',
          'solution_type' => 'Mark',
          'require_billing_address' => '0',
          'allow_ba_signup' => 'never',
          'skip_order_review_step' => '1',
        ),

env.php

La configuración predeterminada específica del sistema del dominio de correo electrónico se escribe en app/etc/env.php.

La configuración de PayPal no se escribe en ninguno de los archivos porque bin/magento app:config:dump El comando no escribe configuraciones confidenciales. Debes establecer la configuración de PayPal en el sistema de producción mediante los siguientes comandos:

bin/magento config:sensitive:set paypal/wpp/api_username <username>

bin/magento config:sensitive:set paypal/wpp/api_password <password>
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c