forkcms_deploy

ForkCMS Deploy gem

This is a gem that enables you to deploy a ForkCMS install to your server. It was built specific for Fork CMS so your Capfile will be neat and tidy.

Installation

The recipe is available in the forkcms_deploy gem, which can be installed via RubyGems.org

gem install forkcms_deploy

Available recipes

• forkcms_deploy - ForkCMS specific tasks.
• forkcms_deploy/defaults - Best practices for each deployment.

Example recipe

This recipe will deploy the ForkCMS-instance to your-app.com.

load 'deploy' if respond_to?(:namespace) # cap2 differentiator

# set your application name here
set :application, "your-app.com"								# eg.: sumocoders.be

# set user to use on server
set :user, "your-user"											# eg.: sumocoders

# deploy to path (on server)
set :deploy_to, "/home/#{user}/apps/#{application}"				# eg.: /home/sumocoders/apps/sumocoders.be

# set document_root
set :document_root, "/home/#{user}/www.your-app.com"			# eg.: /home/sumocoders/default_www

# define roles
server "your-app.com", :app, :web, :db, :primary => true		# eg.: crsolutions.be

# git repo & branch
set :repository, "[e-mail]:your-app.git"				# eg.: [e-mail]:sumocoders.be.git
set :branch, "master"

# set version control type and copy strategy
set :scm, :git
set :copy_strategy, :checkout

begin
	require 'forkcms_deploy'
	require 'forkcms_deploy/defaults'							# optional, contains best practices
rescue LoadError
	$stderr.puts <<-INSTALL
You need the forkcms_deploy gem (which simplifies this Capfile) to deploy this application
Install the gem like this:
	gem install forkcms_deploy
				INSTALL
	exit 1
end

Publishing a new version.

1. bump the version in the gemspec file
2. commit this
3. build the gem using gem build forkcms_deploy.gemspec
4. push the gem using gem push forkcms_deploy-xxx.gem