Issue #1206: Add Docker bakery commands.

Author: geerlingguy

composer.json

@@ -25,6 +25,9 @@
         "process-timeout": 1800
     },
     "scripts": {
-        "run-tests": "./tests/run-tests.sh"
+        "run-tests": "./tests/run-tests.sh",
+        "docker-bake": "./provisioning/docker/bake.sh",
+        "docker-save-image": "./provisioning/docker/save-image.sh",
+        "docker-load-image": "./provisioning/docker/load-image.sh"
     }
 }

default.config.yml

@@ -319,6 +319,11 @@ solr_xmx: "128M"
 # Selenium configuration.
 selenium_version: 2.53.0
 
+# Docker configuration.
+docker_container_name: drupal-vm
+docker_image_name: drupal-vm
+docker_image_path: ~/Downloads
+
 # Other configuration.
 dashboard_install_dir: /var/www/dashboard
 known_hosts_path: ~/.ssh/known_hosts

docs/other/docker.md

@@ -0,0 +1,9 @@
+Drupal VM can be used to bake and share [Docker](https://www.docker.com) images.
+
+While building a single Docker container with the entire LAMP/LEMP/LAPP stack is not necessarily the best way to manage Docker-based infrastructure, it works.
+
+TODO:
+
+  - composer docker-bake
+  - composer docker-save-image
+  - composer docker-load-image

mkdocs.yml

@@ -67,6 +67,7 @@ pages:
     - 'Vagrant and VirtualBox': 'other/vagrant-virtualbox.md'
     - 'Vagrant LXC provider': 'other/vagrant-lxc.md'
     - 'Improving Performance': 'other/performance.md'
+    - 'Docker': 'other/docker.md'
     - 'BigPipe with Drupal VM': 'other/bigpipe.md'
     - 'Drupal multisite': 'deployment/multisite.md'
     - 'Drupal 6 Notes': 'other/drupal-6.md'

provisioning/docker/bake.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+
+# Set variables.
+DRUPALVM_MACHINE_NAME="${DRUPALVM_MACHINE_NAME:-drupal-vm}"
+DRUPALVM_HOSTNAME="${DRUPALVM_HOSTNAME:-localhost}"
+DRUPALVM_PROJECT_ROOT="${DRUPALVM_PROJECT_ROOT:-/var/www/drupalvm}"
+
+HOST_HTTP_PORT="${HOST_HTTP_PORT:-8080}"
+HOST_HTTPS_PORT="${HOST_HTTPS_PORT:-8443}"
+
+DISTRO="${DISTRO:-ubuntu1604}"
+OPTS="${OPTS:---privileged}"
+INIT="${INIT:-/lib/systemd/systemd}"
+
+# Pretty colors.
+red='\033[0;31m'
+green='\033[0;32m'
+neutral='\033[0m'
+
+# Set volume options.
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  volume_opts='rw,cached'
+else
+  volume_opts='rw'
+fi
+
+# Run the container.
+printf "\n"${green}"Bringing up Docker container..."${neutral}"\n"
+docker run --name=$DRUPALVM_MACHINE_NAME -d \
+  --add-host "$DRUPALVM_HOSTNAME  drupalvm":127.0.0.1 \
+  -v $PWD:$DRUPALVM_PROJECT_ROOT/:$volume_opts \
+  -p $HOST_HTTP_PORT:80 \
+  -p $HOST_HTTPS_PORT:443 \
+  $OPTS \
+  geerlingguy/docker-$DISTRO-ansible:latest \
+  $INIT
+
+# Create Drupal directory.
+docker exec $DRUPALVM_MACHINE_NAME mkdir -p $DRUPALVM_PROJECT_ROOT/drupal
+
+# Set things up and run the Ansible playbook.
+printf "\n"${green}"Running setup playbook..."${neutral}"\n"
+docker exec --tty $DRUPALVM_MACHINE_NAME env TERM=xterm \
+  ansible-playbook $DRUPALVM_PROJECT_ROOT/tests/test-setup.yml
+
+printf "\n"${green}"Provisioning Drupal VM inside Docker container..."${neutral}"\n"
+docker exec $DRUPALVM_MACHINE_NAME env TERM=xterm ANSIBLE_FORCE_COLOR=true \
+  ansible-playbook $DRUPALVM_PROJECT_ROOT/provisioning/playbook.yml
+
+printf "\n"${green}"...done!"${neutral}"\n"
+
+printf "\n"${green}"Visit the Drupal VM dashboard: http://localhost:$HOST_HTTP_PORT"${neutral}"\n"

provisioning/docker/load-image.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+#
+# Load a Docker image from an archive (tar).
+#
+# Required configuration (in config.yml):
+#
+#     docker_image_name: drupal-vm
+#     docker_image_path: ~/Downloads
+#
+
+# Exit on any individual command failure.
+set -e
+
+# Include YAML parser.
+source provisioning/docker/parse-yaml.sh
+
+# Pretty colors.
+red='\033[0;31m'
+green='\033[0;32m'
+neutral='\033[0m'
+
+# Set variables.
+image_name=$(parse_yaml config.yml docker_image_name)
+image_path=$(parse_yaml config.yml docker_image_path)
+image_full_path="$image_path/$image_name.tar.gz"
+image_full_path=${image_full_path/#\~/$HOME} # Expand ~ to $HOME.
+
+# Load the image.
+printf "\n"${green}"Loading Docker image..."${neutral}"\n"
+gunzip -c $image_full_path | docker load
+printf ${green}"...done!"${neutral}"\n"

provisioning/docker/parse-yaml.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+#
+# Parse a YAML file.
+#
+# Usage:
+#   parse_yaml [file-path] [variable-to-retrieve]
+#
+# Requires ruby.
+#   @see https://coderwall.com/p/bm_tpa/reading-yaml-files-in-bash-with-ruby
+#   @todo Consider using PHP so user doesn't need to install Ruby.
+
+function parse_yaml {
+  ruby -ryaml -e 'puts ARGV[1..-1].inject(YAML.load(File.read(ARGV[0]))) {|acc, key| acc[key] }' "$@"
+}

provisioning/docker/save-image.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+#
+# Commit a Docker image and save it to an archive (tar).
+#
+# Required configuration (in config.yml):
+#
+#     docker_container_name: drupal-vm
+#     docker_image_name: drupal-vm
+#     docker_image_path: ~/Downloads
+#
+
+# Exit on any individual command failure.
+set -e
+
+# Include YAML parser.
+source provisioning/docker/parse-yaml.sh
+
+# Pretty colors.
+red='\033[0;31m'
+green='\033[0;32m'
+neutral='\033[0m'
+
+# Set variables.
+container_name=$(parse_yaml config.yml docker_container_name)
+image_name=$(parse_yaml config.yml docker_image_name)
+image_path=$(parse_yaml config.yml docker_image_path)
+image_full_path="$image_path/$image_name.tar.gz"
+image_full_path="${image_full_path/#\~/$HOME}" # Expand ~ to $HOME.
+
+# Save the image.
+printf "\n"${green}"Saving Docker container to $image_full_path..."${neutral}"\n"
+docker commit $container_name $image_name
+docker save $image_name | gzip -1 > $image_full_path
+printf ${green}"...done!"${neutral}"\n"