Migración de sitios Drupal entre servidores usando Drush

Esta guía técnica explica, paso a paso, cómo migrar un sitio Drupal entre servidores utilizando Drush. Está orientada a administradores de sistemas y desarrolladores que buscan un proceso reproducible, seguro y optimizado: copia de código (Composer), sincronización de archivos, export/import de base de datos y configuración, y verificación final.

Por qué usar Drush para migraciones

Drush automatiza operaciones frecuentes en Drupal: volcado y restauración de bases de datos, sincronización de archivos y manejo de configuración (config export/import). Usar Drush reduce errores humanos, acelera pruebas y permite integración con scripts de despliegue. Es especialmente útil cuando trabajas con sitios basados en Composer y entornos remotos accesibles por SSH.

Preparación previa a la migración

Antes de cualquier traslado, audita el sitio y el entorno destino:

  • Versiones de PHP y extensiones: verifica compatibilidad con Drupal y módulos. Usa la documentación oficial en PHP.net para requisitos de versión.
  • Servidor web y configuraciones (Nginx/Apache), límites de PHP (memory_limit, max_execution_time) y permisos de archivos.
  • Compatibilidad de Drush y Composer: versiones de Drush deben coincidir con la rama de Drupal.
  • Backups completos: código, base de datos y carpeta de archivos (sites/default/files).

Flujo recomendado de migración

Resumen de pasos principales — cada paso se desarrolla luego con comandos y consejos:

  • Poner el sitio en modo mantenimiento.
  • Exportar configuración (drush cex) y versión de Composer.
  • Reproducir el entorno en destino: PHP, extensiones, webserver, base de datos.
  • Sincronizar código (git/composer) y ejecutar composer install.
  • Sincronizar archivos (rsync o drush rsync).
  • Exportar/importar base de datos (drush sql-dump / drush sql-sync).
  • Importar configuración (drush cim), actualizar la base de datos (drush updatedb) y regenerar caché (drush cr).
  • Verificación y ajuste final: SSL, permisos, DNS.

Configuración de alias de sitio Drush

Usar alias facilita comandos remotos: define alias para origen y destino en ~/.drush/sites o en drush/sites del proyecto. Ejemplo básico de alias (archivo PHP):

 'origen.example.com',
  'remote-user' => 'deploy',
  'root' => '/var/www/html/drupal',
  'uri' => 'https://origen.example.com',
);
$aliases['destino'] = array(
  'remote-host' => 'destino.example.com',
  'remote-user' => 'deploy',
  'root' => '/var/www/html/drupal',
  'uri' => 'https://destino.example.com',
);

Con esto puedes ejecutar sincronizaciones directas: drush sql-sync @origen @destino o drush rsync @origen:%files @destino:%files.

Comandos esenciales y ejemplos

1) Exportar configuración y activar mantenimiento

drush @origen sset system.maintenance_mode 1
drush @origen cex -y

2) Sincronizar código y dependencias

En entornos Composer-based, evita copiar la carpeta vendor. En el destino:

git clone git@repo:site.git /var/www/site
cd /var/www/site
composer install --no-dev --optimize-autoloader

3) Sincronizar archivos públicos

Usa drush rsync o rsync vía SSH. Ejemplo con drush:

drush rsync @origen:%files @destino:%files -y

Si prefieres rsync clásico, usa opciones seguras:

rsync -avz --progress -e 'ssh -p 22' deploy@origen:/var/www/site/web/sites/default/files/ /var/www/site/web/sites/default/files/

4) Exportar y restaurar la base de datos

Opciones:

  • Drush sql-dump y transferencia manual:
drush @origen sql-dump --result-file=/tmp/site.sql
scp deploy@origen:/tmp/site.sql /tmp/site.sql
drush @destino sql-cli < /tmp/site.sql
  • O usar drush sql-sync (directo entre ambientes):
drush sql-sync @origen @destino -y

MySQL/MariaDB y sus herramientas son referencia para volcado; más información en MySQL.

5) Ajustes post-import: search-replace y sanitización

Si cambió el dominio, ejecuta reemplazos SQL para rutas y variables. Hazlo con cuidado y pruebas en staging. Para sanitizar cuentas de usuario en entornos públicos, usa drush sql-sanitize:

drush @destino sql-sanitize --sanitize-email=example.com

6) Importar configuración, actualizar DB y limpiar caché

drush @destino cim -y
drush @destino updatedb -y
drush @destino cr

Permisos, SELinux y seguridad

  • Asegura permisos de archivos: la carpeta sites/default/files escribible por el usuario del webserver (ej. www-data o nginx).
  • Si usas SELinux, ajusta contextos con chcon o políticas adecuadas.
  • Revisa settings.php por credenciales y patrones de host confiables (trusted_host_patterns).
  • Habilita HTTPS: para certificados automáticos usa Let's Encrypt.

Verificación y pruebas post-migración

Checklist rápido:

  • Acceso al frontend y backend (drush uli para un enlace de acceso administrador: drush @destino uli).
  • Revisar logs de PHP y Drupal (dblog) para errores.
  • Probar formularios críticos, subida de archivos y vistas.
  • Ejecutar pruebas de rendimiento básicas y revisar límites PHP.

Errores comunes y soluciones rápidas

  • 503/500 tras migración: ejecutar drush cr y revisar permisos de archivos y .htaccess/nginx conf.
  • Imágenes rotas: verifica sincronización de %files y permisos.
  • Errores de versión de PHP o extensiones faltantes: compara php -v y la lista de extensiones en origen y destino; consulta PHP.net.
  • Problemas con dependencias Composer: ejecutar composer install y revisar composer.lock.

Automatización y buenas prácticas

Para entornos repetibles, integra estos pasos en pipelines CI/CD (por ejemplo, GitLab CI o GitHub Actions) y evita copiar vendor; reconstruye con Composer. Mantén alias Drush versionados en el repositorio y registra errores en un playbook para facilitar rollback.

Consideraciones finales

Migrar un sitio Drupal con Drush acelera y reduce riesgos cuando se siguen buenas prácticas: respaldos completos, revisión de compatibilidades, uso de aliases y comandos seguros (drush sql-sync, drush rsync, drush cim). Ten siempre un plan de rollback y valida cada etapa en un entorno staging antes de tocar producción.

Recursos y referencias

Para profundizar sobre compatibilidades y herramientas citadas: consulta la documentación oficial de PHP en PHP.net, la página de MySQL en MySQL para volcado/import y la documentación de Let's Encrypt para certificados SSL gratuitos y automatizados.

Conclusión

Migrar Drupal entre servidores con Drush es una práctica profesional que permite fiabilidad y reproducibilidad si se incluyen pasos claros: auditoría, backups, sincronización de código/archivos/BD, importación de configuración y verificación exhaustiva. Sigue la secuencia propuesta, usa alias Drush para operaciones remotas y automatiza lo que puedas. Con esto reducirás tiempo de inactividad y evitarás riesgos comunes en migraciones.