Docker images for the guifi.net website development environment

This repository provides a series of Docker images with Drupal and the drupal-guifi module, for developing the guifi.net website.

Requirements

The following packages are required:

docker engine: version 1.13 or newer
python: 2.7
python-pip: suitable for version 2.7
docker-compose: version 1.10 or newer
git: any recent version

Installing the required packages in Debian

First of all, docker-ce engine must be installed. To do so, follow the instructions on Docker's website: https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository.

Then install the required Python andd Git packages (if they were not already installed):

sudo apt install -y python2.7 python-pip git

Finally, follow the instructions on Docker's website to install Docker Compose: https://docs.docker.com/compose/install/#install-compose.

Alternatively, you can install Docker Compose via pip:

sudo pip install docker-compose

You are now ready to use this repo's Docker Compose files.

Working with these composition

At this moment we are providing different Docker images which will be useful for different cases. All the images provided support the Xdebug PHP Debugger, which is compatible with a lot of IDEs.

Drupal 6

If you want to work with the current version of the guifi.net webpage, clone this repository inside your development directory with writing permissions:

git clone https://github.com/guifi/docker-drupal-guifi

Then enter the directory where the docker-compose.yml file is and issue the command to build the development environment:

cd docker-drupal-guifi/drupal6
docker-compose up

The docker-compose command automates the download and installation of the guifi.net website development environment. You can check the output messages that log the different steps performed. The installation will be finished once you see:

Guifi.net dev page successfully installed in Docker image!

After that you can head to:

guifi.net website: http://localhost:8080 with user: webmestre and password: guifi
phpmyadmin (database visualization): http://localhost:8000 with user: root and password: admin

User webmestre has the Drupal user ID #1. It is mandatory to employ this user to test migrations to newer Drupal versions.

In this development environment, all Drupal users registered at www.guifi.net are available locally and have the same password: guifi

If you want to erase all the development website's content and create a new one, run the following commands from within the docker-drupal-guifi/drupal6 directory:

docker-compose rm -vf
sudo rm -rf ./guifi-web/*
docker-compose up

Drupal 7

In development

Drupal 8

In development

Using XDebug PHP debugger

Default configuration tries to connect using DBGp protocol to host 9000 port. To start a debugging session you need to add http://localhost:8080/?XDEBUG_SESSION_START=1

guifi / docker-drupal-guifi

readme