Skip to content

Latest commit

 

History

History
57 lines (45 loc) · 2.79 KB

README.md

File metadata and controls

57 lines (45 loc) · 2.79 KB
Raw

Drupal - Composer - Docker

Docker image with out-of-box support for Composer workflow. Recommanded Composer template: https://github.com/drupal-composer/drupal-project

  • Composer is pre-installed
  • CLI utilities installed by Composer (Drush, Drupal Console, ...) are in PATH, so you can call them from anywhere in the container
  • Drush will know where is Drupal root, so you do not have to be in the project directory
  • DocumentRoot is in /var/www/drupal/web, so Drupal is in subdirectory of project root (/var/www/drupal - where composer.json is located). Can be overriden by environment variable DOCROOT.

Tags

Tags of this image follow apache tags of drupaldocker/php image.

It uses GitLab CI and it's registry, so you have to prepend image by: registry.gitlab.com You can use also Docker Hub, but there is only 7.1-apache tag, because Docker Hub does not support scripting in build process.

Available tags can be seen on GitLab project page.

How to use it

Pull and run image by CLI:

docker run -d -p 8080:80 --name my-drupal-app -v $(pwd)/drupal:/var/www/drupal registry.gitlab.com/janpoboril/drupal-composer-docker:7.1-apache

or better use in docker-compose.yml like:

services:
  web:
    image: registry.gitlab.com/janpoboril/drupal-composer-docker:7.1-apache
    ports:
      - "8080:80"
    volumes:
      - ./web/drupal:/var/www/drupal

or as a base for your own image in Dockerfile beginning with:

FROM registry.gitlab.com/janpoboril/drupal-composer-docker:7.1-apache

Initializing Drupal project

This image does not contain Drupal code, so you have many options how to use it. Recommended way how to initialize new project by Composer:

Open shell into container:

docker exec -it -u www-data myproject_web_1 bash

And clone template (you should be in ~/drupal - default working directory):

composer create-project drupal-composer/drupal-project:8.x-dev . --stability dev --no-interaction

Then Drupal is ready to run in browser or install modules by Composer:

composer require drupal/devel:~1.0

See template's README for more examples how to use it.

Warning about Drush and Console: Current versions does not understand projects where Drupal is in a subdirectory (composer.json and index.php are not siblings), so if you try to download a module by them (e.g. drush dl devel including drush en devel) they will not use Composer but will use "old-school http tar.gz" method (module will not be recorded into composer.json).