entorno

   Configuración de entornos locales para migración

     Actualmente existen innumerables herramientas, que facilitan la instalación de entornos de desarrollo locales; como cada vez ganan más terreno, soluciones basadas en contenedores virtuales de Docker, para nuestro  ejercicio, hemos decidido utilizar Lando, debido a lo fácil y sencillo que resulta poner en marcha cualquier proyecto.

     De esta forma, podremos configurar, rápidamente, todos los requermientos necesarios, para cada uno de los Drupales, con los que vamos a trabajar de aquí en adelante.

   Si todavía no haz trabajado con Lando, HAZ CLIC AQUÍ

   Cómo instalar ambos entornos para la migración.

     Para que podamos acceder a las dos instancias de Drupal, que utilizaremos para realizar la migración, será necesario generar un archivo de Lando, por cada uno de los proyectos y a continuación, realizar las modificaciones específicas para cada uno de los casos.

   Pasos previos a la instalación del Drupal 7 en local.

     Al tratarse de una migración desde un proyecto Drupal 7, asumimos que vas a descargarlo desde tu servidor de producción, para instalarlo en tu entorno local, así que lo primero que deberás verificar son los detalles relacionados con la versión de PHP, Mysql y Memoria, que econtrarás en el apartado de "/informes", y que deberás ajustar en tu archivo de configuración de lando, para que todo funcione tal y como se espera.

     Antes de comenzar con el resto de procesos relacionados con la migración, asegúrate de que todas las páginas, usuarios, taxonomías, imágenes y otros elementos, se comportan y se muestran sin ninguna alteración.

     Recuerda que si vas a trabajar con un Drupal que ya está en funcionamiento, deberías comprobar si tienes los siguientes archivos y/o carpetas:

• Carpeta files, con imágenes, archivos de cache, etc. (Ubicación: sites/default/files)
• Carpeta libraries (Si haz descargado el módulo)
• Carpeta modules (Ubicación: sites/all/modules)
• Carpeta themes (Ubicación: sites/all/themes)
• Archivo settings.php (Ubicación: sites/default/settings.php)

     Para este ejemplo, hemos descargado los archivos de Drupal 7, desde la Web Oficial de Drupal, es por esta razón que, en la siguiente imagen, ves como se repiten las carpetas modules y themes, ya que se han ido recolocando, preparando la estructura, de acuerdo con el estandar que se empleó a partir de Drupal 8.

Es probable, que en tu proyecto de Drupal 7, solo tengas las carpetas que aparecen dentro de "sites/all".

 Una vez configurado el archivo de lando, deberías acceder al sitio de Drupal en local para continuar con el proceso de migración. (Recuerda modificar el puerto para evitar conflictos entre ambas instalaciones)

   Pasos previos a la instalación del Drupal Destino (8, 9 o superior)

     En el caso del Drupal Destino (8, 9 o superior), lo recomendable es que instales el proyecto utilizando el gestor de paquetes Composer, para asegurarte de que la estructura te permitirá realizar acciones de mantenimiento o actualizaciones, siguiendo los parámetros necesarios y evitando posibles fallos futuros.

     Una vez configurado el archivo de lando, deberías acceder al sitio de Drupal en local para continuar con el proceso de migración. (Recuerda modificar el puerto para evitar conflictos entre ambas instalaciones)

   Siguientes pasos

     En el siguiente capítulo, instalaremos el proyecto de Drupal, basándonos en la estructura base que hemos descargado desde www.drupal.org, además, para que el ejemplo sea lo más parecido a la realidad, añadiremos un módulo custom, equivalente a los que te encontrarás en tu proyecto y generaremos algunos contenidos, utilizando el módulo devel.

     Por último, descargaremos algunos módulos que sufrieron cambios importantes en versiones posteriores a Drupal 7, como Views, que se integró en el Core de Drupal o el módulo FieldCollection, que fue sustituido por Paragraphs, así podrás apreciar mejor, cómo analizar tu estrategia de migración, para el proyecto que migrarás a la versión que elijas.

Para arrancar nuestros contenedores, tenemos dos opciones:

docker compose up -d

O también puedes utilizar el paquete Make, que viene por defecto instalado con la distribución de Ubuntu, en este caso el comando para arrancar los contenedores sería:

make up

Una vez ejecutado cualquiera de los anteriores comandos, si todo va bien, deberías ver en tu consola, algo parecido a la siguiente imagen:

   Descargando Drupal en nuestro servidor con Docker

     Gracias a que hemos eliminado previamente, el archivo docker-compose.override.yml, que reescribe la configuración de nuestros contenedores, podremos descargar el esqueleto de un proyecto Drupal 10, en este caso, para colocarlo dentro de nuestra carpeta del rood y así tener todos los archivos listos, por si en un futuro queremos compartir nuestro código, con otros miembros del equipo o trasladarlo a otra máquina.

   Pasos para descargar el Esqueleto de Drupal

       Paso 1 - Acceder al contenedor PHP

          A partir de Drupal 8, es recomendable utilizar el gestor de paquetes Composer, para garantizar la descarga total de las dependencias y facilitar las tareas de actualización y/o mantenimiento de Drupal, una vez esté en funcionamiento.

          Composer está disponible dentro del contenedor encargado de ejecutar PHP, así que primero comprobaremos los nombres de todos los contenedores y luego accederemos al contenedor de PHP. Para conocer los contenedores que tenemos funcionando actualmente, ejecutaremos el siguiente comando en la consola:

docker ps

        Esto nos debería devolver el listado con todos los contenedores que estén en funcionamiento:

En nuestro caso, el contenedor de php se llama my_drupal10_project_php, para acceder dentro del contenedor y poder ejecutar el comando composer, escribiremos lo siguiente en la consola:

docker exec -it my_drupal10_project_php bash

Esto nos colocará dentro de la carpeta ROOT del servidor:

A continuación, podremos descargar el esqueleto de Drupal 10, añadiendo el siguiente comando:

composer create-project drupal/recommended-project vaciar

Este comando descargará todos los arhivos necesarios para una instalación de Drupal 10, dentro de la carpeta que yo he llamado VACIAR, para que recordemos que no debemos dejar nada dentro una vez termine la descarga.

   Añadiendo archivos no deseados al .gitignore

     Antes de sacar los archivos de la carpeta VACIAR, para evitar que se suban por error, cualquiera de los archivos de Docker, que sólo deberían estar en nuestro servidor local, tendremos que añadir esos archivos al .gitignore que nos viene por defecto al descargar Docker4Drupal, así que, lo abriremos con nuestro editor, y a continuación, añadiremos todos los archivos correspondientes a Docker y sus contenedores:

     El archivo .gitignore, quedaría de la siguiente manera, con nuestros cambios añadidos:

.idea/
mutagen.yml.lock
.vscode

#ignoramos los archivos de Docker y el servidor
tests
.dockerignore
.env
docker-compose.yml
docker.mk
LICENSE.md
Makefile
README.md
traefik.yml

   Moviendo los archivos de Drupal a la raiz del  servidor

      Ya que tenemos configurado el archivo .gitignore, procederemos a extraer todos los archivos de la carpeta vaciar, para colocarlos en la carpeta raíz de nuestro servidor y de esta forma iniciar el proceso de instalación del Drupal. Para ello, no hace falta que estemos dentro del contenedor:

mv vaciar/* .

mv vaciar/.* .

     Con esto, quedarán fuera de la carpeta vaciar, todos los archivos de Drupal y a continuación, podremos eliminar la carpeta.

sudo rm -rf vaciar

   Arrancando el instalador de Drupal

     Ahora que ya hemos colocado todos los archivos necesarios para instalar Drupal, podremos proceder con el instalador, pero antes, para estar seguros de que tenemos todo actualizado a la versión más reciente disponible, ejecutaremos el comando update de Composer, desde nuestro contenedor php:

composer update

     El resultado, debería ser algo parecido a la siguiente imagen:

     Para comprobar que podremos instalar nuestro Drupal 10, abriremos el navegador y escribiremos los datos que constan en la variable de entorno, y que explicamos al principio de este ejercicio, si no has cambiado ninguno de los valores por defecto, deberías escribir esto en tu navegador :

http://drupal.docker.localhost:8000/

     El resultado, será que se pondrá en marcha el instalador de Drupal 10.

   Proceso de instalación

     Al hacer clic en la primera pantalla del instalador, es posible que nos encontremos con algunos mensajes, relacionados con archivos que nos faltan por descargar, crear o configurar. El primero de ellos, en mi caso es una alerta que me advierte de la ausencia de la carpeta translations, encargada de alojar los archivos relacionados con las traducciones de Drupal, ya que nuestra instalación será en Español. 

     Para corregir el error, creaemos la carpeta files, dentro de la ubicación: web/sites/default/, y acontinuación, daremos permisos de escritura a la carpeta files...

     Si volvemos al navegador y refrescamos, veremos que nos deja continuar con el proceso de instalación, hasta la siguiente pantalla:

     Al hacer clic en el botón Guardar y continuar, nos encontraremos con otro mensaje de alerta: 

     El instalador Drupal necesita que se cree un archivo ./sites/default/settings.php como parte del proceso de instalación. Así que simplemente, seguiremos las instrucciones, copiaremos el archivo default.settings.php y lo renombraremos a settings.php, asegurándonos de otorgarle permisos de escritura, que serán necesarios durante el resto de la instalación, para que Drupal pueda configurar los datos de acceso a la base de datos y la carpeta para la sincronización.

cp web/sites/default/default.settings.php  web/sites/default/settings.php

chmod -R 777 web/sites/default/settings.php

     Esta vez, cuando hayamos refrescado el navegador, veremos la pantalla donde tendremos que añadir los datos de acceso a la base de datos, que son los que podremos confirmar en nuestra variable de entorno .env, es muy importate que en lugar de dejar localhost, cambiemos el servidor de la base de datos por mariadb, o nos devolverá un error de permisos.

     Tan pronto como se terminen de descargar las traducciones, debido a que nuestra instalación es en Español, veremos la pantalla final, donde debemos rellenar los detalles del usuario administrador, el correo electrónico que utilizará Drupal, para comunicarse con los usuarios que interactuén, el lenguaje, horario y pais... 

     Rellenaremos todo, presionaremos el botón continuar, y por fin, hemos terminado el proceso completo de instalación de un proyecto Drupal 10, con Docker.

     Ahora ya podremos comenzar a trabajar con nuestro Drupal.

   Añadiendo archivos al repositorio

     Como hemos comentado al principio, por lo general, cuando estás trabajando con algún proyecto de desarrollo, en algún momento tendrás que realizar el despliegue al entorno de producción, por lo cual es muy recomendable, que desde el principio, te acostumbres a trabajar con un repositorio, añadiendo y comiteando tus cambios, a medida que vayas avanzando en el proceso.

     Para evitar que se añadan archivos innecesarios de Drupal, como vendor o files, actualizaremos el archivo .gitignore, antes de realizar nuestro primer commit.

     Accede a este enlace y copia todo su contenido, justo debajo de nuestros últimos cambios en el .gitignore:

     https://drupaladicto.com/snippet/git-ignore-para-drupal

     Una vez actualizado tu archivo, podemos añadir y comentar nuestros cambios:

git init

git add .

git commit -m "Archivos base para instalar Drupal 10"

     Así nos aseguramos de que, al ejecutar el comando de subida a nuestro repositorio, git pull, sólo subamos lo necesario para no ocupar espacio innecesario en nuestro repositorio final.