Class: CFoundry::V1::App::Instance

Inherits:
Object
  • Object
show all
Defined in:
lib/cfoundry/v1/app.rb

Overview

Class represnting a running instance of an application.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(appname, index, client, manifest = {}) ⇒ Instance

Create an Instance object.

You’ll usually call App#instances instead



478
479
480
481
482
483
 
# File 'lib/cfoundry/v1/app.rb', line 478

def initialize(appname, index, client, manifest = {})
  @app = appname
  @index = index
  @client = client
  @manifest = manifest
end

Instance Attribute Details

#app ⇒ Object (readonly)

The application this instance belongs to.



470
471
472
 
# File 'lib/cfoundry/v1/app.rb', line 470

def app
  @app
end

#index ⇒ Object (readonly)

Application instance number.



473
474
475
 
# File 'lib/cfoundry/v1/app.rb', line 473

def index
  @index
end

Instance Method Details

#console ⇒ Object

Instance console data. If instance has a console, returns a hash containing :ip and :port keys.



513
514
515
516
517
518
519
 
# File 'lib/cfoundry/v1/app.rb', line 513

def console
  return unless @manifest[:console_ip] and @manifest[:console_port]

  { :ip => @manifest[:console_ip],
    :port => @manifest[:console_port]
  }
end

#debugger ⇒ Object

Instance debugger data. If instance is in debug mode, returns a hash containing :ip and :port keys.



503
504
505
506
507
508
509
 
# File 'lib/cfoundry/v1/app.rb', line 503

def debugger
  return unless @manifest[:debug_ip] and @manifest[:debug_port]

  { :ip => @manifest[:debug_ip],
    :port => @manifest[:debug_port]
  }
end

#file(*path) ⇒ Object

Retrieve file contents for this instance.

path

A sequence of strings representing path segments.

For example, files("foo", "bar") for foo/bar.



550
551
552
 
# File 'lib/cfoundry/v1/app.rb', line 550

def file(*path)
  @client.base.files(@app, @index, *path)
end

#files(*path) ⇒ Object

Retrieve file listing under path for this instance.

path

A sequence of strings representing path segments.

For example, files("foo", "bar") for foo/bar.



538
539
540
541
542
 
# File 'lib/cfoundry/v1/app.rb', line 538

def files(*path)
  @client.base.files(@app, @index, *path).split("\n").collect do |entry|
    path + [entry.split(/\s+/, 2)[0]]
  end
end

#healthy? ⇒ Boolean

True if instance is starting or running, false if it’s down or flapping.

Returns:

  • (Boolean) 


523
524
525
526
527
528
529
530
 
# File 'lib/cfoundry/v1/app.rb', line 523

def healthy?
  case state
  when "STARTING", "RUNNING"
    true
  when "DOWN", "FLAPPING"
    false
  end
end

#inspect ⇒ Object

Show string representing the application instance.



486
487
488
 
# File 'lib/cfoundry/v1/app.rb', line 486

def inspect
  "#<App::Instance '#@app' \##@index>"
end

#since ⇒ Object

Instance start time.



497
498
499
 
# File 'lib/cfoundry/v1/app.rb', line 497

def since
  Time.at(@manifest[:since])
end

#state ⇒ Object Also known as: status

Instance state.



491
492
493
 
# File 'lib/cfoundry/v1/app.rb', line 491

def state
  @manifest[:state]
end