Cómo utilizar Laravel con Docker – La Guía Definitiva

¿Quieres pasar al siguiente nivel y utilizar Docker para tus desarrollos en Laravel? Me alegro mucho que así sea y en esta guía vamos a explicar como instalar y utilizar Laravel junto con Docker, para que tus desarrollos funcionen exactamente igual en tu computadora como en producción.

¿Qué es Docker?

Docker es una tecnología que nos permite empaquetar nuestra aplicación junto con sus dependencias: MySQL, Redis, Apache o Nginx, etc. A estos paquetes se los llama Contenedores y podemos desplegarlos en cualquier maquina o servidor haciendo que nuestra aplicación funcionara exactamente igual en cualquier ambiente.

Diferencias entre Docker y Homestead de Laravel

Tal vez te estés preguntando ¿cuál es la diferencia entre Docker y Homestead? y, ¿por que no utilizar Homestead que tiene el respaldo de los creadores de Laravel? Bueno, la diferencia es que Homestead es un box de Vagrant, el cual corre sobre una maquina virtual y Docker corre sobre nuestra computadora.

Las maquinas virtuales son programas que simulan ser computadoras dentro de nuestra PC. Necesitan tener instalado su propio sistema operativo y programas necesarios para nuestra aplicación. Para esto, la maquina virtual toma parte del disco duro y memoria RAM para poder funcionar.

Por lo tanto, una parte de los recursos están asignados al sistema operativo de la maquina virtual.

En cambio, los contenedores de Docker no necesitan de una maquina virtual ya que utilizan directamente los recursos de la computadora, cargando solamente la aplicación y las dependencias que necesita tu aplicación para funcionar. Utilizan el sistema operativo y los recursos de nuestra PC y no es necesario que instalemos nada para nuestro ambiente.

Otra de las grandes diferencias es que Homestead fue pensando para ser utilizado únicamente en el ambiente de desarrollo. Pero los contenedores de Docker podemos utilizarlos en cualquiera de nuestros ambientes, incluido producción.

Paso 1 – Instalar Docker

Instalar Docker es realmente sencillo, para este ejemplo vamos a instalarlo en una computadora con Ubuntu 16.04. Debemos abrir una terminal y ejecutar los siguientes comandos.

Primero actualizamos y agregamos los paquetes necesarios de Docker:

$ sudo apt-get update
$ sudo apt-get install apt-transport-https ca-certificates curl software-properties-common
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
$ sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

Ahora, instalamos Docker CE (CE es la versión gratuita de Docker):

$ sudo apt-get update
$ sudo apt-get install docker-ce

¡Y listo! Con estos simples comandos ya tenemos instalado Docker para nosotros. Para verificar que se haya instalado correctamente, podemos ejecutar el siguiente comando y deberíamos ver la versión de Docker:

$ docker --version
Docker version 18.09.1, build 4c52b90

Paso 2 – Instalar Docker-Compose para utilizar con Laravel

Como vamos a utilizar Laravel junto con distintos servicios (como MySQL, Nginx, Redis, etc.) Docker-Compose nos permite crear y administrar los contenedores necesarios para nuestro proyecto de Laravel.

Instalar la ultima versión de Docker-Compose en Linux

La instalación de docker-compose es muy fácil. Debemos ejecutar el siguiente comando:

$ sudo curl -L "https://github.com/docker/compose/releases/download/1.23.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

Y aplicamos los permisos necesarios:

$ sudo chmod +x /usr/local/bin/docker-compose

¡Listo! Para verificar que docker-compose se instalo correctamente, ejecutamos el siguiente comando. Si vemos la versión, es que la instalación se realizó correctamente:

$ docker-compose --version
docker-compose version 1.23.2, build 1110ad01

Paso 3 – Generar contenedores para Laravel

Antes de instalar Laravel, debemos generar los contenedores. Para esto, vamos a utilizar Docker-Compose y LaraDock.

LaraDock es una herramienta creada por la comunidad de Laravel y nos brinda todo lo necesario para tener un entorno PHP completo.

Instalar y configurar LaraDock

Clonamos el repositorio de LaraDock:

$ git clone https://github.com/Laradock/laradock.git
$ cd laradock
$ cp .env-example .env

Editamos el archivo .env (este es el archivo de entorno de LaraDock, no tiene relación con el que conocemos de Laravel).

Buscamos la variable DOCKER_HOST_IP y modificamos su valor por la IP de localhost.

$ nano .env

Generar contenedores para Laravel

Si listamos los archivos que se encuentran en la carpeta laradock, veremos todos los servicios que nos provee:

Para nuestro ejemplo, vamos a generar contenedores para Nginx, MySQL, Phpmyadmin que son mas que necesarios para nuestro proyecto de Laravel.

$ sudo docker-compose up -d nginx mysql phpmyadmin

Este comando comenzará a descargar los servicios que le pasamos al comando. Como es la primera vez que lo hacemos, tardará unos minutos.

Al finalizar, ya tendremos nuestros contenedores corriendo y los podemos ver con el comando docker-compose ps

En el contenedor laradock_workspace_1 es donde trabajaremos con Laravel. Así que, debemos entrar al contenedor e instalar un nuevo proyecto de Laravel (o clonar tu proyecto si ya tienes uno existente).

Para esto, vamos a ejecutar el programa bash en el contenedor y así tendremos una terminal en el contenedor:

$ sudo docker-compose exec workspace bash

Como verán, no hace falta poner laradock_workspace_1, solo con workspace es suficiente.

Ahora nuestro propt se verá algo así: root@0bd8859e9750:/var/www y si listamos los archivos que contiene la carpeta /var/www/, nos mostrará los archivos de nuestra computadora…😱 ¿Qué paso aquí? Bueno, el contenedor workspace por defecto mapea con el directorio raíz de nuestra computadora (puedes modificar la ruta por defecto en el archivo .env de Docker).

Ahora llego el momento de instalar Laravel:

Paso 4 – Instalar Laravel dentro del Contenedor de Docker

Para instalar Laravel dentro del contenedor es lo mismo de siempre. Puedes clonar un proyecto que tengas en Github, o puedes instalar un nuevo proyecto de Laravel, yo haré esto ultimo:

root@0bd8859e9750:/var/www# composer create-project --prefer-dist laravel/laravel blog
root@0bd8859e9750:/var/www# cp .env.example .env
root@0bd8859e9750:/var/www# artisan key:generate
root@0bd8859e9750:/var/www# exit
$ cd ..
$ cd blog/
$ sudo chmod -R 777 storage bootstrap/cache

Ahora debemos hacer que Nginx apunte a nuestra carpeta de Laravel. Para esto editamos el archivo .env de LaraDock y ponemos el nombre de la carpeta de nuestro proyecto en la variable APP_CODE_PATH_HOST, en mi caso se llama blog.

$ nano .env
APP_CODE_PATH_HOST=../blog

Reiniciamos los servicios de docker:

$ sudo docker-compose down
$ sudo docker-compose up -d nginx mysql phpmyadmin

Con esto ya podemos ingresar a http://localhost/ con nuestro navegador y veremos la aplicación de Laravel corriendo correctamente.

¡👏👏👏!

Paso 5 – Crear Base de Datos para Laravel

Para crear una base de datos que utilizará Laravel, lo podemos hacer con phpmyadmin o por comandos SQL. Vamos a hacerlo por SQL.

Configurar contenedor MySQL para utilizar en Laravel

Editamos el archivo .env de LaraDock y buscamos las variables MYSQL_DATABASE y MYSQL_ROOT_PASSWORD, a esta última debemos ingresar una contraseña para el usuario root de nuestra base de datos.

$ nano .env

También debemos editar el archivo my.cnf que se encuentra en la carpeta de laradock y agregar la ultima linea que se ve en la imagen:

$ nano laradock/mysql/my.cnf

Guardamos las modificaciones y salimos del archivo.

Ahora ingresamos al contenedor de MySQL, le damos los permisos necesarios a nuestro usuario y creamos la base de datos:

$ sudo docker-compose exec mysql bash
root@c9525b8e5105:/# mysql -u root -p

mysql> ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'root';
mysql> ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'root';
mysql> ALTER USER 'default'@'%' IDENTIFIED WITH mysql_native_password BY 'secret';

mysql> create database blog;
mysql> show databases;

+--------------------+
| Database |
+--------------------+
| blog |
| default |
| information_schema |
| mysql |
| performance_schema |
| sys |
+--------------------+
6 rows in set (0.17 sec)

Ya casi terminamos. Ahora debemos configurar el archivo .env de Laravel para ingresar los datos de la conexión a la base de datos. Nos desconectamos de MySQL y salimos del contenedor.

mysql> exit
root@c9525b8e5105:/# exit
$ cd ../blog/
$ nano .env

Reiniciamos todos los contenedores:

$ cd ../laradock/
$ sudo docker-compose down
$ sudo docker-compose up -r nginx mysql

Paso 6 – Ejecutar migraciones

Para ejecutar las migraciones debemos ingresar a la carpeta laradock, entrar al contenedor workspace y ejecutar el comando artisan.

$ sudo docker-compose exec workspace bash
root@0031095f86de:/var/www# artisan migrate

Listo, ya tenemos todo instalado y podemos empezar a desarrollar nuestra aplicación de Laravel. No hace falta que ingreses al contenedor workspace para desarrollar, lo podes hacer directamente desde la carpeta donde esta tu proyecto.

Esto fue todo, espero que les haya servido esta guía para utilizar Laravel con Docker. Cualquier duda la pueden dejar en los comentarios. En un próximo artículo voy a escribir como activar SSL con Docker, como lo hicimos con Apache y Nginx. Si te gusto, no dudes en compartirlo. 😁👍