
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/filesescribible por el usuario del webserver (ej. www-data o nginx). - Si usas SELinux, ajusta contextos con
chcono políticas adecuadas. - Revisa
settings.phppor 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 cry revisar permisos de archivos y .htaccess/nginx conf. - Imágenes rotas: verifica sincronización de
%filesy permisos. - Errores de versión de PHP o extensiones faltantes: compara
php -vy la lista de extensiones en origen y destino; consulta PHP.net. - Problemas con dependencias Composer: ejecutar
composer instally revisarcomposer.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.