Used technologies:

PHP
Drupal 8
Docker
Solr
ES6
Babel
Gulp
SASS
ESlint

Docker Installation

Clone repo

git clone git@github.com:creativepropulsionlabs/airbiotics.git

Go to the project root folder and run docker-compose up

cd airbiotics && docker-compose up -d --build

Solr core is not created automatically. To do so and reindex, run:

docker-compose exec solr make core=airbiotics -f /usr/local/bin/actions.mk
docker-compose exec php drush sapi-c
docker-compose exec php drush sapi-i

Run composer install:

docker-compose exec php composer install

Adjust your traefik.yml file. You will most like end up with something like this:

version: '2'

services:
  traefik:
    image: traefik
    restart: unless-stopped
    command: -c /dev/null --web --docker --logLevel=DEBUG
    networks:
      - airbiotics
    ports:
      - '80:80'
      - '8080:8080'
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

networks:
  airbiotics:
    external:
      name: airbiotics_default

Then, restart traefik container.

More info may be found at Docker4Drupal docs.

The website will be available at the following URL: http://cpl.docker.localhost

Running unit tests

Execute a shell:

docker-compose exec php sh

cd to the root dir of the code (that's important!) and run PHPUnit:

cd ..
./vendor/bin/phpunit  web/modules/custom

Running Drush, Composer

Just make sure to run your commands in the php container, like this:

docker-compose exec php composer install
docker-compose exec php drush updb

You don't have to install or run anything locally.

Running Drupal Console

Execute a shell:

docker-compose exec php sh

Run via ../vendor/bin/drupal

../vendor/bin/drupal

Files structure

JS

For build JS files you need to create (if folder not exist) behavior folder inside theme js, folder, and place your files there. You don't need to make one file with many behaviors, separate your behaviors to files, and gulp automatically build one file with all files scripts.

For example file with name test.js

console.log('Hello World!', context);

will be compile to

Drupal.behaviors[{themeName}Test] = {
    attach: function attach(context, settings) {
        console.log('Hello World!', context);
    }
};

Backups

Dumping database

You may want to dump your database at some point. To do so, run:

docker-compose exec php sh
../vendor/bin/drush sql-dump --structure-tables-list=cache,cache_*,watchdog |gzip > /tmp/dump.sql.gz
exit
docker cp `docker-compose ps -q php`:/tmp/dump.sql.gz /tmp/dump.sql.gz

RobertoCGarcia/repotest

Table of Contents