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-guificompose.git
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-guificompose/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
There are some compositions to run fiberfy-server API with drupal 6 guifi.net webpage. This is necessary because both applications share the same database (guifidev). If you want to run fiberfy-server you need to navigate inside drupal6+fiberfy-sails (folder without -sails is deprecated and soon will be removed from this repository). Then it will run with this simple command:
docker-compose up
After that you will have 4 containers running (the only difference with drupal6 standalone composition is the presence of fiberfy-server container).
You need to change drupal-guifi module branch to use drupal6-fiberfy branch:
cd ./guifi-web/sites/all/modules/guifi
git checkout drupal6-fiberfy
This branch includes some new fields and indexes necessaries to run fiberfy-server with guifi.net database. After that you have to update guifi.net development site (by default http://localhost:8080/update.php) selecting last update in guifi module. Then it should work.