docker-enfrancais/README.md

En françaiS Docker Environement (drupal api + vuejs client)

En FrançaiS powered by druapl 9 for the api and vuejs for the app (client) in docker environement (nginx, php:7-fpm+drush, mysql, phpmyadmin, redis, npm)

Install docker

sudo pacman -S docker docker-compose docker-machine

Clone this repos

this will clone this repos (main docker environement), the drupal 9 based api source code (without sites/default folder nor mysq ddb) and the vuejs app source code.

git clone --recursive -o figli https://figureslibres.io/gogs/bachir/docker-enfrancais.git

submodules :

• https://figureslibres.io/gogs/bachir/D9-enfrancais
• https://figureslibres.io/gogs/bachir/enfrancais-app

setup /sites/default/settings.php

### get the sites/default/files folder
rsync the files from you know where (if you don't, you don't) to api/src/web/sites/default/files/

## Mysql
Copy your-sql-dump.sql into ./ressources/enfrancais.sql
It will be automaticly imported into the mysql container db (only) on the first docker-compose up

## Hosts and reverse proxy

add to your /etc/hosts :

127.0.0.1 dev.enfrancais.fr 127.0.0.1 dev.phpmyadmin.enfrancais.fr

configure your vhosts to add a reverse proxy that will redirect the dev.enfrancais.fr to our container
Apache

ServerName dev.enfrancais.fr ProxyPass / http://127.0.0.1:8990/ ProxyPassReverse / http://127.0.0.1:8990/ ProxyRequests Off ProxyPreserveHost On proxy_buffer_size 128k; proxy_buffers 4 256k; proxy_busy_buffers_size 256k;

ServerName dev.phpmyadmin.enfrancais.fr ProxyPass / http://127.0.0.1:8991/ ProxyPassReverse / http://127.0.0.1:8991/ ProxyRequests Off ProxyPreserveHost On proxy_buffer_size 128k; proxy_buffers 4 256k; proxy_busy_buffers_size 256k;

nginx

server {

 listen 80;
 server_name dev.enfrancais.fr;

 access_log off;
 error_log  /var/log/nginx/enfrancais/error.log error;

 client_max_body_size 100m;

 location / {
     proxy_pass http://127.0.0.1:8990;
     proxy_set_header Host $host;
     proxy_set_header X-Real-IP $remote_addr;
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
     proxy_set_header X-Forwarded-Proto $scheme;
     proxy_buffer_size          128k;
     proxy_buffers              4 256k;
     proxy_busy_buffers_size    256k;
 }

} server {

 listen 80;
 server_name dev.phpmyadmin.enfrancais.com;

 location / {
     proxy_pass http://127.0.0.1:8991;
     proxy_set_header Host $host;
     proxy_set_header X-Real-IP $remote_addr;
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
     proxy_set_header X-Forwarded-Proto $scheme;
     proxy_buffer_size          128k;
     proxy_buffers              4 256k;
     proxy_busy_buffers_size    256k;
 }

}

## Docker

### docker-compose pull
pull the latest image of services

make pull

### build
only before the first run (may take some time)

make build

/!\ DO NOT use ```docker-compose build```, it will faile

### run
then each time you want to launch the app

make up

Be aware that a first up, since the db is empty, it will be populated with your file db.sql. It may take some time depending of your db size.

## Drupal Composer install
Only at first up, finish to install drupal composer dependencies
but first we need to downgrade composer to version 1

docker exec -u 0 -it enfrancais_api_1 /bin/bash composer selfupdate --1

ctrl+d

make exec_api composer install

## Visualize
You can now visit :
the app http://dev.enfrancais.fr
or the api http://dev.enfrancais.fr/api
on your browser

## Coding
### drush
you can access to drush by loging into the php container

make exec_api

once inside the php container in /var/www/html you can use drush as usual

## updateding manualy mysql db
copy your db backup into the mysql container
```sh
sudo docker cp your-db-file.sql enfrancais_mysql_1:/root/

log into mysql container

make exec_mysql

once inside the mysql container you can use mysql command to drop then create and load the db with your file

mysql -uroot -penfrancais
> drop database enfrancais;
> create database enfrancais;
> exit;
mysql -uroot -penfrancais enfrancais < your-db-file.sql

Makefile

DO NOT use directly docker or docker-compose to run this instance use make instead like make up

pull:
		docker-compose pull

build:
		docker-compose build --build-arg USER_UID=$(USER_UID) --build-arg USER_UNAME=$(USER_UNAME) --build-arg USER_GID=$(USER_GID) --build-arg USER_GNAME=$(USER_GNAME)

buildnc:
		docker-compose build --no-cache --build-arg USER_UID=$(USER_UID) --build-arg USER_UNAME=$(USER_UNAME) --build-arg USER_GID=$(USER_GID) --build-arg USER_GNAME=$(USER_GNAME)

downbuildup: down build up

up:
		docker-compose up -d

ps:
		docker-compose ps

logs:
		docker-compose logs -f

down:
		docker-compose down

exec_api:
		docker exec -it enfrancais_api_1 bash

exec_app:
		docker exec -it enfrancais_app_1 sh

exec_mysql:
		docker exec -it enfrancais_mysql_1 bash