Class: CFoundry::V1::App

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

Overview

Class for representing a user’s application on a given target (via Client).

Does not guarantee that the app exists; used for both app creation and retrieval, as the attributes are all lazily retrieved. Setting attributes does not perform any requests; use #update! to commit your changes.

Defined Under Namespace

Classes: Instance

Constant Summary

Constants included from UploadHelpers

UploadHelpers::UPLOAD_EXCLUDE

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from UploadHelpers

#check_unreachable_links, #find_sockets, #make_fingerprints, #prepare_package

Constructor Details

#initialize(name, client, manifest = nil) ⇒ App

Create an App object.

You’ll usually call Client#app instead



61
62
63
64
65
66
# File 'lib/cfoundry/v1/app.rb', line 61

def initialize(name, client, manifest = nil)
  @name = name
  @client = client
  @manifest = manifest
  @diff = {}
end

Instance Attribute Details

#commandObject

Application startup command.

Used for standalone apps.



44
45
46
# File 'lib/cfoundry/v1/app.rb', line 44

def command
  @command
end

#debug_modeObject

Application debug mode.



47
48
49
# File 'lib/cfoundry/v1/app.rb', line 47

def debug_mode
  @debug_mode
end

#envObject

Application environment variables.



30
31
32
# File 'lib/cfoundry/v1/app.rb', line 30

def env
  @env
end

#frameworkObject

Application framework.



36
37
38
# File 'lib/cfoundry/v1/app.rb', line 36

def framework
  @framework
end

#memoryObject

Application memory limit.



33
34
35
# File 'lib/cfoundry/v1/app.rb', line 33

def memory
  @memory
end

#nameObject

Application name.



21
22
23
# File 'lib/cfoundry/v1/app.rb', line 21

def name
  @name
end

#runtimeObject

Application runtime.



39
40
41
# File 'lib/cfoundry/v1/app.rb', line 39

def runtime
  @runtime
end

#servicesObject

Services bound to the application.



27
28
29
# File 'lib/cfoundry/v1/app.rb', line 27

def services
  @services
end

#stateObject Also known as: status

Application state.



50
51
52
# File 'lib/cfoundry/v1/app.rb', line 50

def state
  @state
end

#total_instancesObject

Application instance count.



24
25
26
# File 'lib/cfoundry/v1/app.rb', line 24

def total_instances
  @total_instances
end

#urisObject Also known as: urls

URIs mapped to the application.



54
55
56
# File 'lib/cfoundry/v1/app.rb', line 54

def uris
  @uris
end

Instance Method Details

#bind(*instances) ⇒ Object

Bind services to application.



309
310
311
# File 'lib/cfoundry/v1/app.rb', line 309

def bind(*instances)
  update!(:services => services + instances)
end

#binds?(instance) ⇒ Boolean

Returns:

  • (Boolean)


321
322
323
# File 'lib/cfoundry/v1/app.rb', line 321

def binds?(instance)
  services.include? instance
end

#crashesObject

Retrieve crashed instances



115
116
117
118
119
# File 'lib/cfoundry/v1/app.rb', line 115

def crashes
  @client.base.crashes(@name).collect do |i|
    Instance.new(self, i[:instance].to_s, @client, i)
  end
end

#create!Object

Create the application on the target.

Call this after setting the various attributes.



94
95
96
97
# File 'lib/cfoundry/v1/app.rb', line 94

def create!
  @client.base.create_app(create_manifest)
  @diff = {}
end

#delete!Object

Delete the application from the target.

Keeps the metadata, but clears target-specific state from it.



82
83
84
85
86
87
88
89
# File 'lib/cfoundry/v1/app.rb', line 82

def delete!
  @client.base.delete_app(@name)

  if @manifest
    @diff = read_manifest
    @manifest = nil
  end
end

#eql?(other) ⇒ Boolean Also known as: ==

Basic equality test by name.

Returns:

  • (Boolean)


74
75
76
# File 'lib/cfoundry/v1/app.rb', line 74

def eql?(other)
  other.is_a?(self.class) && other.name == @name
end

#exists?Boolean

Check if the application exists on the target.

Returns:

  • (Boolean)


100
101
102
103
104
105
# File 'lib/cfoundry/v1/app.rb', line 100

def exists?
  @client.base.app(@name)
  true
rescue CFoundry::NotFound
  false
end

#file(*path) ⇒ Object

Retrieve file contents for the first instance of the application.

path

A sequence of strings representing path segments.

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



341
342
343
# File 'lib/cfoundry/v1/app.rb', line 341

def file(*path)
  Instance.new(self, "0", @client).file(*path)
end

#files(*path) ⇒ Object

Retrieve file listing under path for the first instance of the application.

path

A sequence of strings representing path segments.

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



331
332
333
# File 'lib/cfoundry/v1/app.rb', line 331

def files(*path)
  Instance.new(self, "0", @client).files(*path)
end

#healthObject

Determine application health.

If all instances are running, returns “RUNNING”. If only some are started, returns the precentage of them that are healthy.

Otherwise, returns application’s status.



168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
# File 'lib/cfoundry/v1/app.rb', line 168

def health
  s = state
  if s == "STARTED"
    healthy_count = running_instances
    expected = total_instances
    if healthy_count && expected > 0
      ratio = healthy_count / expected.to_f
      if ratio == 1.0
        "RUNNING"
      else
        "#{(ratio * 100).to_i}%"
      end
    else
      "N/A"
    end
  else
    s
  end
end

#healthy?Boolean Also known as: running?

Check that all application instances are running.

Returns:

  • (Boolean)


189
190
191
192
193
# File 'lib/cfoundry/v1/app.rb', line 189

def healthy?
  # invalidate cache so the check is fresh
  @manifest = nil
  health == "RUNNING"
end

#inspectObject

Show string representing the application.



69
70
71
# File 'lib/cfoundry/v1/app.rb', line 69

def inspect
  "#<App '#@name'>"
end

#instancesObject

Retrieve all of the instances of the app, as Instance objects.



108
109
110
111
112
# File 'lib/cfoundry/v1/app.rb', line 108

def instances
  @client.base.instances(@name).collect do |m|
    Instance.new(self, m[:index].to_s, @client, m)
  end
end

#restart!Object

Restart the application.



157
158
159
160
# File 'lib/cfoundry/v1/app.rb', line 157

def restart!
  stop!
  start!
end

#start!Object

Start the application.



152
153
154
# File 'lib/cfoundry/v1/app.rb', line 152

def start!
  update! :state => "STARTED"
end

#started?Boolean

Is the application started?

Note that this does not imply that all instances are running. See #healthy?

Returns:

  • (Boolean)


205
206
207
# File 'lib/cfoundry/v1/app.rb', line 205

def started?
  state == "STARTED"
end

#statsObject

Retrieve application statistics, e.g. CPU load and memory usage.



122
123
124
125
126
127
128
129
130
# File 'lib/cfoundry/v1/app.rb', line 122

def stats
  stats = {}

  @client.base.stats(@name).each do |idx, info|
    stats[idx.to_s] = info
  end

  stats
end

#stop!Object

Stop the application.



147
148
149
# File 'lib/cfoundry/v1/app.rb', line 147

def stop!
  update! :state => "STOPPED"
end

#stopped?Boolean

Is the application stopped?

Returns:

  • (Boolean)


197
198
199
# File 'lib/cfoundry/v1/app.rb', line 197

def stopped?
  state == "STOPPED"
end

#unbind(*instances) ⇒ Object

Unbind services from application.



314
315
316
317
318
319
# File 'lib/cfoundry/v1/app.rb', line 314

def unbind(*instances)
  update!(:services =>
            services.reject { |s|
              instances.any? { |i| i.name == s.name }
            })
end

#update!(what = {}) ⇒ Object

Update application attributes. Does not restart the application.



133
134
135
136
137
138
139
140
141
142
143
144
# File 'lib/cfoundry/v1/app.rb', line 133

def update!(what = {})
  what.each do |k, v|
    send(:"#{k}=", v)
  end

  @client.base.update_app(@name, update_manifest)

  @manifest = nil
  @diff = {}

  self
end

#upload(path, check_resources = true) ⇒ Object

Upload application’s code to target. Do this after #create! and before #start!

path

A path pointing to either a directory, or a .jar, .war, or .zip file.

If a .vmcignore file is detected under the given path, it will be used to exclude paths from the payload, similar to a .gitignore.

check_resources

If set to ‘false`, the entire payload will be uploaded without checking the resource cache.

Only do this if you know what you’re doing.



360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
# File 'lib/cfoundry/v1/app.rb', line 360

def upload(path, check_resources = true)
  unless File.exist? path
    raise "invalid application path '#{path}'"
  end

  zipfile = "#{Dir.tmpdir}/#{@name}.zip"
  tmpdir = "#{Dir.tmpdir}/.vmc_#{@name}_files"

  FileUtils.rm_f(zipfile)
  FileUtils.rm_rf(tmpdir)

  prepare_package(path, tmpdir)

  resources = determine_resources(tmpdir) if check_resources

  packed = CFoundry::Zip.pack(tmpdir, zipfile)

  @client.base.upload_app(@name, packed && zipfile, resources || [])
ensure
  FileUtils.rm_f(zipfile) if zipfile
  FileUtils.rm_rf(tmpdir) if tmpdir
end

#uriObject Also known as: url

Shortcut for uris



245
246
247
# File 'lib/cfoundry/v1/app.rb', line 245

def uri
  uris[0]
end

#uri=(x) ⇒ Object Also known as: url=

Shortcut for uris = [x]



250
251
252
# File 'lib/cfoundry/v1/app.rb', line 250

def uri=(x)
  self.uris = [x]
end