Leer en Español

docker-compose-moodle quickly builds a local workspace for Moodle (Apache2, PHP-FPM with XDEBUG y Postgres) using containers for each of its main components. The local workspace is build and manage by Docker Compose

1. Docker installed. Check out how to install Docker in Ubuntu
2. Docker Compose installed. Check out how to install Docker Compose in Ubuntu
3. Download this repo: git clone https://github.com/jobcespedes/docker-compose-moodle.git && cd docker-compose-moodle
4. Clone Moodle repo: git clone -b MOODLE_35_STABLE https://github.com/moodle/moodle.git html
5. Deploy with: docker-compose up -d

The following table sums up Docker Compose file structure:

The following table describes environment variables in .env:

Inside project folder

1. Stop project

docker-compose stop
# docker-compose stop <service>

2. Start project

docker-compose start
# docker-compose start <service>

2. Run project

docker-compose up -d
# Different project name
# docker-compose -p my-proj up -d

3. Remove project

docker-compose down
# Remove volumes too
# docker-compose --volumes
# With different project name:
# docker-compose -p my-proj down

4. Logs

docker-compose logs
#docker-compose logs <service>

5. Useful Docker commands

# List containers
docker ps
# List images
docker images
# Enter a container
 docker exec -it <container_name> bash
# Check container log
docker logs <container_name> -f
# Remove dangling images
docker rmi $(docker images -f "dangling=true" -q)

Restore a specific database when postgres service starts

A database can be automatically restored when postgres service starts. By placing a dump file inside 'db_dumps' folder and naming it "dump-init.sql.gz", postgres container will try to restore that file as initial database.

IMPORTANT: Depending of dump-init.sql.gz size, database initial availability could be delayed

Use idekey PHPTEST

Debug config for IDE PHPStorm:

1. Add server:
   • Settings -> Languages -> PHP -> Servers
2. Add PHP remote debug
   • Run / Debug Configurations -> PHP remote debug
   • Use server created in step #1 and set idekey PHPTEST
3. Enable Start listening for PHP Debug Connections

Config pgadmin4

1. Go to http://localhost:5050
2. In File -> Preferences -> Binary paths set usr/bin
3. Add new server:
   • Tab General
     • Name: Any name you want
   • Tab Connection
     • Host name/address: postgres
     • Host Username: user
     • Host Password: password
   • Save

Ubuntu 16

Instructions from Docker Docs

sudo apt-get update

# Extra packages
sudo apt-get install -y curl \
    linux-image-extra-$(uname -r) \
    linux-image-extra-virtual

# Source config
sudo apt-get install -y apt-transport-https \
                       software-properties-common \
                       ca-certificates

## Official Docker GPG key
curl -fsSL https://yum.dockerproject.org/gpg | sudo apt-key add -

# Validate key 58118E89F3A912897C070ADBF76221572C52609D
$(apt-key fingerprint 58118E89F3A912897C070ADBF76221572C526091 | wc -l | grep -qv 0) && echo Valid || echo "Validation error"

## Add source
sudo apt-get install -y software-properties-common
sudo add-apt-repository -y \
       "deb https://apt.dockerproject.org/repo/ \
       ubuntu-$(lsb_release -cs) \
       main"

## Install docker
sudo apt-get update
sudo apt-get -y install docker-engine

## Group and user
sudo groupadd docker
sudo usermod -aG docker $USER

# Check install
sudo docker run hello-world

As a container

Based on Docker-compose Docs

curl -L https://github.com/docker/compose/releases/download/1.10.0/run.sh > /tmp/docker-compose
chmod +x /tmp/docker-compose
sudo mv /tmp/docker-compose /usr/local/bin/docker-compose

docker-compose-moodle es un repositorio para crear rápidamente un entorno de trabajo con Moodle (Apache2, PHP-FPM con XDEBUG y Postgres) usando contenedores para cada uno sus principales componentes. El entorno de trabajo se crea y gestiona con Docker Compose.

1. Tener Docker. Ver como instalar Docker en Ubuntu
2. Tener Docker Compose. Ver como instalar Docker Compose como contenedor
3. Descargar este repo y acceder a él: git clone https://github.com/jobcespedes/docker-compose-moodle.git && cd docker-compose-moodle
4. Copiar repositorio de código de Moodle: git clone -b MOODLE_35_STABLE https://github.com/moodle/moodle.git html
5. Desplegar con: docker-compose up -d

A continuación se incluye una tabla que resume la estructura del archivo de Docker Compose:

La siguiente tabla contiene las variables utilizadas en el archivo .env para docker compose:

Dentro de la carpeta del proyecto

1. Detener el proyecto

docker-compose stop
# docker-compose stop <servicio>

2. Iniciar el proyecto

docker-compose start
# docker-compose start <servicio>

2. Correr proyecto

docker-compose up -d
# Nombrar el proyecto diferente a la carpeta:
# docker-compose -p mi-proy up -d

3. Eliminar proyecto

docker-compose down
# Eliminar los volumenes también:
# docker-compose --volumes
# Eliminar con un nombre de proyecto especifico:
# docker-compose -p mi-proy down

4. Logs

docker-compose logs
#docker-compose logs <servicio>

5. Algunos comandos útiles de Docker

# Ver contenedores
docker ps
# Ver imágenes
docker images
# Ingresar a un contenedores
 docker exec -it <nombre_contenedor> bash
# Ver logs de un contenedor
docker logs <nombre_contenedor> -f
# Eliminar imágenes huérfanas
docker rmi $(docker images -f "dangling=true" -q)

Restaurar una base de datos al inicio

Se puede restaurar una base de datos, agregando el script sql generador (comprimido como gzip) a la caperta db_dumps y nombrando el archivo como dump-init.sql.gz

IMPORTANTE: Dependiendo del tamaño, la ejecución de este sql podría demorar la disponibilidad inicial de la base de datos.

Se utiliza el idekey PHPTEST

Configuración para depurar con IDE PHPStorm:

1. Agregar servidor:
   • Settings -> Languages -> PHP -> Servers
2. Agregar PHP remote debug
   • Run / Debug Configurations -> PHP remote debug
   • Utilizar servidor previamente agregado y establecer como idekey el valor PHPTEST
3. Activar botón Start listening for PHP Debug Connections

Pasos para usar pgadmin4

1. Ingresar a http://localhost:5050
2. En File -> Preferences -> Binary paths establecer en usr/bin
3. Agregar nuevo servidor:
   • Pestaña General
     • Name: Un nombre para el servidor
   • Pestaña Connection
     • Host name/address: postgres
     • Host Username: metics
     • Host Password: devpass
   • Guardar

Ubuntu 16

A partir de instrucciones en la documentación de Docker

sudo apt-get update

# Paquetes extra
sudo apt-get install -y curl \
    linux-image-extra-$(uname -r) \
    linux-image-extra-virtual

#Configurar el repositorio
sudo apt-get install -y apt-transport-https \
                       software-properties-common \
                       ca-certificates

# Agregar llave oficial GPG de docker
curl -fsSL https://yum.dockerproject.org/gpg | sudo apt-key add -

# Validar que llave sea 58118E89F3A912897C070ADBF76221572C52609D
$(apt-key fingerprint 58118E89F3A912897C070ADBF76221572C526091 | wc -l | grep -qv 0) && echo Verificado || echo "Error de verificacion"

# Instalar repositorio estable
sudo apt-get install -y software-properties-common
sudo add-apt-repository -y \
       "deb https://apt.dockerproject.org/repo/ \
       ubuntu-$(lsb_release -cs) \
       main"

# Instalar docker
sudo apt-get update
sudo apt-get -y install docker-engine

# Usuarios y grupos
sudo groupadd docker
sudo usermod -aG docker $USER

# Verificar la instalación
sudo docker run hello-world

Como contenedor

Basado en la doc de Docker-compose

curl -L https://github.com/docker/compose/releases/download/1.10.0/run.sh > /tmp/docker-compose
chmod +x /tmp/docker-compose
sudo mv /tmp/docker-compose /usr/local/bin/docker-compose