Class: Sprinkle::Actors::Capistrano

Inherits:
Object
  • Object
show all
Defined in:
lib/sprinkle/actors/capistrano.rb

Overview

Capistrano Delivery Method

Capistrano is one of the delivery method options available out of the box with Sprinkle. If you have the capistrano gem install, you may use this delivery. The only configuration option available, and which is mandatory to include is recipes. An example:

deployment do
  delivery :capistrano do
    recipes 'deploy'
  end
end

Recipes is given a list of files which capistrano will include and load. These recipes are mainly to set variables such as :user, :password, and to set the app domain which will be sprinkled.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(&block) ⇒ Capistrano

:nodoc:



24
25
26
27
28
29
30
31
32
33
34
35
 
# File 'lib/sprinkle/actors/capistrano.rb', line 24

def initialize(&block) #:nodoc:
  @config = ::Capistrano::Configuration.new
  @config.logger.level = Sprinkle::OPTIONS[:verbose] ? ::Capistrano::Logger::INFO : ::Capistrano::Logger::IMPORTANT
  @config.set(:password) { ::Capistrano::CLI.password_prompt }
  @name_counters = Hash.new { |h, v| h[v] = 0 }
  
  if block
    self.instance_eval(&block)
  else
    @config.load 'deploy' # normally in the config directory for rails
  end
end

Instance Attribute Details

#config ⇒ Object

:nodoc:



22
23
24
 
# File 'lib/sprinkle/actors/capistrano.rb', line 22

def config
  @config
end

#loaded_recipes ⇒ Object

:nodoc:



22
23
24
 
# File 'lib/sprinkle/actors/capistrano.rb', line 22

def loaded_recipes
  @loaded_recipes
end

Instance Method Details

#find_servers(roles) ⇒ Object 



55
56
57
 
# File 'lib/sprinkle/actors/capistrano.rb', line 55

def find_servers(roles)
  @config.find_servers(:roles => roles).collect(&:host)
end

#process(name, commands, server, suppress_and_return_failures = false) ⇒ Object

:nodoc:



59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
 
# File 'lib/sprinkle/actors/capistrano.rb', line 59

def process(name, commands, server, suppress_and_return_failures = false) #:nodoc:        
  task = task_sym(name)
          
  define_task(task, server) do
    via = fetch(:run_method, :sudo)
    commands.each do |command|
      invoke_command command, :via => via
    end
  end        

  begin
    run(task)
    
    return true
  rescue ::Capistrano::CommandError => e
    return false if suppress_and_return_failures

    # Reraise error if we're not suppressing it
    raise
  end        
end

#put(name, uploads, roles, suppress_and_return_failures = false) ⇒ Object

:nodoc:



81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
 
# File 'lib/sprinkle/actors/capistrano.rb', line 81

def put(name, uploads, roles, suppress_and_return_failures = false) #:nodoc:                
  task = task_sym(name)        
  
  define_task(task, roles) do
    uploads.each do |file, upload|
      put upload[:content], file, upload[:options]
    end
  end
  
  begin
    run(task)
    
    return true
  rescue ::Capistrano::CommandError => e
    return false if suppress_and_return_failures

    # Reraise error if we're not suppressing it
    raise
  end        
end

#recipes(script) ⇒ Object

Defines a recipe file which will be included by capistrano. Use these recipe files to set capistrano specific configurations. Default recipe included is “deploy.” But if any other recipe is specified, it will include that instead. Multiple recipes may be specified through multiple recipes calls, an example:

deployment do
  delivery :capistrano do
    recipes 'deploy'
    recipes 'magic_beans'
  end
end



49
50
51
52
53
 
# File 'lib/sprinkle/actors/capistrano.rb', line 49

def recipes(script)
  @loaded_recipes ||= []
  @config.load script
  @loaded_recipes << script
end