DocumentaciónCommerceGuía de configuración

Ejemplo con comandos CLI

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

Creado para:

  • Experimentado
  • Administrador
  • Desarrollador

Este ejemplo muestra cómo establecer valores compartidos, específicos del sistema y confidenciales en el sistema de desarrollo y, a continuación, implementar esos valores en el sistema de producción.
Esto se hace mediante una combinación de configuraciones compartidas, el archivo config.php y el comando CLI de Commerce.

Este ejemplo utiliza las opciones de configuración siguientes:

  • Número de IVA y Nombre de tienda para las opciones de configuración compartidas.

    Se encuentran en Tiendas > Configuración > Configuración > General > General.

  • Enviar correos electrónicos a para obtener el valor de configuración confidencial.

    Se encuentra en Tiendas > Configuración > Configuración > General > Contactos.

  • Dominio de correo electrónico predeterminado para el valor de configuración específico del sistema.

    Se encuentra en Tiendas > Configuración > Configuración > Clientes > Configuración del cliente > Crear nuevas opciones de cuenta.

Puede utilizar el mismo procedimiento mostrado en este ejemplo para configurar cualquier configuración en las siguientes referencias:

Antes de empezar

Antes de empezar, configure los permisos y la propiedad del sistema de archivos como se describe en Requisito previo para los sistemas de desarrollo, compilación y producción.

Suposiciones

En este tema se proporciona un ejemplo de cómo modificar la configuración del sistema de producción. Si lo desea, puede elegir diferentes opciones de configuración.

Para los fines de este ejemplo, suponemos lo siguiente:

  • Utilice el control de código fuente Git
  • El sistema de desarrollo está disponible en un repositorio remoto Git denominado mconfig
  • Su rama de trabajo de Git se llama m2.2_deploy

Paso 1: Establezca la configuración en el sistema de desarrollo

Para establecer la configuración regional y las unidades de peso predeterminadas en el sistema de desarrollo:

  1. Inicie sesión en Admin.

  2. Haga clic en Tiendas > Configuración > Configuración > General > General.

  3. Si tiene más de un sitio web disponible, use la lista Vista de tienda en la esquina superior izquierda para cambiar a otro sitio web, como se muestra en la siguiente ilustración.

    Cambiar de sitio web

  4. En el panel derecho, expanda Información de almacén.

  5. Si es necesario, borra la casilla de verificación Usar predeterminado junto a los campos Número de IVA y Nombre de tienda.

  6. Escriba un número en el campo (por ejemplo, 12345).

  7. En el campo Nombre de tienda, escriba un valor (como My Store).

  8. Haga clic en Guardar configuración.

  9. En el panel de navegación izquierdo, debajo de General, haga clic en Contactos.

  10. En el panel derecho, expanda Opciones de correo electrónico.

  11. Si es necesario, borre la casilla de verificación Usar predeterminado junto al campo Enviar correos electrónicos a.

  12. Introduzca una dirección de correo electrónico en el campo.

  13. Haga clic en Guardar configuración.

  14. Use la lista Vista de tienda para seleccionar la configuración predeterminada, como se muestra en la siguiente ilustración.

    Cambiar a la configuración predeterminada

  15. En el panel izquierdo, haga clic en Clientes > Configuración del cliente.

  16. En el panel derecho, expanda Crear nuevas opciones de cuenta.

  17. Si es necesario, borre la casilla de verificación Usar valor del sistema junto al campo Dominio de correo electrónico predeterminado.

  18. Introduzca un nombre de dominio en el campo.

  19. Haga clic en Guardar configuración.

  20. Si se le solicita, vacíe la caché.

Paso 2: Actualizar la configuración

Ahora que ha cambiado la configuración en el Administrador, escriba la configuración compartida en un archivo como siguiendo los pasos siguientes:

Para actualizar la configuración:

  1. Inicie sesión en el sistema de desarrollo como propietario del sistema de archivos o cambie a.

  2. Cambie a la raíz de la aplicación y ejecute el comando dump.

    code language-bash 
    cd <Magento root dir>
php bin/magento app:config:dump

    Por ejemplo, si Commerce está instalado en /var/www/html/magento2, escriba:

    code language-bash 
    cd /var/www/html/magento2
php bin/magento app:config:dump

  3. Confirme que app/etc/config.php se ha actualizado.

    code language-bash 
    git status

    Respuesta de ejemplo:

    code language-terminal 
    On branch m2.2_deploy
Changed but not updated:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)
       modified:   app/etc/config.php
    note warning
    WARNING
    no envía cambios a los directorios generated, pub/media o pub/static al control de código fuente. Estos archivos se generan en el sistema de compilación. Es probable que el sistema de desarrollo tenga código, temas, etc., que no estén listos para usarlos en el sistema de producción.

  4. Proteja sus cambios en app/etc/config.php solo para el control de código fuente.

    code language-bash 
    git add app/etc/config.php && git commit -m "Updated shared configuration" && git push mconfig m2.2_deploy

Aunque app/etc/env.php (la configuración específica del sistema) se haya actualizado, no la proteja en el control de código fuente.
Creará las mismas opciones de configuración en el sistema de producción más adelante en este procedimiento.

Paso 3: Actualizar el sistema de compilación y generar archivos

Ahora que ha confirmado los cambios en la configuración compartida en el control de código fuente, puede extraer esos cambios en el sistema de generación, compilar el código y generar archivos estáticos.

Para actualizar el sistema de compilación:

  1. Inicie sesión en el sistema de generación como propietario del sistema de archivos.

  2. Cambie al directorio raíz de la aplicación.

    code language-bash 
    cd <Magento root dir>

  3. Extraer los cambios de app/etc/config.php del control de código fuente.

    code language-bash 
    git pull mconfig m2.2_deploy

  4. Compile el código.

    code language-bash 
    bin/magento setup:di:compile

  5. Una vez compilado el código, genere archivos de vista estática.

    code language-bash 
    bin/magento setup:static-content:deploy -f

  6. Comprobar los cambios en el control de código fuente.

    code language-bash 
    git add -A && git commit -m "Updated files on build system" && git push mconfig m2.2_deploy

Paso 4: Actualizar el sistema de producción

El último paso del proceso es actualizar el sistema de producción. Debe hacerlo en dos partes:

  • Actualice la configuración confidencial y específica del sistema
  • Actualizar la configuración compartida

Actualice la configuración confidencial y específica del sistema

Para establecer la configuración confidencial y específica del sistema mediante variables de entorno, debe saber lo siguiente:

  • Ámbito de cada configuración

    Si ha seguido las instrucciones del paso 1, el ámbito de Enviar correos electrónicos a es el sitio web y el ámbito de Dominio de correo electrónico predeterminado es global (es decir, el ámbito de configuración predeterminado).

    Necesita el código del sitio web para establecer el valor de configuración Enviar correos electrónicos a.

    Para obtener más información sobre cómo encontrar este valor, consulte: Usar variables de entorno para anular las opciones de configuración.

  • Rutas de configuración para las opciones utilizadas en este ejemplo:

    table 0-row-2 1-row-2 2-row-2
    Nombre de configuración Ruta de configuración
    Envío de correos electrónicos a contact/email/recipient_email
    Dominio de correo electrónico predeterminado customer/create_account/email_domain

    Para todas las rutas de configuración confidenciales y específicas del sistema, vea: Referencia de rutas de configuración confidenciales y específicas del sistema.

Establecer las variables mediante comandos CLI

Utilice los siguientes comandos de CLI para establecer las opciones de configuración específicas del sistema y confidenciales:

  • magento config:set para la configuración específica del sistema
  • magento config:sensitive:set para la configuración confidencial

Para establecer la configuración específica del sistema Dominio de correo electrónico predeterminado, que se encuentra en el ámbito predeterminado, use el siguiente comando:

bin/magento config:set customer/create_account/email_domain <email domain>

No es necesario utilizar el ámbito en el comando porque es el ámbito predeterminado.

Sin embargo, para establecer los valores de Enviar correos electrónicos a, debe conocer el tipo de ámbito (website) y el código de ámbito, que probablemente sean diferentes en cada sitio.

Ejemplo:

bin/magento config:sensitive:set contact/email/recipient_email --scope=website --scope-code=<website code> <email address>

Actualizar la configuración compartida

En esta sección se explica cómo extraer todos los cambios realizados en los sistemas de desarrollo y compilación en un entorno de producción, lo que actualiza la configuración compartida (nombre del almacén y número de IVA).

Para actualizar el sistema de producción:

  1. Inicie sesión en el sistema de producción como propietario del sistema de archivos.

  2. Cambie a la raíz de la aplicación y habilite el modo de mantenimiento.

    code language-bash 
    cd <Magento root dir>
    code language-bash 
    bin/magento maintenance:enable

    Para obtener opciones adicionales, como la posibilidad de establecer una lista blanca de direcciones IP, vea magento maintenance:enable.

  3. Detenga los trabajadores de cola en ejecución estableciendo cron_run en false en app/etc/env.php de la siguiente manera:

    code language-php?start_inline=1 
    'cron_consumers_runner' => [
        'cron_run' => false
    ]

  4. Actualice la configuración.

    code language-bash 
    bin/magento app:config:import

  5. Finalmente, kill cualquier proceso de consumidor activo.

    code language-bash 
    kill <PID>

    Donde PID es el ID de proceso que se va a eliminar, por ejemplo:

    code language-bash 
    kill 1234

  6. Extraer código del control de código fuente.

    code language-bash 
    git pull mconfig m2.2_deploy

  7. Actualice la configuración.

    code language-bash 
    bin/magento app:config:import

  8. Limpie la caché.

    code language-bash 
    bin/magento cache:clean

  9. Finalizar modo de mantenimiento.

    code language-bash 
    bin/magento maintenance:disable

Compruebe los ajustes de configuración en el Administrador

Para comprobar las opciones de configuración:

  1. Inicie sesión en el administrador del sistema de producción.

  2. Haga clic en Tiendas > Configuración > Configuración > General > General.

  3. Use la lista Vista de tienda en la esquina superior izquierda para cambiar a otro sitio web.

    Las opciones de configuración compartida establecidas en el sistema de desarrollo se muestran de forma similar a la siguiente.

    Comprobar la configuración del sistema de producción

    note info
    INFO
    El campo Store Name se puede editar en el ámbito del sitio web, pero si cambia al ámbito de configuración predeterminado, no se puede editar. Este es el resultado de cómo se establecen las opciones en el sistema de desarrollo. El valor de Número de IVA no se puede editar en el ámbito del sitio web.

  4. Si aún no lo ha hecho, cambie al ámbito de configuración predeterminada.

  5. En el panel de navegación izquierdo, debajo de General, haga clic en Contactos.

    El campo Enviar correos electrónicos a no se puede editar, como se muestra en la siguiente ilustración. Esta es una configuración confidencial.

    Comprobar la configuración del sistema de producción

  6. En el panel izquierdo, haga clic en Clientes > Configuración del cliente.

  7. En el panel derecho, expanda Crear nuevas opciones de cuenta.

    El valor del campo Dominio de correo electrónico predeterminado se muestra de la siguiente manera. Esta es una configuración específica del sistema.

    Comprobar la configuración del sistema de producción

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c