This repository provides a series of Docker images with Drupal and the drupal-guifi module, for developing the guifi.net website.
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
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.
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.
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: webmestreandpassword: guifi - phpmyadmin (database visualization): http://localhost:8000 with
user: rootandpassword: 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
In development
In development
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