local

Si haz decidido dedicarte profesionalmente al desarrollo de aplicaciones web, lo ideal es que comiences a experimentar con las herramientas y opciones más actuales que existen en el mercado. Una de mis recomendaciones es el uso de contenedores Docker, que nos permitirá configurar, replicar y/o compartir, entornos de trabajo, evitando los históricos fallos de versión del lenguaje, o del servidor con el que estemos trabajando en nuestros proyectos.

En el caso de Drupal, no basta con añadir un archivo Dockerfile, para contar con todos los requerimientos necesarios, pero ya existen varias alternativas disponibles, facilitándonos esa parte del proceso. Una de ellas es la conocida como Docker4Drupal, cuyo mantenimiento continuo y permanente, nos permite realizar las instalaciones de Drupal, en cada nueva versión publicada.

Docker4Drupal, tiene múltiples funcionalidades, que podremos activar, personalizar y utilizar, dependiendo de las necesidades del proyecto, como son el administrador de base de datos Adminer, Xdebug, servidor para correos locales Mailhog, servidor de base de datos Postgres, servidor Apache Solr, entre otros.

Además de utilizar las variables de entorno, que nos pueden servir para realizar comprobaciones sobre el comportamiento de nuestras aplicaciones, sin la necesidad de realizar despliegues en otros entornos adicionales a nuestro local.

Aunque no profundizaremos en todas las opciones y configuraciones disponibles con Docker4Drupal, te animo a que visites su página oficial https://github.com/wodby/docker4drupal y eches un vistazo a su documentación, para que conozcas un poco más acerca de todo lo que tiene para ofrecernos.

   Cómo instalar un entorno local con Docker4Drupal

     Requisitos:

          - Entorno Linux: Yo he utilizado el subsistema WSL2, con Ubuntu 2204, dentro de una máquina Windows 11. HAZ CLIC AQUI

          - Docker Desktop: Para las instrucciones desde su página oficial. HAZ CLIC AQUI

     Para este curso, utilizaremos Docker4Drupal, dentro de un entorno Linux (Ubuntu 2204), con WSL2 y Windows 11, de esta manera no tendremos que configurar máquinas virtuales adicionales, que podrían consumir muchos más recursos de los necesarios en nuestra máquina. Aunque si lo deseas, también puedes aplicar los mismos pasos en la distribución de Linux que prefieras.

     Si quieres reproducir exactamente los ejercicios que vamos a detallar en este curso, sólo necesitarás descargar y configurar DockerDesktop y WSL2 en tu ordenador y a continuación, abrir la consola para continuar con el resto de la instalación que verás en el video.

   Descarga y configuración del Docker4Drupal

      Ahora que ya tienes configurado el entorno Linux donde vas a trabajar, abriremos nuestra consola y nos colocaremos en la ubicación donde instalaremos nuestro Drupal 10, a continuación, abriremos la url del respositorio de Docker4Drupal y lo clonaremos, para comenzar con la descarga de los archivos que vamos a necesitar.

     Si quieres, puedes aprovechar el proceso de clonación para configurar el nombre de tu carpeta, al mismo tiempo que realiza la descarga, para ello, tendrás que añadir una línea como la siguiente:

git clone https://github.com/wodby/docker4drupal.git/ drupal_10

     Esto creará la carpeta con el nombre drupal_10 en la ubicación que hayas seleccionado y dentro de ella colocará todos los archivos descargados desde el repositorio, donde podremos continuar con otros cambios necesarios, antes de descargar el esqueleto o estructura principal de nuestro proyecto de Drupal.

   Configuración inicial del servidor

     Una vez terminada la descarga de los archivos para nuestro servidor, el siguiente paso será la personalización de algunas opciones, para que podamos descargar, arrancar y acceder a nuestro proyecto de Drupal, que descargaremos, una vez terminados estos primeros cambios.

     Así que, con nuestro IDE favorito, abriremos la carpeta donde hemos descargado los archivos del repositorio, para comenzar con las primeras configuraciones.

   Paso 1 - Eliminar docker-compose.override.yml

     Eliminaremos el archivo docker-compose.override.yml, para que podamos controlar el comportamiento del servidor a través de la configuración en la variable de entorno.

   Paso 2 - Ajustes en la variable de entorno.

     Por el momento, el archivo que necesitamos conocer y ajustar es el responsable de nuestro entorno de trabajo, conocido como .env, donde podremos personalizar los siguientes detalles:

    Nombre del proyecto, url y puerto de conexión

• Nombre del proyecto: PROJECT_NAME=my_drupal10_project
• Url del proyecto: PROJECT_BASE_URL=drupal.docker.localhost 
• El puerto de conexión: PROJECT_PORT=8000

    Cuando hayamos realizado el cambio en la url del proyecto y el puerto, podremos acceder a nuestro Drupal, una vez descargado, escribiendo en el navegador 

http://drupal.docker.localhost:8000

   Nombre de usuario, base de datos y contraseña

• Nombre de la base de datos: DB_NAME=drupal 
• Nombre del usuario para la base de datos: DB_USER=drupal 
• Contraseña del usuario de base de datos: DB_PASSWORD=drupal    

   Arrancando nuestros contenedores Docker

     Un servidor basado Docker que ejecuta varios contenedores, conectados entre sí, que permiten ejecutar nuestro código sin la necesidad de instalar ningún archivo extra en nuestra máquina, esto es lo que se conoce como virtualización del entorno.

     En otra palabras, en lugar de arrancar un servidor tipo XAMPP, con todo incluido y administrable desde un panel de control, como hacíamos años atrás, con Docker, tendremos varios servicios independientes, que podremos modificar y/o ajustar, según nuestras necesidades. 

     Si exploras un poco más, dentro del archivo .env, que modificamos hace un momento, podrás comprobar que tienes varias opciones de versión y configuración, que podrás activar o desacticar, añadiendo o quitando, el símbolo de almohadilla (#), que acompaña cada una de las definiciones:

### --- MARIADB ----

MARIADB_TAG=10.11-3.26.3
#MARIADB_TAG=11.0-3.26.3
#MARIADB_TAG=10.10-3.26.3
#MARIADB_TAG=10.9-3.26.3
#MARIADB_TAG=10.6-3.26.3
#MARIADB_TAG=10.5-3.26.3
#MARIADB_TAG=10.4-3.26.3

### --- VANILLA DRUPAL ----

DRUPAL_TAG=10-4.58.1
#DRUPAL_TAG=9-4.58.1
#DRUPAL_TAG=7-4.58.1

### --- PHP ----

# Linux (uid 1000 gid 1000)

PHP_TAG=8.2-dev-4.47.1
#PHP_TAG=8.1-dev-4.47.1
#PHP_TAG=8.0-dev-4.47.1

Si no ves el video, puedes refrescar el navegador, presionando (Ctrl+Shift+R | Ctrl+F5 o Shift+F5), o abrirlo directamente desde el Canal de Youtube... HAZ CLIC AQUI

     Si estás trabajando con Drupal, en muchas ocasiones te verás en la necesidad de instalar y poner en marcha, en tu entorno local, proyectos que han sido creados previamente por otros desarrolladores o miembros de tu equipo de trabajo, para que puedas realizar la implementación de algunos cambios, analizar el código del código o simplemente realizar tareas de testing en un entorno seguro.

     Tienes disponibles varios métodos de configuración para entornos locales HACIENDO CLIC AQUÍ

     Hoy te quiero mostrar, cómo trabajar en tu entorno local, basándonos en contenedores Docker y un proyecto existente de Drupal 9, para que puedas entender todos los pasos necesarios y activar cualquier proyectos sin la necesidad de invertir demasiado tiempo en el proceso.

   Activar un proyecto Drupal 9 existente utilizando Docker for Drupal

     Requisitos:

        - Tener instalado Docker y Docker compose en tu entorno local. HAZ CLIC AQUI

        - Tener los archivos del proyecto Drupal con el que vas a trabajar. Para descargar la estructura base vacía HAZ CLIC AQUÍ

        - Tener la base de datos del proyecto Drupal con el vas a trabajar

     Paso 1 - Descargar archivos servidor

     Antes de poder comenzar con el proceso de instalación del proyecto Drupal, necesitaremos poder ejecutar código PHP, acceder a nuestra base de datos por medio de Mysql y acceder a un servidor Apache o NGNIX.

     La buena noticia, es que exite un repositorio, en el que podremos encontrar todo lo necesario, se llama DockerForDrupal, desarrollado por el equipo de Wodby.

     Así que abriremos nuestra consola y, a continuación, clonaremos el respositorio, para tener disponibles todos los archivos:

git clone https://github.com/wodby/docker4drupal.git/ server

     Esto descargará todos los archivos en la carpeta server, y de esta manera, podremos copiar los archivos necesarios para cualquier proyecto de Drupal, sin la necesidad de tener que descargarlos nuevamente en el futuro.

     Para que no tengamos ningún tipo de conflicto, una vez copiemos los archivos necesarios en cualquier proyecto de Drupal, eliminaremos el directorio .git y el archivo docker-compose.override.yml

     Así que nos colocaremos dentro de la carpeta server y a continuación, ejecutaremos los siguientes comandos en nuestra consola:

     sudo rm -rf .git

     sudo rm -f docker-compose.override.yml

     Con estos dos comandos habremos eliminado cualquier posibilidad de conflicto en el futuro.

     Paso 2 - Copiar los archivos desde el servidor hacia Drupal

     En este punto, lo próximo que necesitaremos realizar el la copia de todos los archivos ubicados en la carpeta server, hacia la carpeta raíz del nuestro proyecto Drupal, puedes hacerlo por consola o desde el explorador de archivos de windows, arrastrándolos.

sudo cp -R server/ drupal9

     Paso 3 - Ajuste de configuración en el archivo .env

     Antes de poder comenzar a trabajar con los contenedores relacionados con nuestro proyecto Drupal, tendremos que explorar y modificar algunos ajustes, relacionados principalmente con el nombre del proyecto, la conexión con MySQL, entre otros.

     Para ello, abriremos el archivo (.env), que veremos en nuestra carpeta raiz, al haber copiado los archivos desde la carpetar server; en él encontraremos todas las definiciones por defecto, paa trabajar con un proyecto Drupal, incluyendo el nombre del proyecto, datos de conexión al servidor mysql, entre otros.

     Como la idea es trabajar con un proyecto que ya existe, deberíamos modificar algunos de estos datos, o simplemente, dejar los mismos y actualizar los datos de conexión en el archivo de Drupal llamado settings.php, dentro de la carpeta "web/sites/default/"

### PROJECT SETTINGS

PROJECT_NAME=drupal9_existente
PROJECT_BASE_URL=drupal9_existente.docker.localhost
PROJECT_PORT=8000

DB_NAME=drupal9_existente
DB_USER=drupal9_existente
DB_PASSWORD=drupal9_existente
DB_ROOT_PASSWORD=password
DB_HOST=mariadb
DB_PORT=3306
DB_DRIVER=mysql

     Paso 4 - Arranque y comprobación de contenedores Docker 

     Si todos los pasos anteriores no han devuelto ningún error o si ya los hemos corregido, entonces, podremos poner en marcha todos los contenedores, para continuar con el proceso de instalación de Drupal.

     El primer comando que tendremos que ejecutar para el arranque será el siguiente:

docker-compose up -d

     Si tienes instalado Make, también puedes utilizar este comando :

make up

     Si quieres saber qué es Make y cómo instalarlo, HAZ CLIC AQUÍ

     Esto se iniciará el proceso de activación de todos los cotenedores en segundo plano, para que podamos continuar en la misa ventana de nuestra consola, sin entrar en conflicto cada vez que ejecutemos código posteriormente.

 Paso 5 - Importación de la base de datos

     Ya tenemos todo lo necesario para que podamos acceder a nuestro proyecto de Drupal, los contenedores ya están funcionando, por lo que, si escribimos el dominio, configurado en el archivo .evn, dentro de nuesto navegador, lo siguiente que tendríamos que ver es nuesto proyecto funcionando, pero todavía no hemos importado la base de datos para que esto ocurra.

     Para importar la base de datos dentro de nuestro contenedor y que podamos ver luego el proyecto, tendremos que acceder directamente dentro del contenedor adecuado, para eso, ejecutaremos el comando que nos devolverá el nombre y estatus de todos los contenedores:

docker ps

     A continuacióbn, buscaremos el Identificador único para el contenedor de Mysql, y luego escribiremos el siguiente comando, sustituyendo los datos necesarios:

docker exec -it ID_CONTENEDOR bash

     Con esto podremos acceder al interior del contenedor seleccionado, que en este caso será el encargado de gestionar nuestra base de datos y a continuación, podremos ejecutar cualquiera de los comando de mysql.

     Para acceder al servidor Mysql y consultar, podremos ejecutar algo parecido al siguiente comando:

mysql -udrupal9_existente -pdrupal9_existente

     Con la anterior líneas, estaremos dentro de MySql y podremos ver el listado de bases de datos, de usuarios, permisos, etc.

     En nuestro caso, ya tenemos listo el archivo que vamos a importar, colocado dentro de la carpeta raíz de nuestro proyecto Drupal, por lo tanto, para accedere al contenedor y realizar la importación, bastará con ejecutar el siguiente comando, sustituyendo los datos por los correspondientes a tus propios contenedores:

docker exec -i f8e957b6b019 mysql -udrupal9_existente -pdrupal9_existente drupal9_existente < backup_existente.sql

   Ejecución de comandos con Composer y Drush

     Ya tenemos nuestro proyecto Drupal, listo para continuar trabajando, pero quizás necesitaremos realizar algunas actualizaciones, ya sea mediante el uso del gestor de paquetes Composer, o de la herramienta Drush.

     En estos casos, el contenedor desde el cual tendremos que ejecutar ambas operaciones, será el encargado de php, por lo que buscaremos nuevamente el nombre, con el comando docker ps, y una vez lo sepamos, la operación será muy parecida:

docker exec -it ID_CONTENEDOR bash

     Y posteriormente, podremos ejecutar cualquiera de los comandos de Composer o Drush.

     Posibles fallos durante el proceso:

       Permisos de Docker

     Es posible que al ejecutar el comando para levantar los contenedores de Docker docker-compose up - d,  la primera vez, te encuentres con un error relacionados con los permisos de ejecucion de los contenedores

     Para solucionarlo, ejecuta el siguiente comando, ubicándote dentro de la carpeta en la que quieres levantar los contenedores:

sudo chmod 777 /var/run/docker.sock

   Permisos en las carpetas

     Aunque estemos trabajando con los archivos de un proyecto existente, al momento de trasladar esos archivos dentro de los contenedores, es posible que tengamos que volver a otorgar permisos de escritura y lectura a la carpeta root.

     Para otorgar todos los permisos, nos colocaremos dentro de nuestra carpeta raiz y a continuación, ejecutaremos el comando siguiente:

sudo chmod -R 777 ./

   Ahora que ya sabemos Cómo instalar una distribución Linux dentro de Windows 10 usando el WSL, podemos pasar al siguiente nivel y explorar tantas opciones como nos hagan falta, para trabajar con cualquier proyecto, sin tener que cambiarnos de ordenador o trabajar con máquinas virtuales.

     La idea es facilitarnos la vida y que podamos implementar todas las herramientas necesarias sin la necesidad de invertir demasiado tiempo en ello.

     Por esta razón, hoy vamos a explicar cómo podremos configurar un entorno PHP para desarrollar un proyecto utilizando Symfony; uno de los Frameworks más potentes, robustos y seguros  que existen en el mercado.

     Aclaración antes de seguir

     Al momento de crear este artículo, existe un conocido error relacionado con el reloj en tiempo real con Ubuntu 20.04 y WSL2. Para evitar que surja este error, configuramos APT para congelar nuestra versión libc6 instalada a la de la distribución original emitiendo el siguiente comando:

sudo apt-mark hold libc6

     Tan pronto como hayamos ejecutado el anterior comando, podremos actualizar los paquetes de ubuntu ejecutando los siguiente:

sudo apt update

sudo apt upgrade

     Lo próximo que instalemos son las dependencias centrales para ejecutar la plataforma eZ (y muchas otras aplicaciones Symfony):

sudo apt install composer php-xml php-intl php-gd php-curl php-fpm

     En la línea anterior, he omitido el servicio de base de datos para aclarar que la plataforma eZ es compatible con las bases de datos MySQL / MariaDB y PostgreSQL. ASí que podrás elegir lo que mejor se adapte a tus necesidades. En nuestro caso usaremos MariaDB para este tutorial. Instala el servidor MariaDB y la extensión PHP MySQL:

sudo apt install mariadb-server php-mysql

     Ya estamos listos para arrancar la instancia del servidor MariaDB e iniciar sesión como usuario root:

sudo service mysql start

sudo mysql

     Vamos a añadir una base de datos para la plataforma eZ, Por lo que ejecutamos las siguientes declaraciones SQL:

CREATE DATABASE ezp;

GRANT ALL ON ezp.* TO 'ezp'@'localhost' IDENTIFIED BY 'wsl2ezp';

FLUSH PRIVILEGES;

EXIT;

     Y ahora comprobamos que podemos acceder a la base de datos:

mysql -uezp -pwsl2ezp ezp

     Ahora ya tenemos un entorno Linux con PHP, MariaDB y el administrador de paquetes Composer listo para funcionar:

     Ya que vamos a utilizar Symfony Encore para gestionar los activos de front-end, instalaremos el administrador de paquetes Yarn desde el repositorio del proyecto. De esta forma también instalará Node.js como dependencia:

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt update
sudo apt install yarn

     Instalando el CLI de Symfony

     A estas alturas, puede que hayas notado que falta en el procedimiento de instalación anterior es la A en LAMP y la E en LEMP. En lenguaje sencillo: nuestra pila no tiene un servidor web instalado. Tradicionalmente, una pila PHP ha incluido un servidor web separado. Un servidor HTTP completo sigue siendo para instalaciones de producción, pero como estamos en desarrollo utilizaremos una opción más simple: Symfony Local Web Server

     Symfony CLI es una aplicación de línea de comandos independiente que podremos instalar desde nuestra terminal WSL. Recuerda seguir las instrucciones de Linux, NO las de Windows:

wget https://get.symfony.com/cli/installer -O - | bash

     El código anterior lo instalará en nuestra carpeta de usuario, pero  podremos hacerlo disponible de forma global si ejecutamos el siguiente código, cambiando el NOMBRE DEL USUARIO por el tuyo:

sudo mv /home/nombre_usuario/.symfony/bin/symfony /usr/local/bin/symfony

     Ahora podemos verificar que nuestra pila está funcionando creando una nueva aplicación Symfony hello world y ejecutando el servidor web:

symfony new hola-mundo

cd hola-mundo

symfony serve

     Ha llegado el momento de abrir una ventana del navegador en http: // localhost: 8000 / para ver la aplicación en ejecución. La primera vez que lo ejecutes, es posible que Windows te pregunte si este tráfico está permitido. Ahora debería tener una aplicación Symfony básica ejecutándose en Windows usando WSL2 como se muestra en la captura de pantalla a continuación.

     Para obtener más detalles sobre cómo configurar TLS, múltiples versiones de PHP, etc., diríjase a los documentos de Symfony.

     Instalación de la Plataforma eZ y acceso a archivos

     El siguiente paso es instalar y ejecutar una aplicación Symfony completa. Esto funciona como en cualquier entorno Linux (¡porque es uno!). Así que vamos a instalar una copia de la plataforma eZ  y para ello utilizaremos. Éste se encargará de clonar los archivos desde el repositorio, verificará por nosotros las actualizaciones disponibles y a continuación instalar los paquetes necesarios usando:

composer create-project ezsystems/ezplatform ezplatform ^3 cd ezplatform

     Lo siguiente será instalar nuestra base de datos y para ello, necesitamos definir la configuración de la base de datos y ejecutar el instalador:

echo "DATABASE_URL=mysql://ezp:wsl2ezp@127.0.0.1:3306/ezp?serverVersion=10.3" > .env.local composer run-script ezplatform-install

Cuando se haya completado el proceso de instalación,  podremos ingresar al directorio del proyecto e iniciar el servidor web Symfony:

symfony serve

     El resultado mostrará que el servidor web Symfony detecta y usa la copia instalada de PHP-FPM:

     Ahora, si abrimos un navegador (en Windows) y nos dirigimos a http: // localhost: 8000 /, podremos ver la aplicación en ejecución. Para acceder a los archivos desde Windows, puede ejecutar el siguiente comando para abrir una ventana del Explorador de Windows en su directorio de trabajo actual:

explorer.exe .

     Desde aquí, podrás recoger las cosas y usar cualquier IDE en Windows (¡o incluso notepad.exe!) Que necesites usar para tu desarrollo.

      Aquí en drupaladicto.com nos gusta facilitar al máximo, todo lo relacionado con el desarrollo web, basándonos en Drupal, pero también en las diferentes herramientas complementarias, para que nuestro desarrollo pueda realizarse de forma optimizada, y adecuada según la necesidad de cada proyecto.

     Una de nuestras opciones preferidas, es el uso del subsistema para Windows, llamado WSL2, ya que nos permite interactuar tanto en Linux como en Windows, sin la necesidad de instalar máquinas virtuales, como por ejemplo VirtualBox, cuya configuración y espacio necesarios para ejecutarse, muchas veces, dificultan nuestras actividades, en lugar de facilitarnos la vida.

     Por esta razón, hoy aprenderemos a instalar y configurar el entorno de ejecución para JavaScript Node.js y los gestores de paquetes NVM ( Node Version Manager) y (NPM) (Node Package Manager), utilizando la distribución de Linux, Ubuntu 20.04 con WSL2 en un entorno Windows 11.

     Seguiremos los pasos de instalación publicados en la documentación de la Página Oficial de Microsoft, que nos menciona el siguiente detalle a tomar en cuenta:

     "Además de elegir si se desea realizar la instalación en Windows o WSL, al instalar Node.js es preciso elegir más opciones. Se recomienda usar un administrador de versiones, ya que las versiones cambian con mucha rapidez. Es probable que tenga que cambiar de versión de Node.js en función de las necesidades de los distintos proyectos en los que se trabaje. El administrador de versiones de Node, más comúnmente denominado nvm, es la forma más habitual de instalar varias versiones de Node.js.

     Siempre se recomienda quitar cualquier instalación existente de Node.js o npm del sistema operativo antes de instalar un administrador de versiones, ya que los distintos tipos de instalación pueden provocar conflictos extraños y confusos."

Instalación de nvm, node.js y npm

     Paso 1 : Abrir consola e iniciar sesión con nuestro usuario NO_ROOT, si no sabes, haz clic aquí

     Paso 2 : Instala cURL (una herramienta que se usa para descargar contenido de Internet en la línea de comandos) con: 

sudo apt-get install curl

     Paso 3 : Instala nvm con: 

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

     NOTA : En el momento de redactar este artículo, NVM v0.39.0 es la versión más reciente disponible. Puedes consultar la página del proyecto de GitHub para obtener la última versión de NVM y ajustar el comando anterior para incluir la versión más reciente.

     Paso 4 : Para verificar la instalación, escribe: command -v nvm... esto debería devolver "nvm"; si recibes "No se encuentra el comando" o ninguna respuesta, cierra el terminal actual, vuelve a abrirlo e inténtalo de nuevo. Obtén más información en el repositorio de GitHub de nvm.

     Paso 5 : Enumera qué versiones de Node están instaladas actualmente (en este momento no debe haber ninguna):

nvm ls

     Paso 6 : Instale las versiones de LTS actual y estable de Node.js. En un paso posterior, aprenderá a cambiar entre las versiones activas de Node.js con un comando nvm.

• Instale la versión LTS estable actual de Node.js (recomendada para aplicaciones de producción):

  nvm install --lts

• Instale la versión actual de Node.js (para probar las características y mejoras de Node.js más recientes, pero con más probabilidad de presentar problemas):

  nvm install node

     Paso 7 : Enumera qué versiones de Node están instaladas: nvm ls... ahora deberías ver las dos versiones que acabas de instalar.

     Paso 8 : Comprueba que Node.js está instalado y la versión predeterminada actualmente con: node --version. Después, comprueba que también tienes npm, con: 

npm --version

     (También puedes usar which node o which npm para ver la ruta de acceso utilizada para las versiones predeterminadas).

     Paso 9 : Para cambiar la versión de Node.js que deseas usar para un proyecto, crea un directorio de proyecto mkdir NodeTest, escribe el directorio cd NodeTest y, a continuación, escribe nvm use node, para cambiar a la versión actual, o bien nvm use --lts para cambiar a la versión de LTS. También puedes usar el número específico de cualquier versión adicional que hayas instalado, como nvm use v8.2.1. (Para enumerar todas las versiones de Node.js disponibles, usa el comando: nvm ls-remote).

     Si usas NVM para instalar Node.js y NPM, no es necesario usar el comando SUDO para instalar nuevos paquetes.

Si no ves el video, puedes refrescar el navegador, presionando (Ctrl+Shift+R | Ctrl+F5 o Shift+F5), o abrirlo directamente desde el Canal de Youtube... HAZ CLIC AQUI

Paso 5 Configuración del Virtual Host y el SSL

          Ahora que ya tenemos todos los requisitos previos a nuestra instalación de Drupal, que aprendimos en el artículo anterior Cómo Instalar LAMP usando WSL2 en Windows 10 (1era Parte), ha llegado el momento de comenzar los preparativos, para que podamos instalar en nuestro servidor local, cualquier tipo de web, en nuestro caso, desarrollada con Drupal 9, funcionando con un certificado SSL.

          Aunque en realidad, nuestro certificado será sólo para uso local, ya que no está autorizado, por ninguna de las entidades reales creadas con este propósito, nos permitirá realizar todo tipo de pruebas relacionadas con la seguridad como requisito, o por ejemplo, para el desarrollo de webs del tipo Progressive Web App (PWA), utilizando el módulo de Drupal, donde el certificado es obligatorio. 

         Existen varias herramientas y métodos con los que podríamos generar certificados SSL, una de las más conocidas es Certbot, que se puede instalar en Linux y que ofrece la posibilidad de generar certificados autofirmados, para utilizar en entornos locales, que es el tipo que vamos a emplear en esta ocasión. Pero en lugar de usarlo, he preferido utlizar Openssl, que ya viene instalado dentro de la distribución de Ubuntu que hemos seleccionado para este artículo, así que empecemos:

Cómo Instalar un Certificado SSL y activar HTTPS en Drupal 9

     1.- Ubicación de los certificados

          Como ya hemos dicho, el programa OpenSSL viene instalado en la distribución de Ubuntu 20.04, que es la que estamos utilizando. Para comprobarlo vamos a colocarnos en la carpeta donde se guardan los certificados de este programa y la utilizaremos como ubicación para los nuestros también. 

          Ejecutaremos los siguientes comandos, para ir hasta la carpeta y luego listar su contenido:

cd /etc/ssl

sudo ls

     2.- Generar los certificados

          Ahora que tenemos decidida la ubicación para nuestro certificado, y que ya hemos decidido el nombre que vamos a registrar, como dominio para nuestra web, lo siguiente que tendremos que hacer es ejecutar el siguiente comando sustituyendo drupal9.localhost, por el nombre o dominio con el que vamos a trabajar.

sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/ssl/drupal9.localhost.key -out /etc/ssl/drupal9.localhost.crt

         Explicación: 

              Este código nos generará la clave privada drupal9.localhost.key, que se utiliza para generar el certificado drupal9.localhost.crt, con una duración de un año  -days 365, y guarda dichos certificados en este caso en la ubicación que le hemos especificado, o sea dentro de /etc/ssl/.

         Una vez ejecutado el código, se mostrarán en pantalla varias preguntas que tendremos que rellenar e ir haciendo clic en aceptar, por cada respuesta que hayamos introducido:

     3.- Permisos y descarga de Drupal

          Lo primero que tendremos que hacer en esta ocasión, es crear la carpeta donde se alojará nuestro Drupal 9, que instalaremos usando Composer, y que colocaremos dentro de la carpeta publica html del Apache, para ello ejecutaremos el siguiente comando:

sudo mkdir -p /var/www/html/drupal9.localhost

     A continuación, daremos los permisos necesarios a nuestro usuario de apache para que podamos realizar la instalación sin compliacaiones:

cd /var/www/html/

sudo chown -R www-data:www-data drupal9.localhost/

  Ya podremos empezar la descarga de nuestros archivos de instalación de Drupal 9 con Composer utilizando el siguiente comando y sustituyendo la última parte por el nombre de nuestra carpeta recién creada.

composer create-project drupal/recommended-project drupal9.localhost

     De inmediato debería comenzar la descarga de los archivos de instalación desde el repositorio de Drupal.

     4.- Configuración del Virtual Host

          Una vez terminada la descarga de los archivos de Drupal, tendremos que configurar el acceso para poder comenzar con la instalación usando el navegador, para ello, crearemos el archivo de configuración correspondiente.

sudo nano /etc/apache2/sites-available/drupal9.localhost.conf

     A continuación copiamos dentro el siguiente código:

<VirtualHost *:80>
                ServerName www.drupal9.localhost
                DocumentRoot /var/www/html/drupal9.localhost/web

                # Redirect http to https
                RedirectMatch 301 (.*) https://www.drupal9.localhost$1
        </VirtualHost>

        <VirtualHost _default_:443>

                # Server Info
                ServerName www.drupal9.localhost
                ServerAlias drupal9.localhost
                ServerAdmin admin@drupal9.localhost

                # Web root
                DocumentRoot /var/www/html/drupal9.localhost/web

                # Log configuration
                ErrorLog ${APACHE_LOG_DIR}/drupal9.localhost-error.log
                CustomLog ${APACHE_LOG_DIR}/drupal9.localhost-access.log combined

                #   Enable/Disable SSL for this virtual host.
                SSLEngine on

                # Self signed SSL Certificate file
                SSLCertificateFile      /etc/ssl/drupal9.localhost.crt
                SSLCertificateKeyFile /etc/ssl/drupal9.localhost.key

                <Directory "/var/www/html/drupal9.localhost/web">
                        Options FollowSymLinks
                        AllowOverride All
                        Require all granted
                </Directory>

                <FilesMatch "\.(cgi|shtml|phtml|php)$">
                                SSLOptions +StdEnvVars
                </FilesMatch>
                <Directory /usr/lib/cgi-bin>
                                SSLOptions +StdEnvVars
                </Directory>

                BrowserMatch "MSIE [2-6]" \
                                nokeepalive ssl-unclean-shutdown \
                                downgrade-1.0 force-response-1.0
                # MSIE 7 and newer should be able to use keepalive
                BrowserMatch "MSIE [17-9]" ssl-unclean-shutdown

        </VirtualHost>

     Reemplace el nombre de dominio www.drupal9.localhost con el nombre de dominio de su sitio web Drupal.

     Guarda el archivo y cierra.

     Ahora comprueba si todo está correcto, ejecutando el siguiente comando:

apachectl configtest

    Si ves el mensaje "Syntax ok", entonces la configuración de Apache es correcta.

    Entonces podremos activar el Host Virtual de Drupal y reiniciar el servidor para que se ejecuten los cambios:

a2ensite drupal9.localhost

sudo service apache2 restart

Si no ves el video, puedes refrescar el navegador, presionando (Ctrl+Shift+R | Ctrl+F5 o Shift+F5), o abrirlo directamente desde el Canal de Youtube... HAZ CLIC AQUI

      Antes de trabajar en cualquier proyecto web, deberíamos contar con un entorno completo, que incluya todo lo necesario para que nuestra aplicación funcione correctamente, además de ofrecernos un lugar estable donde podamos realizar todo tipo de pruebas y procedimientos.

     Aunque ya hemos explicado en otro artículo todo lo que necesitas saber sobre Cómo instalar Drupal 9 usando Docker en Windows 10 Home, hoy te voy a contar cómo realizar la instalación completa de un servidor Linux que incluya, además, el Apache, Mysql y PHP, con la respectiva configuración del dominio para que puedas instalar Drupal en tu servidor local.

   Cómo Instalar LAMP usando WSL2 en Windows 10

      Paso 1 Instalación y configuración de WSL2 en Windows

          Para no repetirme, puedes leer todo el proceso de instalación y configuración del WSL2 para Windows 10, en el artículo Cómo instalar Drupal 9 usando Docker en Windows 10 Home (1era Parte), y una vez hayas realizado la instalación podrás continuar con el siguiente paso.

          Además, antes de continuar, te recomiendo instalar la nueva terminal de Windows 10, para que puedas realizar operaciones simultáneas usando diferentes pestañas, te cuento cómo hacerlo en este artículo Instalación y configuración de Terminal Windows

     Ahora, antes de continuar, debe saber que puede omitir casi todos los pasos a continuación y simplemente hacer: sudo apt install lamp-server ^ phpmyadmin. Sin embargo, yo intenté hacerlo de esta forma y me dio varios errores, por lo que, en mi opinión recomiendo la opción "Larga", que además te dará control total sobre tu servidor y servicios instalados. 

      Paso 2 - crear un usuario No Root para la ejecución del código:

          El usuario root es el usuario administrativo en un entorno Linux que tiene privilegios muy amplios. Debido a su inmenso poder, no se recomienda usarlo de forma regular. 

          El siguiente paso es configurar una cuenta de usuario alternativa, con un alcance de influencia reducido para el trabajo diario. Y podremos usar el la opción SUDO, cuando necesitemos permisos especiales sin tener que cambiar de usuario.

          Con el siguiente código, voy a crear un usuario nuevo, que no será root, y que utilizaremos de aquí en adelante para el resto de la configuración.

          Como por defecto en la instalación de ubuntu hemos creado el usuario root, ejecutaremos el siguiente comando con el prefijo sudo, y una vez complementada la información del nuevo usuario, que si no quieres rellenar la info puedes presionar ENTER en cada pregunta, como he hecho para este ejemplo.

          Luego abriremos otra pestaña en la terminal de windows, si no la tienes instalada aprende cómo hacerlo en Instalación y configuración de Terminal Windows,  para no perder, de momento los accesos como root y luego continuaremos con el procedimiento:

adduser noroot_user

          Una vez creado el nuevo usuario, abriremos la nueva pestaña en la terminal y ejecutaremos el siguiente código, que nos permitirá acceder con los datos de nuestro nuevo usuario:

su - noroot_user

     Paso 3 - Otorgarle privilegios root a nuestro nuevo usuario:     

          Ahora, tenemos una nueva cuenta de usuario con privilegios de cuenta regulares. Sin embargo, es posible que a veces necesitemos realizar tareas administrativas. Para evitar tener que cerrar la sesión de nuestro usuario normal y volver a iniciarla como la cuenta root, podemos configurar lo que se conoce como "superusuario" o privilegios de root para nuestra cuenta normal. Esto permitirá a nuestro usuario normal ejecutar comandos con privilegios administrativos poniendo la palabra sudo antes de cada comando.

          Como todavía tenemos abierta la pestaña de la terminal, donde habíamos iniciado sesión como root, vamos a ejecutar desde allí el siguiente código para otorgar los nuevos privilegios a nuestro usuario noroot_user:

usermod -aG sudo noroot_user

          Una vez otorgados los permisos de root, tendremos que cerrar la otra pestaña, donde está el usuario noroot_user, para poder comenzar a utilizarlos con los permisos recién adquiridos.

     Paso 4 - Instalación del Servidor Apache

         Para instalar apache, vamos a necesitar dos comando:

sudo apt install apache2

sudo service apache2 start

     Una vez instalado el servidor Apache, probemos que todo funciona, accediendo en el navegador a la url http://localhost. Deberíamos ver en pantalla la siguiente imagen:

     Si todo es correcto, entonces podremos continuar y habilitaremos los módulos que vamos a necesitar, como el "Rewirte" o el "SSL"

sudo a2enmod rewrite

sudo a2enmod ssl

     Y a continuación, para que se efectúen los cambios en el servidor, necesitaremos reiniciarlo usando el comando:

sudo service apache2 restart

     Llegado a este punto, te recomendaría ajustar la configuración de Apache para que los permisos coincidan con su nombre de usuario. En otras palabras, cuando hagas una lista de archivos, esta configuración de nombre de usuario que ingrese en Apache será la misma que la del propietario de los archivos en su sistema de archivos Linux. De esa forma, Apache tendrá permisos para modificar los archivos y carpetas de tu sitio. Si no lo haces, es posible que elementos como Grav y WP no funcionen correctamente o no funcionen en absoluto. Así que dirígete a este archivo y haz el siguiente cambio:

sudo nano /etc/apache2/envvars

export APACHE_RUN_USER=your_user

export APACHE_RUN_GROUP=your_user

     Y a continuación, una vez hayas editado el archivo envvars, para que se efectúen los cambios en el servidor, necesitaremos reiniciarlo usando el comando:

sudo service apache2 restart

     Ahora podemos comprobar si ambos módulos han sido activados correctamente, ejecutando el siguiente comando:

apache2ctl -M | egrep 'ssl|rewrite'

     Entonces en nuestra consola, si todo está correcto, deberíamos ver el siguiente mensaje:

#Enabled
 rewrite_module (shared)
 ssl_module (shared

     Paso 5 - Instalación y configuración del Servidor de Base de datos MariaDB

          Lo primero que necesitaremos es instalar el servidor, ejecutando el siguiente comando:

sudo apt install mariadb-server mariadb-client

     Importante: No se le pedirá que cree una contraseña, pero en una instalación local está bien. Y técnicamente no es inseguro de todos modos, ya que significa que solo aquellos con privilegios de sudo pueden acceder al servidor MySQL.

     Ahora necesitamos iniciar el servidor MySQL ejecutando el siguiente comando:

sudo service mysql start

     Paso 6 - Instalación y configuración PHP

          En el caso de PHP, además de instalar la versión que vamos a utilizar, tendremos que realizar algunas modificaciones, como la activación de varias librerías, y otras modificaciones recomendadas para trabajar con Drupal, como el tiempo de ejecución o el máximo de tamaño de subida de archivos, pero vamos por partes, primero instalaremos php y activaremos algunas librerías necesarias:

sudo apt install php7.4-common php7.4-mysql php7.4-xml php7.4-xmlrpc php7.4-curl php7.4-gd php7.4-imagick php7.4-cli php7.4-dev php7.4-imap php7.4-mbstring php7.4-opcache php7.4-soap php7.4-zip php7.4-intl -y

          Es posible que también deba instalar módulos según los requisitos de su aplicación. Utilice el siguiente comando para buscar módulos PHP 7 disponibles en el repositorio de paquetes.

sudo apt-cache search php7*

          En nuestro caso, vamos a instalar los siguientes "módulos" de php:

sudo apt install php php-cli php-fpm php-json php-pdo php-mysql php-zip php-gd  php-mbstring php-curl php-xml php-pear php-bcmath

     Por últimos, vamos a realizar algunos de los cambios de configuración del PHP.ini que nos ayudarán y evitarán posibles errores una vez instalemos nuestro Drupal. Para ello, abriremos el archivo de configuración de php "php.ini" y realizaremos las modificaciones correspondientes:

sudo nano /etc/php/7.4/apache2/php.ini

• max_execution_time = 600
• post_max_size = 64M
• short_open_tag
     Default Value: On
• memory_limit = -1
• upload_max_filesize = 100M

     Una vez actualizados los cambios en el archivo de configuración de apache, volveremos a reiniciar nuestro servidor para que se guarden dichos cambios, para ello ejecutaremos el comando:

sudo service apache2 restart

     Ahora que PHP está instalado, para probar si está funcionando, cree un archivo de prueba llamado phpinfo.php en el directorio raíz predeterminado de Apache2…. (/ var / www / html /)

sudo nano /var/www/html/phpinfo.php

     Luego, escriba el contenido a continuación y guarde el archivo.

<?php phpinfo( ); ?>

     A continuación, abra su navegador y busque el nombre de host o la dirección IP del servidor seguido de phpinfo.php

http://localhost/phpinfo.php

Debería ver la página de prueba predeterminada de PHP, como esta:

     Una vez comprobado que todo está correcto, tendremos que borrar este archivo ya que es información que implica riesgos de seguridad, para ello ejecutaremos el siguiente comando:

rm -f /var/www/html/info.php

      Paso 7 - Instalación Interfaz Usuario para administrar MySql

          Aunque según los requerimientos de tu aplicación, puede que no te haga falta un entorno gráfico, para la administración de tus bases de datos y tablas, porque lo realizarás usando comandos de tu consola, te recomiendo instalar esta pequeña aplicación que te servirá de ayuda:

sudo apt install adminer

     Casi hemos terminado. Hay un problema para todos aquellos que cambiaron la configuración de usuario / grupo de Apache anterior. El administrador accede y escribe en su carpeta de sesiones de PHP, por lo que debe otorgarle a su usuario (el usuario que configuró en Apache) los permisos de la carpeta correspondiente a esa carpeta. Puedes realizar el cambio ejecutando el siguiente comando:

cd /var/lib/php

sudo chown -R your_user:your_user sessions

     Ahora sí, lo último que nos faltará es activar Adminer, reiniciar Apache nuevamente, por supuesto, y luego verlo. Comience con estos dos comandos:

sudo a2enconf adminer.conf

sudo service apache2 restart

     Para comprobar el Adminer funciona correctamente escribe en el navegador la url http://localhost/adminer/

     ¡Pero necesitamos un nombre de usuario para iniciar sesión ahora! Así que sigamos adelante y hagamos eso. Recuerde que todo esto es solo para desarrolladores locales, por lo que las preocupaciones de seguridad habituales relacionadas con la creación de un superusuario no se aplican realmente. Nunca hagas esto en un sitio en vivo. Siempre.

     Así que inicie MySQL así:

sudo mysql

    Luego ingrese los siguientes comandos, Primero creamos el usuario que funcionará como root, luego le daremos los permisos para que pueda hacer cualquier tarea con las bases de datos, a continuación reseteamos la tabla de permisos y por último, saldremos de servidor de base de datos:

CREATE USER 'user_name'@'localhost' IDENTIFIED BY 'your_password';

GRANT ALL PRIVILEGES ON * . * TO 'user_name'@'localhost';

flush privileges;

exit

     Ahora que haz creado un superusuario, ya podrás iniciar sesión en Adminer y comenzar a trabajar con tus bases de datos y tablas.

* Usuario con permisos específicos

     Aunque tenemos un Super usuario con el cuál podremos realizar, todas las operaciones en nuestro servidor de base de datos, es muy recomendable limitar los accesos a la base de datos específica en cada proyecto. Por esta razón, a continuación vamos a crear un usuario y una base de datos específica para nuestro proyecto.

     Primero nos vamos a loguear como Super usuario y una vez dentro, ejecutaremos cada una de las líneas siguientes, en las que primero crearemos la base de datos, luego el usuario con sus datos de acceso, a continuación le daremos todos los permisos, específicos para la tabla en concreto y por último el reseteo de la tabla de permisos:

sudo mysql;

CREATE DATABASE drupaldb;

CREATE USER drupaluser@localhost IDENTIFIED BY 'drupaluser@';

GRANT ALL PRIVILEGES ON drupaldb.* to drupaluser@localhost identified by 'drupaluser@';

FLUSH PRIVILEGES;

EXIT

     Si queremos ver el listado de las bases de datos que tenemos creadas al momento, entraremos a MySql y luego ejecutamos el siguiente comando:

SHOW DATABASES;

     Para borrar una base de datos (Cuidado porque se perderá toda la información), ejecutaremos:

DROP DATABASE mi_bd_para_borrar;

     Para ver el listado de usuarios creados, ejecutaremos el siguiente comando:

SELECT User FROM mysql.user;

     Para borrar un usuario específico:

DROP USER 'usuario'@'localhost';

     Paso 8 - Configuración del Virtual Host y el SSL

          Para poder trabajar con certificados SSL, es necesario prestar atención en varios detalles previos, por eso, he preferido hacerlo en otro artículo con su video propio, que podrás leer y ver haciendo clic aqui  Ver siguiente artículo

Si no ves el video, puedes refrescar el navegador, presionando (Ctrl+Shift+R | Ctrl+F5 o Shift+F5), o abrirlo directamente desde el Canal de Youtube... HAZ CLIC AQUI

     Qué es Solr y para que nos servirá?

         Apache Solr es una plataforma de búsqueda de código abierto escrita en Java. Solr proporciona búsqueda de texto completo, sugerencias de ortografía, ordenación y clasificación de documentos personalizados, generación de fragmentos y resaltado. Apache Solr se ejecuta como un servidor de búsqueda de texto completo independiente. Sus API de HTTP / XML y JSON similares a REST lo hacen utilizable desde la mayoría de los otros lenguajes de programación populares.

          Este tutorial le ayudará a instalar Apache Solr 8.9.0 en sistemas Ubuntu 20.04 LTS.

     Instalación de Apache Solr en Ubuntu 20.04 con WSL2 en Windows 11

        En nuestro caso, realizaremos la instalación dentro de un servidor Linux, con Ubuntu 20.04 instalado en Windows 10, a través del WSL2, que ya hemos explicado en anteriores videos, si quieres saber cómo Haz clic en este enlace, además para la instalación utilizaremos nuestro usuario con noroot_drupaladicto, que tiene permisos para ejecutar comando de Root, sin riesgos de cargarnos nada por accidente. Eso también está explicado en el anterior enlace.

     Prerrequisito - Asegurarnos de que tenemos los paquetes de Ubuntu actualizados

          Es muy importante, que antes de realizar cualquier nueva instalación, nos aseguremos de que todos los paquetes de nuestro Linux estén actualizados, para disponer de las correcciones más actuales sobre seguridad, compatibilidades, etc.

          Para ello abriremos nuestra consola, y una vez iniciemos sesión con nuestro usuario NOROOT, ejecutaremos el siguiente código:

sudo apt update && sudo apt upgrade

     Paso 1 - Instalar Java

           Apache Solr 8 requería de Java 8 o superior para ejecutarse. Así que tendremos que asegurarnos de que nuestro sistema cumpla con los requisitos de Java de Apache Solr. Si no tenemos Java instalado, ejecutaremos el siguiente comando:

sudo apt install openjdk-11-jre-headless 

           Para confirmar la versión de Java que tenemos instalada, ejecutaremos el siguiente comando:

java -version 

     Paso 2 - Instalar Solr en Ubuntu

          Ahora descargaremos la versión requerida de Solr de su sitio oficial o espejos. O podremos usar el siguiente comando para descargar Apache Solr 8.9.0 en nuestro sistema.

cd /opt 

sudo wget https://archive.apache.org/dist/lucene/solr/8.9.0/solr-8.9.0.tgz

        A continuación, extraeremos la secuencia de comandos del instalador del servicio Apache Solr, del archivo de almacenamiento de Solr descargado. Ejecutando el instalador, seguido del archivo de almacenamiento, como se muestra a continuación:

sudo tar xzf solr-8.9.0.tgz solr-8.9.0/bin/install_solr_service.sh --strip-components=2

sudo bash ./install_solr_service.sh solr-8.9.0.tgz

     Paso 3 - administrar el servicio Solr

          Solr está configurado como un servicio en nuestro sistema. Podremos usar los siguientes comandos para Detener e iniciar el servicio Solr.

          Podremos utilizar los siguientes comandos para detener e iniciar el servicio de solr de Apache:

sudo service stop solr

sudo service start solr

        También podremos confirar su estatus 

sudo service solr status

     Paso 4 - crear una colección en Solr

          Después de la instalación exitosa de Solr en su sistema. Crearemos la primera colección en Apache Solr usando el siguiente comando:

sudo su - solr -c "/opt/solr/bin/solr create -c micoleccion -n data_driven_schema_configs" 

        El código anterior nos imprimirá en pantalla el siguiente mensaje, confirmando la creación de micoleccion:

Created new core 'mycollection'

     Paso 5 - acceder al panel de administración de Solr

        El Apache Solr predeterminado se ejecuta en el puerto 8983. Por lo tanto, podremos acceder a nuestro servicio Solr, usando este puerto en nuestro navegador web utilizando la IP del servidor o el nombre de dominio.

http://localhost:8983/

        Ahora, seleccionaremos "micoleccion" en el menú desplegable, Core Selector, en la barra lateral izquierda. Esto nos mostrará las estadísticas de la colección seleccionada.