Class: CapistranoMulticonfigParallel::Application

Inherits:
Object
  • Object
show all
Includes:
BaseActorHelper
Defined in:
lib/capistrano_multiconfig_parallel/application.rb

Overview

finds app dependencies, shows menu and delegates jobs to celluloid manager

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from BaseActorHelper

included

Constructor Details

#initializeApplication

Returns a new instance of Application.



9
10
11
12
13
14
15
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 9

def initialize
  Celluloid.boot unless Celluloid.running?
  CapistranoMulticonfigParallel.enable_logging
  @stage_apps = multi_apps? ? app_names_from_stages : []
  collect_command_line_tasks(CapistranoMulticonfigParallel.original_args)
  @jobs = []
end

Instance Attribute Details

#applicationObject (readonly)

Returns the value of attribute application.



7
8
9
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 7

def application
  @application
end

#argsObject (readonly)

Returns the value of attribute args.



7
8
9
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 7

def args
  @args
end

#argvObject (readonly)

Returns the value of attribute argv.



7
8
9
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 7

def argv
  @argv
end

#conditionObject (readonly)

Returns the value of attribute condition.



7
8
9
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 7

def condition
  @condition
end

#default_stageObject (readonly)

Returns the value of attribute default_stage.



7
8
9
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 7

def default_stage
  @default_stage
end

#dependency_trackerObject (readonly)

Returns the value of attribute dependency_tracker.



7
8
9
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 7

def dependency_tracker
  @dependency_tracker
end

#jobsObject (readonly)

Returns the value of attribute jobs.



7
8
9
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 7

def jobs
  @jobs
end

#managerObject (readonly)

Returns the value of attribute manager.



7
8
9
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 7

def manager
  @manager
end

#nameObject (readonly)

Returns the value of attribute name.



7
8
9
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 7

def name
  @name
end

#stageObject (readonly)

Returns the value of attribute stage.



7
8
9
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 7

def stage
  @stage
end

#stage_appsObject (readonly)

Returns the value of attribute stage_apps.



7
8
9
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 7

def stage_apps
  @stage_apps
end

#top_level_tasksObject (readonly)

Returns the value of attribute top_level_tasks.



7
8
9
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 7

def top_level_tasks
  @top_level_tasks
end

Instance Method Details

#action_keyObject



82
83
84
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 82

def action_key
  'ACTION'
end

#boxes_keyObject



166
167
168
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 166

def boxes_key
  'BOX'
end

#call_task_deploy_app(options = {}) ⇒ Object



170
171
172
173
174
175
176
177
178
179
180
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 170

def call_task_deploy_app(options = {})
  options = options.stringify_keys
  main_box_name = @argv[boxes_key].blank? ? '' : @argv[boxes_key]
  boxes = strip_characters_from_string(main_box_name).split(',').compact
  stage = options.fetch('stage', @default_stage)
  if configuration.development_stages.include?(stage) && boxes.present?
    execute_on_multiple_boxes(boxes, options)
  else
    prepare_job(options)
  end
end

#can_tag_staging?Boolean

Returns:

  • (Boolean)


135
136
137
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 135

def can_tag_staging?
  wants_deploy_production? && fetch_multi_stages.include?('staging')
end

#check_before_startingObject



91
92
93
94
95
96
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 91

def check_before_starting
  @dependency_tracker = CapistranoMulticonfigParallel::DependencyTracker.new(Actor.current)
  @default_stage = configuration.development_stages.present? ? configuration.development_stages.first : 'development'
  @condition = Celluloid::Condition.new
  @manager = CapistranoMulticonfigParallel::CelluloidManager.new(Actor.current)
end

#collect_command_line_tasks(args) ⇒ Object

:nodoc:



69
70
71
72
73
74
75
76
77
78
79
80
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 69

def collect_command_line_tasks(args) # :nodoc:
  @argv = {}
  @top_level_tasks = []
  args.each do |arg|
    if arg =~ /^(\w+)=(.*)$/m
      @argv[Regexp.last_match(1)] = Regexp.last_match(2)
    else
      @top_level_tasks << arg unless arg =~ /^-/
    end
  end
  @top_level_tasks.push(Rake.application.default_task_name) if @top_level_tasks.blank?
end

#collect_jobs(options = {}, &_block) ⇒ Object



98
99
100
101
102
103
104
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 98

def collect_jobs(options = {}, &_block)
  options = prepare_options(options)
  options = options.stringify_keys
  apps, app_options = @dependency_tracker.fetch_apps_needed_for_deployment(options['app'], options['action'])
  deploy_multiple_apps(apps, options)
  deploy_app(options.merge(app_options)) if !custom_command? || !multi_apps?
end

#custom_command?Boolean

Returns:

  • (Boolean)


48
49
50
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 48

def custom_command?
  custom_commands.include?(@top_level_tasks.first)
end

#deploy_app(options = {}) ⇒ Object



139
140
141
142
143
144
145
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 139

def deploy_app(options = {})
  options = options.stringify_keys
  call_task_deploy_app({
    app: options['app'],
    action: options['action']
  }.reverse_merge(options))
end

#deploy_multiple_apps(applications, options) ⇒ Object



40
41
42
43
44
45
46
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 40

def deploy_multiple_apps(applications, options)
  options = options.stringify_keys
  return unless applications.present?
  applications.each do |app|
    deploy_app(options.merge('app' => app['app'], 'path' => app.fetch('path', nil)))
  end
end

#execute_on_multiple_boxes(boxes, options) ⇒ Object



263
264
265
266
267
268
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 263

def execute_on_multiple_boxes(boxes, options)
  boxes.each do |box_name|
    options['env_options'][boxes_key] = box_name
    prepare_job(options)
  end
end

#fetch_app_additional_env_options(variable) ⇒ Object



253
254
255
256
257
258
259
260
261
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 253

def fetch_app_additional_env_options(variable)
  options = {}
  return options if variable.blank?
  env_options = strip_characters_from_string(variable)
  env_options = env_options.split(' ')
  options = multi_fetch_argv(env_options)
  options.stringify_keys!
  options
end

#fetch_multi_stagesObject



124
125
126
127
128
129
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 124

def fetch_multi_stages
  custom_stages = @argv[stages_key].blank? ? '' : @argv[stages_key]
  custom_stages = strip_characters_from_string(custom_stages).split(',').compact if custom_stages.present?
  custom_stages = custom_stages.present? ? custom_stages : [@default_stage]
  custom_stages
end

#get_app_additional_env_options(app, app_message) ⇒ Object



147
148
149
150
151
152
153
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 147

def get_app_additional_env_options(app, app_message)
  app_name = (app.is_a?(Hash) && app[:app].present?) ? app[:app].camelcase : app
  app_name = app_name.present? ? app_name : 'current application'
  message = "Please write additional ENV options for #{app_name} for #{app_message}"
  app_additional_env_options = ask_confirm(message, nil)
  fetch_app_additional_env_options(app_additional_env_options)
end

#initialize_dataObject



62
63
64
65
66
67
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 62

def initialize_data
  @application = custom_command? ? nil : @top_level_tasks.first.split(':').reverse[1]
  @stage = custom_command? ? nil : @top_level_tasks.first.split(':').reverse[0]
  @stage = @stage.present? ? @stage : @default_stage
  @name, @args = parse_task_string(@top_level_tasks.second)
end

#job_can_tag_staging?(job) ⇒ Boolean

Returns:

  • (Boolean)


226
227
228
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 226

def job_can_tag_staging?(job)
  can_tag_staging? && job.stage == 'production' && job.gitflow.present?
end

#job_path(options) ⇒ Object



230
231
232
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 230

def job_path(options)
    options.fetch("path", detect_root)
end

#job_stage(options) ⇒ Object



238
239
240
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 238

def job_stage(options)
  multi_apps?(job_path(options)) && options.fetch('app', nil).present? ? "#{options['app']}:#{options['stage']}" : "#{options['stage']}"
end

#job_stage_valid?(options) ⇒ Boolean

Returns:

  • (Boolean)


234
235
236
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 234

def job_stage_valid?(options)
    stages(job_path(options)).include?(job_stage(options))
end

#prepare_job(options) ⇒ Object



205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 205

def prepare_job(options)
  options = options.stringify_keys
  return raise_invalid_job_config if !job_stage_valid?(options)
  app = options.fetch('app', '')
  box = options['env_options'][boxes_key]
  message = box.present? ? "BOX #{box}:" : "stage #{options['stage']}:"
  env_opts = get_app_additional_env_options(app, message)

  options['env_options'] = options['env_options'].reverse_merge(env_opts)

  env_options = options['env_options']
  job_env_options = custom_command? ? env_options.except(action_key) : env_options
  job = CapistranoMulticonfigParallel::Job.new(Actor.current, options.merge(
                                                                action: custom_command? && env_options[action_key].present? ? env_options[action_key] : options['action'],
                                                                env_options: job_env_options,
                                                                path: options.fetch('path', nil)

  ))
  @jobs << job unless job_can_tag_staging?(job)
end

#prepare_options(options) ⇒ Object



243
244
245
246
247
248
249
250
251
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 243

def prepare_options(options)
  options = options.stringify_keys
  options['app'] = options.fetch('app', @application.to_s.clone)
  options['action'] = options.fetch('action', @name.to_s.clone)
  options['stage'] = options.fetch('stage', @stage.to_s.clone)
  options['env_options'] = options.fetch('env_options', @argv.clone)
  options['task_arguments'] = options.fetch('task_arguments', @args.clone)
  options
end

#process_jobsObject



106
107
108
109
110
111
112
113
114
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 106

def process_jobs
  return unless @jobs.present?
  FileUtils.rm Dir["#{log_directory}/worker_*.log"]
  if configuration.multi_secvential.to_s.downcase == 'true'
    @jobs.each(&:execute_standard_deploy)
  else
    run_async_jobs
  end
end

#raise_invalid_job_configObject



57
58
59
60
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 57

def raise_invalid_job_config
    puts 'Invalid execution, please call something such as `multi_cap production deploy`, where production is a stage you have defined'.red
    exit(false)
end

#runObject



155
156
157
158
159
160
161
162
163
164
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 155

def run
  options = {}
  if custom_command?
    options = verify_options_custom_command(options)
    run_custom_command(options)
  else
    collect_jobs(options)
  end
  process_jobs
end

#run_async_jobsObject



182
183
184
185
186
187
188
189
190
191
192
193
194
195
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 182

def run_async_jobs
  return unless @jobs.present?
  @jobs.pmap do |job|
    @manager.async.delegate_job(job)
  end
  unless can_tag_staging? && tag_staging_exists?
    until @manager.registration_complete
      sleep(0.1) # keep current thread alive
    end
    return unless @manager.registration_complete
    @manager.async.process_jobs
  end
  wait_jobs_termination
end

#run_custom_command(options) ⇒ Object



32
33
34
35
36
37
38
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 32

def run_custom_command(options)
  custom_stages = fetch_multi_stages
  return if custom_stages.blank?
  custom_stages.each do |stage|
    collect_jobs(options.merge('stage' => stage))
  end
end

#stages_keyObject



120
121
122
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 120

def stages_key
  'STAGES'
end

#startObject



17
18
19
20
21
22
23
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 17

def start
  verify_app_dependencies if multi_apps? && configuration.application_dependencies.present?
  initialize_data
  verify_valid_data
  check_before_starting
  run
end

#tag_staging_exists?Boolean

check exists task from capistrano-gitflow

Returns:

  • (Boolean)


116
117
118
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 116

def tag_staging_exists? # check exists task from capistrano-gitflow
  @jobs.find(&:gitflow).present?
end

#verify_app_dependenciesObject

Raises:

  • (ArgumentError)


25
26
27
28
29
30
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 25

def verify_app_dependencies
  wrong = configuration.application_dependencies.find do |hash|
    !@stage_apps.include?(hash[:app]) || (hash[:dependencies].present? && hash[:dependencies].find { |val| !@stage_apps.include?(val) })
  end
  raise ArgumentError, "Invalid configuration for #{wrong.inspect}".red if wrong.present?
end

#verify_options_custom_command(options) ⇒ Object



86
87
88
89
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 86

def verify_options_custom_command(options)
  options[:action] = @argv[action_key].present? ? @argv[action_key] : 'deploy'
  options
end

#verify_valid_dataObject



52
53
54
55
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 52

def verify_valid_data
 return if  @top_level_tasks != ['default']
 raise_invalid_job_config
end

#wait_jobs_terminationObject



197
198
199
200
201
202
203
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 197

def wait_jobs_termination
  return if configuration.multi_secvential.to_s.downcase == 'true'
  result = @condition.wait
  return unless result.present?
  @manager.terminate
  terminate
end

#wants_deploy_production?Boolean

Returns:

  • (Boolean)


131
132
133
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 131

def wants_deploy_production?
  (!custom_command? && @stage == 'production') || (custom_command? && fetch_multi_stages.include?('production'))
end