Class: Falcon::Services
- Inherits:
 - 
      Object
      
        
- Object
 - Falcon::Services
 
 
- Defined in:
 - lib/falcon/services.rb
 
Overview
Represents one or more services associated with a host.
The services model allows falcon to manage one more more service associated with a given host. Some examples of services include:
- 
Rack applications wrapped by Falcon::Service::Application.
 - 
Host supervisor implemented in Falcon::Service::Supervisor.
 - 
Proxy services wrapped by Falcon::Service::Proxy.
 
The list of services is typically generated from the user supplied `falcon.rb` configuration file, which is loaded into an immutable Configuration instance, which is mapped into a list of services.
Instance Method Summary collapse
- 
  
    
      #add(service)  ⇒ Object 
    
    
  
  
  
  
  
  
  
  
  
    
Add a named service.
 - 
  
    
      #each(&block)  ⇒ Object 
    
    
  
  
  
  
  
  
  
  
  
    
Enumerate all named services.
 - 
  
    
      #initialize(configuration)  ⇒ Services 
    
    
  
  
  
    constructor
  
  
  
  
  
  
  
    
Initialize the services from the given configuration.
 - 
  
    
      #setup(container)  ⇒ Object 
    
    
  
  
  
  
  
  
  
  
  
    
Setup all named services into the given container.
 - 
  
    
      #start  ⇒ Object 
    
    
  
  
  
  
  
  
  
  
  
    
Start all named services.
 - 
  
    
      #stop  ⇒ Object 
    
    
  
  
  
  
  
  
  
  
  
    
Stop all named services.
 
Constructor Details
#initialize(configuration) ⇒ Services
Initialize the services from the given configuration.
      39 40 41 42 43 44 45 46 47  | 
    
      # File 'lib/falcon/services.rb', line 39 def initialize(configuration) @named = {} configuration.each(:service) do |environment| service = Service::Generic.wrap(environment) add(service) end end  | 
  
Instance Method Details
#add(service) ⇒ Object
Add a named service.
      57 58 59  | 
    
      # File 'lib/falcon/services.rb', line 57 def add(service) @named[service.name] = service end  | 
  
#each(&block) ⇒ Object
Enumerate all named services.
      50 51 52  | 
    
      # File 'lib/falcon/services.rb', line 50 def each(&block) @named.each_value(&block) end  | 
  
#setup(container) ⇒ Object
Setup all named services into the given container.
      72 73 74 75 76 77 78 79  | 
    
      # File 'lib/falcon/services.rb', line 72 def setup(container) @named.each do |name, service| Console.logger.debug(self) {"Setup #{name} into #{container}..."} service.setup(container) end return container end  | 
  
#start ⇒ Object
Start all named services.
      62 63 64 65 66 67  | 
    
      # File 'lib/falcon/services.rb', line 62 def start @named.each do |name, service| Console.logger.debug(self) {"Starting #{name}..."} service.start end end  | 
  
#stop ⇒ Object
Stop all named services.
      82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97  | 
    
      # File 'lib/falcon/services.rb', line 82 def stop failed = false @named.each do |name, service| Console.logger.debug(self) {"Stopping #{name}..."} begin service.stop rescue => error failed = true Console.logger.error(self, error) end end return failed end  |