Middleman Rackspace

Deploy your Middleman site to Rackspace Cloud Files.

Add the following to the Gemfile for you Middleman project and perform a bundle install.

gem 'middleman-rackspace'

After configuration, you can deploy to the production container with:

$ middleman rackspace production

To deploy to the staging container, use:

$ middleman rackspace staging

An archive build_ENVIRONMENT_TIMESTAMP.tar.gz is created for your current build and pushed to Rackspace. A new container will automatically be configured on the specified region. If there is an existing container with the same name, data will be overwritten.

To enable git support, set config.git to true or pass --git on the CLI. When enabled, the middleman rackspace command will automatically switch to the git branch corresponding to the environment you are deploying.

Default branch mappings:

• staging environment maps to staging branch.
• production environment maps to master branch.

Both of these can be changed in the configuration.

The git support will automatically stash any changes you have in your working tree before switching branch. After a successful build and deploy, these changes will be restored.

Activate and configure middleman-rackspace by adding an activate :rackspace block to config.rb. For example:

# Example configuration
activate :rackspace do |config|
  config.rackspace_username   = 'username'
  config.rackspace_api_key    = 'a99c75008c3f4ccd31ce67a0674db356'
  config.rackspace_region     = :syd
  config.container_staging    = 'example-container-staging'
  config.container_production = 'example-container'
  config.git                  = true
  config.build                = true
end

Here is a list of all configuration options available with their default values.

# Default configuration
activate :rackspace do |config|
  # Rackspace credentials
  config.rackspace_username   = ENV['RACKSPACE_USERNAME']
  config.rackspace_api_key    = ENV['RACKSPACE_API_KEY']
  # The Rackspace region to deploy to
  config.rackspace_region     = :dfw
  # The target Rackspace container for each environment
  config.container_staging    = nil
  config.container_production = nil
  # Git branch for each environment
  config.branch_staging       = 'staging'
  config.branch_production    = 'master'
  # Checkout environment branch before the build/deploy step
  config.git                  = false
  # Run `middleman build` before the deploy step
  config.build                = false
  # Root page filename
  config.index_file           = 'index.html'
  # Error page filename prefix, translates to 401.html and 404.html
  config.error_file_prefix    = '.html'
end

For a list of available regions see http://www.rackspace.com/knowledge_center/article/about-regions.

• On deploy, delete files on the server that have been removed from the build.
• Invalidate cache after deploy.
• Improve CLI to deploy from a pre-built build_ENVIRONMENT_TIMESTAMP.tar.gz.
• Improve error handling.