Completely automated Drupal install, with lots of flexibility!
Creates a Docker container for Drupal 7 or 8, using Linux (Ubuntu 14.04), Apache and MySQL:
- Install Ubuntu 14.04/Apache/Php/Mysql with supervisord startup scripts
- Install postfix to allow drupal to deliver emails
- Install composer and drush
- Use included Drupal7, or download Drupal, pull from git or via drush makefile
- Install drupal+DB via a standard or custom profile
- Optionally run cron, rsyslog and postfix, or add HTTPS, or externalise the DB, or..
- Most drupal install settings are environment settings when creating a container from the image. See below.
Well, install docker if you dont have it yet (see the bottom), then just use it.
Simplest form, start a D7 container:
docker run -td boran/drupal
Simplest form, start a D7 container, interactive shell (run /start.sh when you have the shell to start lamp):
docker run -ti boran/drupal /bin/bash
Name the container (--name drupal8003) and give it a public port (8003). Then visit http://MYHOST.com:8003/
docker run -td -p 8003:80 --name drupal8003 boran/drupal
-
Examine log of the container started above (named drupal8003)
docker logs -f drupal8003
-
connect a shell to the running container
sudo docker exec -it drupal8003 bash
- create a nice shell function in /etc/profile.d/nsenter.sh, which allows one to do "nsenter CONTAINER-NAME"
function nsenter (){ sudo docker exec -it $* bash; }
- Create a new container and only run a shell
docker run -ti boran/drupal /bin/bash
To run the container with "foo" as the admin password:
docker run -td -p 8003:80 -e "DRUPAL_ADMIN_PW=foo" -e "DRUPAL_SITE_NAME=My Super site" --name drupal8003 boran/drupal
Download drupal+website on the develop branch from a https git repo:
docker run -td -p 8003:80 -e "DRUPAL_GIT_REPO=https://USER:[email protected]/path/something" -e "DRUPAL_GIT_BRANCH=devop" --name drupal8003 boran/drupal
To run a custom install profile, set DRUPAL_INSTALL_REPO and DRUPAL_INSTALL_PROFILE accordingly.
Download drupal+modules according to a make file:
docker run -td -p 8003:80 -e "DRUPAL_MAKE_DIR=drupal-make1" -e "DRUPAL_MAKE_REPO=https://github.com/Boran/drupal-make1" -e "DRUPAL_MAKE_CMD=${DRUPAL_MAKE_DIR}/${DRUPAL_MAKE_DIR}.make ${DRUPAL_DOCROOT}" --name drupal8003 boran/drupal`
Environment parameters, defaults are as follows, commented values are not set by default:
DRUPAL_SITE_NAME My Drupal Site
DRUPAL_SITE_EMAIL [email protected]
DRUPAL_ADMIN admin
DRUPAL_ADMIN_PW admin
DRUPAL_ADMIN_EMAIL [email protected]
#DRUPAL_VERSION drupal-7
By default a bundled drupal 7 is installed
drush dl syntax, e.g. drupal-7, drupal-7.x =dev, drupal-8.0.0-alpha15
#DRUPAL_GIT_REPO https://USER:[email protected]/path/something
#DRUPAL_GIT_BRANCH master
#DRUPAL_MAKE_DIR drupal-make1
#DRUPAL_MAKE_REPO https://github.com/Boran/drupal-make1
#DRUPAL_MAKE_BRANCH master
# Which will run: drush make ${DRUPAL_MAKE_DIR}/${DRUPAL_MAKE_DIR}.make ${DRUPAL_DOCROOT}
DRUPAL_INSTALL_PROFILE standard
Specify the repo and the branch of the install profile:
# DRUPAL_INSTALL_REPO https://github.com/Boran/drupal-profile1.git
# DRUPAL_INSTALL_PROFILE_BRANCH master
# Run a feature revert revert after installing, can be useful for default content
#ENV DRUPAL_MAKE_FEATURE_REVERT 1
#If a second user is needed:
# DRUPAL_USER1 bob
# DRUPAL_USER1_PW bobspasswd
# DRUPAL_USER1_EMAIL [email protected]
# DRUPAL_USER1_ROLE manager (if not specified, default is administrator)
Optional mysql:
# MYSQL_HOST is set, mysql will not be installed in the container
# MYSQL_DATABASE MYSQL_USER MYSQL_PASSWORD
Optional mysql+drupal
# DRUPAL_NONE (if set, mysql/drupal will not be installed)
After drupal has been installed one may need to run some commands, e.g. set values via drush. There are two ways do do this.
- DRUPAL_FINAL_CMD: Run a custom command after the site is installed. Example: get,enable and run the production check module "ENV DRUPAL_FINAL_CMD drush -y dl prod_check && drush -y en prod_check && drush -y cache-clear drush && drush -y prod-check-prodmode"
- DRUPAL_FINAL_SCRIPT: Run a script after the iste is installed. This script must already be available (i.e. pulled from a repo or make file during installation, or downloaded via a DRUPAL_FINAL_CMD. Exxample:
* DRUPAL_FINAL_CMD=curl --silent -o /tmp/cleanup1.sh https://raw.githubusercontent.com/Boran/webfact-make/master/scripts/cleanup1.sh && chmod 700 /tmp/cleanup1.sh
* DRUPAL_FINAL_SCRIPT=/tmp/cleanup1.sh
Download drupal+website on the master branch from a git repo via ssh with keys.
- In this case an included script DRUPAL_GIT_SSH=/gitwrap.sh is referenced which passes keys to ssh for use in git clone
- Create ssh keys (id_rsa.pub id_rsa) with ssh-keygen. In this example they are stored in /root/boran-drupal/ssh
- Then build the container mounting the SSH keys files under /root/gitwrap/id_rsa /root/gitwrap/id_rsa.pub
- The example repo is [email protected]:/MYUSER/MYREPO.git
docker run -td -p 8003:80 -e "DRUPAL_GIT_SSH=/gitwrap.sh" -e "[email protected]:/MYUSER/MYREPO.git" -v /root/boran-drupal/ssh/id_rsa:/root/gitwrap/id_rsa -v /root/boran-drupal/ssh/id_rsa.pub:/root/gitwrap/id_rsa.pub -v /root/boran-drupal/ssh/known_hosts/root/gitwrap/known_hosts --name drupal8003 boran/drupal
If MYSQL_HOST is set, mysql will not be installed in the container. In this case create the DB first on your server and set the environment variables MYSQL_DATABASE MYSQL_USER DRUPAL_PASSWORD in addition to MYSQL_HOST.
By setting DRUPAL_NONE Its possible to setup a container with all tools and dependancies, but without a Drupal website. The first use case was creating a build container for continuous integration (see boran/docker-cibuild on github)
Postfix is installed since drupal needs to send emails during certain installation scenarios. If it cannot email, builds will break. The default installation will allow emails to be queued in postfix locally within the container. To enabled fully delivery ouside of the container, add lines to /custom.sh inside the container to configure e.g. change the relay to a SMTP mailgateway reachable from your network:
echo "custom.sh: setup postfix, puppet. VIRTUAL_HOST=$VIRTUAL_HOST";
postconf -e "myhostname = `hostname`"
postconf -e 'mydestination = $VIRTUAL_HOST localhost.localdomain, localhost'
postconf -e 'relayhost = MYRELAY.EXAMPLE.ch'
By setting DRUPAL_SSL you enable ssl support in Apache. The preinstalled self signed certificate is used /etc/ssl/certs/ssl-cert-snakeoil.pem To connect to port 443 via https map your port to port 443 (eg docker run -p 8433:433...)
By setting SUPERVISOR_CRON_ENABLE=true the cron daemon is started via supervisor.
By setting SUPERVISOR_RSYSLOG_ENABLE=true the cron daemon is started via supervisor.
If you have not yet got docker running, the following is one way to install on Ubuntu 14.04, pulling the latest version and ensuring aufs filesystem:
sudo apt-get install linux-image-extra-`uname -r`
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 36A1D7869245C8950F966E92D8576A8BA88D21E9
sudo sh -c "echo deb https://get.docker.io/ubuntu docker main\ > /etc/apt/sources.list.d/docker.list"
sudo apt-get update -qq && sudo apt-get -yq install lxc-docker
See also [using docker] (https://docs.docker.com/userguide/usingdocker/)
Some changes can be made by creating a new image base on boran/drupal
- download a copy of drupal to a subfolder called drupal
- Set new defaults for the "DRUPAL*" enviroment variables
- Include a custom.sh, which (if it exists) is run just before the end of start.sh. this could be used to run puppet, or other provisioning tool.
e.g. create a site specific inherited image with additional stuff such as cron, postfix, syslog and puppet.
Grab sources from Github
- download a copy of drupal to a subfolder called files/drupal-7
cd files
drush dl drupal
mv drupal-7.* drupal-7
- then rebuild:
docker build -t="boran/drupal" .
# Interative: stop/delete/rebuild:
docker stop drupal8003 && docker rm drupal8003 && docker build -t="boran/drupal" .
# Run and look at logs:
docker run -td -p 8003:80 --name drupal8003 boran/drupal
docker logs -f drupal8003
The very first iteration was based on a pattern from https://github.com/ricardoamaro/docker-drupal.git
Sean Boran https://github.com/Boran/docker-drupal