Gestión de la configuración de tu sitio

Drupal almacena los datos de configuración del sitio de manera consistente, desde la lista de módulos habilitados hasta los tipos de contenido, vocabularios de taxonomía, campos y vistas.

No se recomienda hacer cambios directamente en la configuración de un sitio activo. El sistema está diseñado para que puedas usar la configuración actual, probar cambios localmente, exportarlos a archivos y desplegarlos en un entorno de producción. La configuración de tu sitio puede guardarse como parte de tu base de código e integrarse con el control de versiones.

Por defecto, la configuración "activa" se almacena en la base de datos (tabla "config"). Esto es por razones de rendimiento y seguridad. Esta es la configuración completa del sitio en el momento actual. La configuración puede exportarse e importarse como archivos YAML, ya sea completamente o en fragmentos individuales, usando comandos de configuración de Drush y/o Drupal Console o Configuration Manager. (Detalles más abajo.)

Exportar e importar cambios de configuración entre instalaciones de Drupal en diferentes entornos, como Desarrollo, Staging y Producción, te permite realizar y verificar cambios lejos del entorno real de tu sitio.

Esto permite desplegar configuración de un entorno a otro (como medida de precaución, Drupal verifica que el sitio es el mismo antes de importar, comparando su UUID).

Archivos de configuración de módulos y temas

La configuración por defecto que proveen los módulos, distribuciones y temas se importa al almacenamiento activo de configuración cuando las extensiones se habilitan. La configuración predeterminada de la extensión se encuentra en el directorio config/install.

Cómo importar, exportar y sincronizar

Con el módulo principal Configuration Manager puedes importar, exportar y sincronizar la configuración del sitio vía Gestión > Configuración > Desarrollo > Sincronización de configuración (admin/config/development/configuration). Puedes revisar los cambios antes de importarlos.

También es posible importar o exportar un solo objeto usando un flujo de trabajo de copiar/pegar. Esto es útil, por ejemplo, si quieres mover una vista creada de un entorno a otro.

O la configuración completa del sitio puede exportarse como archivos YAML en un archivo tar.gz. Esto solo funciona si mueves la configuración entre dos copias del mismo sitio (por ejemplo, dev y producción), por lo que los UUID deben coincidir.

Para verificar el UUID del sitio desde la CLI:

- Usando Drush

drush cget system.site

- Usando Drupal Console

drupal debug:config system.site

Ejemplos completos de flujos de trabajo de sincronización:

• Uso de la interfaz de Drupal
• Uso de Drush
• Documentación de comandos Drush config

Después de completar la sincronización se aplicarán todos los cambios, como habilitar nuevos módulos, campos o tipos de contenido. En resumen, todos los cambios de configuración realizados en el sitio de desarrollo ahora deben estar activos en producción.

Información adicional

Si necesitas más información detallada sobre el sistema de gestión de configuración en Drupal 8, puedes consultar las páginas del manual sobre API de configuración.

Lo que debes y no debes hacer

DEBES:

Se recomienda encarecidamente hacer un volcado de base de datos antes de cada sincronización de los directorios de preparación y activo. El volcado de base de datos "puede salvarte la vida" en caso de que necesites una estrategia de reversión.

NO DEBES:

No intentes cambiar la configuración activa en tu sitio modificando los archivos en el directorio config/install del módulo.
Esto NO funcionará porque Drupal solo lee ese directorio cuando el módulo está instalado.
Para editar "en vivo" necesitas usar drush config-edit o drupal config:edit.