Das Testen von Drupal-Installationsprofilen ist relativ mühselig, da sich ein Teil der Schritte, bis man überhaupt erst zum Testen der eigentlichen Funktionalität kommt, mit dem Build-Prozess beschäftigt.

Diesen muß man eigentlich für jede Änderung erneut durchlaufen…

  1. Drush make (das macht es im Falls des Feature-Server-Installations-Profiles)
    1. Drush make mit distro.make aus dem Git-Repository
    2. Download des Drupal-Cores
    3. Klonen des in distro.make hinterlegten Repositories für das Installationsprofil
    4. Rekursive Suche nach weiteren Drush-Makefiles, runterladen der Drupal-Module und des Themes, die im gefundenen Makefile drupal-org.make spezifiziert sind
  2. Sybolischer-Link vom erstellten Build auf die DocumentRoot des für Testzwecke angelegten VirtualHosts
  3. Drop auf alle Tabellen in der Zieldatenbank
  4. Installation von Drupal und einem bestimmtem Installationsprofiles, hier fserver_profile

In der scheinbaren Routine des manuellen Durchlaufen dieser Schritte entsteht zudem auch mal schnell ein Fehler.

So habe ich beim gefühlt 100sten Mal des Durchlaufens dieser Prozedur versehentlich in der falschen Datenbank alle Tabellen ge-dropt-t und dachte mir, Automatisierung muss her, schreib ein Shellskript…

Vorraussetzungen

Neben den Standard-System-Vorrausetzungen für Drupal, wird zusätzlich folgendes für das Bash-Skript benötigt:

Zur Ausführung sollte sich das Skript im Suchpfad $PATH befinden, kann aber natürlich auch mit einem vorangestellten bash gestartet werden.

Das Skript

Einfaches Bash-Skript welches die o.g. Schritte durchläuft.

Das droppen der Tabellen in der Zieldatenbank erfolgt über drush site-install.

#!/bin/bash

# Treat unset variables as an error
set -o nounset

# Source configuration
source $1 || exit 126

echo -e "${BUILD}"

##
# Needed executables & drush commands
#
DRUSH=$(which drush) &> /dev/null \
  || { echo 'Missing drush. Aborting...' >&2; exit 127; } 

# Specific path to drush version for drush site-install
set +o nounset
[ -z "$DRUSH_SITE_INSTALL_DRUSH" ] && DRUSH_SITE_INSTALL_DRUSH=${DRUSH}
set -o nounset

which git &> /dev/null \
  || { echo 'Missing git. Aborting...'>&2; exit 127; }

drush help make &> /dev/null \
  || { echo "Could not probe 'drush make'. Aborting...">&2; exit 127; }

${DRUSH_SITE_INSTALL_DRUSH} help site-install &> /dev/null \
  || { echo "Could not probe 'drush site-install'. Aborting...">&2; exit 127; }


##
# run drush make
#
cd ${WEB_DIR}
echo -e "# Running drush make, create new build ${BUILD} with ${BUILD_MAKEFILE}...\n"
${DRUSH} make ${MAKE_OPTIONS} ${BUILD_MAKEFILE} ${BUILD} 2>&1 \
  && echo -e "\n# Creating build ${BUILD} was successful\n" \
  || { echo -e "\nFAILED!\n"; exit 1; }

##
# link new build to docroot
#
if [ -L ${DOC_ROOT} ] ; then
  echo -ne "# Symlink ${BUILD} already exists, unlink ${BUILD}... " 
  unlink ${DOC_ROOT} 2>&1 \
    && echo -e "done\n" \
    || { echo -e  "FAILED!\n"; exit 2; }	  
fi
echo -ne "# Symlink ${BUILD} to ${WEB_DIR}/${DOC_ROOT}... "
ln -s ${BUILD} ${DOC_ROOT} 2>&1 \
  && echo -e "done\n" \
  || { echo -e "FAILED!\n"; exit 3; }

##
# run drush site-install (and drop existing tables)
#
echo -e "# Running drush site-install...\n"
${DRUSH_SITE_INSTALL_DRUSH} site-install ${BUILD_PROFILE} ${SI_OPTIONS} -y -r ${WEB_DIR}/${DOC_ROOT} \
 --db-url=${DB_DRIVER}://${DB_USER}:${DB_PASS}@${DB_HOST}/${DB} \
 --account-name=${DRUPAL_UID1} \
 --account-pass=${DRUPAL_UID1_PASS} \
 --account-mail=${DRUPAL_UID1_MAIL} \
 --site-mail=${DRUPAL_SITE_MAIL} \
 --site-name=${DRUPAL_SITE_NAME} 2>&1 \
 && echo -e "\n# Site installation was successful." \
 || { echo -e "\n# FAILED!"; exit 4; }

exit 0

Konfiguration

Die vom Skript benötigten Variablen, befanden sich in einer früheren Version zwischen der Interpreterdeklaration und set -o nounset, diese habe ich ausgelagert um das Arbeiten mit verschiedenen Branches und Projekten einfacher zu gestalten.

Die Konfiguration wird dem Skript als Parmeter beim Aufruf übergeben

# @file example build configuration

#
# Webserver specific
#

# Path of the directory 
# where to build should take place
WEB_DIR='/var/www/fserver6_builds'

# Name of DocumentRoot within $WEB_DIR 
# where the webserver should point to
DOC_ROOT='fserver6_build'

#
# Buid process specific
#

# Path to makefile 
BUILD_MAKEFILE='https://raw.github.com/fl3a/fserver_profile/master/drupal-org.make'

# Machine name of the profile that should be installed
BUILD_PROFILE='fserver_profile'

# Date prefix for build
BUILD_DATE=$(date +%Y%m%d%H%M%S)

# Name pattern for the build
BUILD=${DOC_ROOT}-${BUILD_DATE}

#
# Options for drush site-install
# @see drush help site-install
#

# Specific path to drush version for drush site-install command
DRUSH_SITE_INSTALL_DRUSH='/usr/local/share/drush-4.6/drush'

# --account-name Option
DRUPAL_UID1='Hochwohlgeboren'

# --ACCOUNT-PASS OPTION
DRUPAL_UID1_PASS='FbVZQkU5OAYmg'

# --account-mail
DRUPAL_UID1_MAIL='mail@example.com'

# --site-name Option
DRUPAL_SITE_NAME=${BUILD}

# --site-mail Option
DRUPAL_SITE_MAIL='mail@example.com'
#DRUPAL_SITE_MAIL=${DRUPAL_UID1_MAIL}

#
# Database specific settings to build db_url  
# ${DB_DRIVER}://${DB_USER}:${DB_PASS}@${DB_HOST}/${DB}
#

DB_DRIVER="mysqli"

DB_USER="fserver6_build"

DB_PASS="FbVZQkU5OAYmg"

DB_HOST="localhost"

DB="fserver6_build"

#
# Additional drush make options 
# @see drush help make
#

MAKE_OPTIONS='--nocolor --md5=print --no-patch-txt'

#
# Additional drush site-install (si) options
# @see drush help site-install
#

SI_OPTIONS='--nocolor'

Beispiele

  1. Einfacher Aufruf mit Ausgabe drupal_distro_build.sh fserver6_build.conf.sh
  2. Aufruf mit Mailversand der Ausgabe des Buildprozesses, der Betreff ist hier der Name des Builds
    drupal_distro_build.sh fserver6_build.conf.sh | mail -s `head -n 1` mail@example.com
  3. Aufruf mit Generierung eines Logfile, welches so heißt wie der Build + Suffix .log drupal_distro_build.sh fserver6_build.conf.sh | tee `head -n 1 `.log

Möglichkeiten

Mögliche Verwendung und Einsatzszenarien:

  • In Git-Hooks
  • In Continious Integration
  • ...und natürlich manuell

Quellen

Auf github, Gist 3089178

git clone git://gist.github.com/3089178.git drupal_distro_build