Module: Capistrano::Configuration::Servers

Included in:
Capistrano::Configuration
Defined in:
lib/capistrano/configuration/servers.rb

Instance Method Summary collapse

Instance Method Details

#find_servers(options = {}) ⇒ Object

Attempts to find all defined servers that match the given criteria. The options hash may include a :hosts option (which should specify an array of host names or ServerDefinition instances), a :roles option (specifying an array of roles), an :only option (specifying a hash of key/value pairs that any matching server must match), and an :exception option (like :only, but the inverse).

Additionally, if the HOSTS environment variable is set, it will take precedence over any other options. Similarly, the ROLES environment variable will take precedence over other options. If both HOSTS and ROLES are given, HOSTS wins.

Usage:

# return all known servers
servers = find_servers

# find all servers in the app role that are not exempted from
# deployment
servers = find_servers :roles => :app,
             :except => { :no_release => true }

# returns the given hosts, translated to ServerDefinition objects
servers = find_servers :hosts => "[email protected]"



36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
 
# File 'lib/capistrano/configuration/servers.rb', line 36

def find_servers(options={})
  hosts  = server_list_from(ENV['HOSTS'] || options[:hosts])
  roles  = role_list_from(ENV['ROLES'] || options[:roles] || self.roles.keys)
  only   = options[:only] || {}
  except = options[:except] || {}

  if hosts.any?
    hosts.uniq
  else
    servers = roles.inject([]) { |list, role| list.concat(self.roles[role]) }
    servers = servers.select { |server| only.all? { |key,value| server.options[key] == value } }
    servers = servers.reject { |server| except.any? { |key,value| server.options[key] == value } }
    servers.uniq
  end
end

#find_servers_for_task(task, options = {}) ⇒ Object

Identifies all servers that the given task should be executed on. The options hash accepts the same arguments as #find_servers, and any preexisting options there will take precedence over the options in the task.



8
9
10
 
# File 'lib/capistrano/configuration/servers.rb', line 8

def find_servers_for_task(task, options={})
  find_servers(task.options.merge(options))
end