I’ve been recently setting up my local development environment using a combination of a few pieces of software and web services to get this going. In upcoming blog posts I’ll be going over each of these in detail, for now here is my list:
Local development server that uses XAMPP and some magic. I’ve heard it described as “awesome” and “awesome in a bottle”, from the same person in the same sentence.
The man page describes git as “the stupid content tracker”
git for people that like a graphical user interface
the remote repository where git will push my code to
The secret sauce to pushing my ready for staging or ready for production code to the server(s)
So the part I’m going to focus on today is Dandelion which is a script that Scott Nelson on github created and describes as the “Incremental Git repository deployment”. What Dandelion does is something I don’t want to have to manage myself… anymore. You see I use to keep track of what files I changed and then only “deploy” the files I thought I changed up to production or staging if I had a staging server in place. What Dandelion does is it leverages git’s recent commit status to deploy only the changed files up to the webserver.. It’s pretty awesome.
The code is written in Ruby and is pretty simple to install and get running:
- I followed these steps on how to get Ruby and RubyGems installed on my MacBook Pro running Mountain Lion. It requires that you install Xcode and the Command Line Tools to get it going. http://www.zlu.me/blog/2012/02/21/install-native-ruby-gem-in-mountain-lion-preview/
- Once Ruby and RubyGems are installed you need to load up Terminal and run the following:
$ sudo gem install dandelion
- You’ll also need to run the following as well:
$ sudo gem install net-sftp
- From there we can test that dandelion is working:
$ dandelion Invalid command: Usage: dandelion [options]
 -v, --version Display the current version -h, --help Display this screen --repo=[REPO] Use the given repository --config=[CONFIG] Use the given configuration file Available commands: status deploy
- Now that we have Dandelion installed we just need to configure our production server so we can deploy our local get repo and it’s committed changes to production.
- Create a new file in the root of your website directory. Mine live here: /Users/jason/Documents/Websites/ so I go into: /Users/jason/Documents/Websites/www.jasontucker.dev which is the directory that I use with DesktopServer for my jasontucker.us site and create a new text file in there called dandelion.yml and input the following:
# Required scheme: sftp host: jasontucker.us username: myusernamehere password: mysuperlongCraz7Pazsw0rDh3re!2938474 # Optional path: jasontucker.us exclude: - .gitignore - dandelion.yml
- Instead of repeating what the github readme says I’ll referrer you to here: https://github.com/scttnlsn/dandelion#readme
- Optionally you can create additional file for your staging server if you like. If you do name it staging.yml and this one producton.yml and I can show you how to deploy to each by adding in a switch.
Tricking Dandelion into thinking we’ve already deployed (time saver)
Lets assume that recently downloaded a copy of your whole website to your local and haven’t done any changes at all yet. One thing that fustrated me when I used dandelion for the first time was that it wanted me to deploy EVERYTHING since it hasn’t taken note as to what hasn’t been deployed yet. What it does is it uses the SHA hash from git to figure out what it has deployed to the production site. So to get around pushing all those changes to the server I cheated and got the current SHA hash and tricked dandelion into thinking that has already been deployed for the first time. Here is how:
Execute Dandelion from the terminal while your present working directory is your website root folder, mine being: /Users/jason/Documents/Websites/www.jasontucker.dev
$ dandelion status Connecting to sftp://firstname.lastname@example.org/jasontucker.us Remote revision: --- Local HEAD revision: 7e8116749a78890e599561b0d674311a512f839a
Notice how it’s reporting there is no remote revision, let’s trick it into thinking the current version is there (which it is for the most part). Create a new file on the remote server called .revision and put in that string of text from the output of ‘dandelion status’ we ran earlier.
then upload it to the webroot of the remote webserver, in my case it was ‘jasontucker.us’ Now run dandelion status and you should see Remote revision and Local HEAD the same SHA hash. Now you can run dandelion deploy and it will deploy all of your changed files in that commit. We fancy now huh?
How to deploy to Production and Staging.
Dandelion has a great switch called “config” that allows you to specify which .yml (in our case production.yml and staging.yml) that you want to deploy, it’s syntax is simple, just change the name of the yml you want to deploy to.
$ dandelion –config=staging.yml deploy $ dandelion –config=production.yml deploy
Let me know how things go in the comments below.