Automatic Drupal site deployment with git
In this article I will show how to setup git and Drupal in such a way that you can keep editing your site's modules, themes and libraries on your local machines and every time to do 'git push' it automatically deploys to your pubilc Drupal site - without having to login into your webhosting provider and doing checkout/reset on your working tree.
- You're using Git for version control and Drupal for site hosting.
- You're hosted in a place where you have ssh access and git installed on the server.
- You already know the basics of Git and Drupal.
- Your site is example.com hosted on a remote server (Linux).
- Your Drupal site directory on the remote server is ~/drupal/sites/example.com.
- You have some modules/themes/libraries etc. in ~/drupal/sites/example.com.
On remote server:
This turns your site-dir into a git repository and a git working directory (non-bare). Now on your local machine:
git clone email@example.com:~/drupal/sites/example.com
Make some code changes, commit locally, and then try to push.
... make changes ...
git commit -am'your commit message'
Oops! Push is rejected, with a bad error message. That's because a non-bare Git repository does not accept pushes automatically. To fix that do this on remote server (git repo:
git config receive.denyCurrentBranch ignore
Now push again. On local machine:
It should work this time. Now your remote repository has your changes, but those changes are sitting in the repository database, not in the working directory. For automatic deployment, you need every push from local machine to also cause the server to update the working directory.
That is where Git hooks come in. One of the Git hooks is post-receive hook. It executes every time a push is accepted. On the remote server, put the following in ~/drupal/sites/example.com/.git/hooks/post-receive
#!/bin/sh # all hook scripts start out in repo-dir/.git, so cd to repo-dir cd .. # set the directory that contains git metadata GIT_DIR='.git' # protect files before creating them and then to reset --hard to checkout umask 002 && git reset --hard # now clear Drupal cache export DRUSH_PHP=/usr/local/bin/php5 ~/drush/drush cc all
In the above script we are checking out the files in the working directory (Drupal site-dir) and then clearing Drupal cache using Drush. That last step is optional, in case you prefer clearing cache from browser UI.