getting_started.txt

Path: doco/getting_started.txt
Last Update: Thu Aug 26 07:43:06 -0600 2010

Quick Start for a 1-Server Solution:

Setup

  • Create a deploy file, usually in "config/deploy.rb":
      set :application, "project"
      set :domain, "example.com"
      set :deploy_to, "/path/to/install"
      set :repository, 'http://svn.example.com/project/branches/stable/'
    

This defaults to using ‘svn export’ from repository, and a single server for app, db, and www. If you need to tweak these things, refer to the variable documentation.

  • If you want a multi-config environment, change your config like so:
      set :application, "project"
      set :repository, 'http://svn.example.com/project/branches/stable/'
    
      task :beta do
        set :domain,    "beta.example.com"
        set :deploy_to, "/path/to/install-beta"
      end
    
      task :dev do
        set :domain,    "dev.example.com"
        set :deploy_to, "/path/to/install-dev"
      end
    
      task :prod do
        set :domain,    "example.com"
        set :deploy_to, "/path/to/install"
      end
    
  • Add the following to your Rakefile:
      begin
        require 'vlad'
        Vlad.load
      rescue LoadError
        # do nothing
      end
    

Vlad.load has a lot of flexibility. See the rdoc for full information.

You don‘t need the begin/rescue/end block if you ensure that Vlad is installed on all your servers. To be lazy, you can install vlad via:

    % rake vlad:invoke COMMAND='sudo gem install vlad -y'

Initial Launch

  • Run rake vlad:setup vlad:update vlad:migrate vlad:start

Subsequent Updates:

  • rake vlad:update vlad:migrate vlad:start

Each step may be run separately.

[Validate]