Este documento describe paso a paso cómo instalar, configurar e integrar MariaDB dentro de un contenedor Alpine Linux en Docker. Esta guía cumple con los criterios de evaluación de la UF2 (Implementación) y la UF4 (Documentación) del módulo de despliegue.
Acceder al contenedor MySQL
Antes de nada, asegúrate de que el contenedor mysql esté en ejecución. Esto te abrirá una consola interactiva dentro del contenedor, permitiéndote ejecutar comandos como si estuvieras en un sistema Linux.
Instalación de MariaDB
Ahora debemos instalar MariaDB, que es un sistema de gestión de bases de datos compatible con MySQL, ideal para Laravel. Este comando actualiza el índice de paquetes para que puedas descargar las últimas versiones disponibles.
- mariadb: instala el servidor de base de datos.
- mariadb-client: permite conectarte mediante el comando mariadb.
- nano: editor de texto básico útil en Alpine.
Instalar y Ejecutar LARAVEL usando DOCKER MUY FÁCIL
Preparación del entorno de MariaDB
Antes de iniciar el servidor, necesitas crear los directorios necesarios para que MariaDB funcione correctamente.
- mkdir -p: crea /run/mysqld si no existe.
- chown: asigna los permisos correctos de usuario y grupo (mysql:mysql) para evitar errores de ejecución.
Inicialización de la base de datos
Este paso prepara la estructura interna que necesita MariaDB para funcionar.
- --user=mysql: define el usuario que inicializa el sistema.
- --datadir: ubicación donde se guardan los archivos binarios de las bases de datos.
Este comando no lanza el servidor, solo prepara el sistema de ficheros.
Iniciar el servidor MariaDB
El símbolo & hace que el proceso corra en segundo plano. Deberías ver procesos como mysqld.
Acceder al prompt interactivo de MariaDB
Si todo ha ido bien, verás el prompt interactivo de MariaDB para ejecutar consultas SQL.
Crear base de datos y usuario para Laravel
Laravel necesita una base de datos y un usuario con permisos para operar.
Explicación:
- CREATE DATABASE josue_db; → Crea la base de datos para tu proyecto Laravel.
- → Crea un usuario accesible desde cualquier IP.
- GRANT ALL PRIVILEGES... → Le da control total sobre la base de datos.
- FLUSH PRIVILEGES; → Aplica los cambios.
Puedes cambiar el nombre de usuario, la base de datos y la contraseña según tus preferencias.
Esto creará las tablas por defecto (users, password_resets, etc.).
Esto detiene el proceso y lo arranca de nuevo. Útil si haces cambios en configuración o quieres reiniciar el entorno sin salir del contenedor.
Checklist Evaluación UF2/UF4
A continuación, se presenta una tabla de evaluación para verificar la correcta implementación y configuración de MariaDB en Docker.
| Requisito | Cumplido |
|---|---|
| MariaDB instalado correctamente (Alpine) | ✅ |
| Inicialización del sistema de datos | ✅ |
| Base de datos josue_db creada | ✅ |
| Usuario sail creado con permisos correctos | ✅ |
| Laravel conectado a la base de datos | ✅ |
| Documentación clara con capturas | ✅ |
Conexión a la base de datos local
Si usa la configuración de red predeterminada para las imágenes de contenedor de Docker Linux, es probable que la cadena de conexión sea Server=localhost;Port=3306;Uid=root;Pwd=<your-password>;. Reemplace <your-password> por la contraseña que estableció anteriormente en esta guía.
Archivo de configuración dab-config.json
Consulta el archivo de configuración dab-config.json actual. En este ejemplo, la aplicación se ejecuta en localhost el puerto 5000.