Class: CapistranoMulticonfigParallel::Application

Inherits:
Object
  • Object
show all
Includes:
Capistrano::DSL, Capistrano::Multiconfig::DSL, ApplicationHelper, Celluloid, Celluloid::Logger
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 ApplicationHelper

action_confirmed?, check_hash_set, check_numeric, fetch_parsed_string, fetch_remaining_arguments, find_loaded_gem, find_remaining_args, get_question_details, msg_for_stdin?, msg_for_task?, multi_fetch_argv, parse_task_string, percent_of, regex_last_match, setup_command_line_standard, strip_characters_from_string, value_is_array?, verify_array_of_strings, verify_empty_options, warn_array_without_strings, wrap_string

Methods included from CoreHelper

app_debug_enabled?, ask_confirm, ask_stdout_confirmation, check_terminal_tty, debug_websocket?, error_filtered?, execute_with_rescue, find_worker_log, force_confirmation, format_error, log_error, log_output_error, log_to_file, print_to_log_file, rescue_error, rescue_interrupt, setup_filename_logger, setup_logger_formatter, show_warning, websocket_config, websocket_server_config

Methods included from InternalHelper

check_file, config_file, create_log_file, custom_commands, default_internal_config, default_internal_configuration_params, detect_root, enable_main_log_file, fail_capfile_not_found, fetch_default_internal_config, find_config_type, find_env_multi_cap_root, find_file_in_directory, internal_config_directory, internal_config_file, log_directory, main_log_file, multi_level_prop, pathname_is_root?, pwd_directory, pwd_parent_dir, root, setup_default_configuration_types, sliced_default_config, try_detect_capfile

Constructor Details

#initializeApplication

Returns a new instance of Application.



14
15
16
17
18
19
20
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 14

def initialize
  Celluloid.boot
  @stage_apps = multi_apps? ? stages.map { |stage| stage.split(':').reverse[1] }.uniq : []
  collect_command_line_tasks(CapistranoMulticonfigParallel.original_args)
  @job_count = 0
  @jobs = []
end

Instance Attribute Details

#applicationObject (readonly)

Returns the value of attribute application.



11
12
13
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 11

def application
  @application
end

#argsObject (readonly)

Returns the value of attribute args.



11
12
13
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 11

def args
  @args
end

#argvObject (readonly)

Returns the value of attribute argv.



11
12
13
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 11

def argv
  @argv
end

#branch_backupObject (readonly)

Returns the value of attribute branch_backup.



11
12
13
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 11

def branch_backup
  @branch_backup
end

#conditionObject (readonly)

Returns the value of attribute condition.



11
12
13
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 11

def condition
  @condition
end

#default_stageObject (readonly)

Returns the value of attribute default_stage.



11
12
13
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 11

def default_stage
  @default_stage
end

#dependency_trackerObject (readonly)

Returns the value of attribute dependency_tracker.



11
12
13
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 11

def dependency_tracker
  @dependency_tracker
end

#job_countObject

Returns the value of attribute job_count.



11
12
13
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 11

def job_count
  @job_count
end

#jobsObject (readonly)

Returns the value of attribute jobs.



11
12
13
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 11

def jobs
  @jobs
end

#managerObject (readonly)

Returns the value of attribute manager.



11
12
13
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 11

def manager
  @manager
end

#nameObject (readonly)

Returns the value of attribute name.



11
12
13
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 11

def name
  @name
end

#stageObject (readonly)

Returns the value of attribute stage.



11
12
13
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 11

def stage
  @stage
end

#stage_appsObject (readonly)

Returns the value of attribute stage_apps.



11
12
13
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 11

def stage_apps
  @stage_apps
end

#top_level_tasksObject (readonly)

Returns the value of attribute top_level_tasks.



11
12
13
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 11

def top_level_tasks
  @top_level_tasks
end

Instance Method Details

#backup_the_branchObject



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

def backup_the_branch
  return if custom_command? || @argv['BRANCH'].blank?
  @branch_backup = @argv['BRANCH'].to_s
  @argv['BRANCH'] = nil
end

#call_task_deploy_app(options = {}) ⇒ Object



179
180
181
182
183
184
185
186
187
188
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 179

def call_task_deploy_app(options = {})
  options = options.stringify_keys
  main_box_name = @argv['BOX'].blank? ? '' : @argv['BOX']
  stage = options.fetch('stage', @default_stage)
  if configuration.development_stages.include?(stage) && main_box_name.present? && /^[a-z0-9,]+/.match(main_box_name)
    execute_on_multiple_boxes(main_box_name, options)
  else
    prepare_job(options)
  end
end

#can_tag_staging?Boolean

Returns:



138
139
140
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 138

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

#check_before_startingObject



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

def check_before_starting
  CapistranoMulticonfigParallel.enable_logging
  @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

#check_multi_stages(custom_stages) ⇒ Object



142
143
144
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 142

def check_multi_stages(custom_stages)
  can_tag_staging? ? custom_stages.reject { |u| u == 'production' } : custom_stages
end

#collect_command_line_tasks(args) ⇒ Object

:nodoc:



78
79
80
81
82
83
84
85
86
87
88
89
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 78

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



104
105
106
107
108
109
110
111
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 104

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

#custom_command?Boolean

Returns:



59
60
61
62
63
64
65
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 59

def custom_command?
  if multi_apps?
    !stages.include?(@top_level_tasks.first) && custom_commands.include?(@top_level_tasks.first)
  else
    !stages.include?(@top_level_tasks.second) && stages.include?(@top_level_tasks.first) && custom_commands.include?(@top_level_tasks.second)
  end
end

#deploy_app(options = {}) ⇒ Object



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

def deploy_app(options = {})
  options = options.stringify_keys
  branch = @branch_backup.present? ? @branch_backup : @argv['BRANCH'].to_s
  call_task_deploy_app({
    branch: branch,
    app: options['app'],
    action: options['action']
  }.reverse_merge(options))
end

#deploy_multiple_apps(applications, options) ⇒ Object



45
46
47
48
49
50
51
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 45

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']))
  end
end

#execute_on_multiple_boxes(main_box_name, options) ⇒ Object



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

def execute_on_multiple_boxes(main_box_name, options)
  boxes = strip_characters_from_string(main_box_name).split(',').compact
  boxes.each do |box_name|
    options['env_options']['BOX'] = box_name
    prepare_job(options)
  end
end

#fetch_app_additional_env_options(variable) ⇒ Object



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

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



127
128
129
130
131
132
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 127

def fetch_multi_stages
  custom_stages = @argv['STAGES'].blank? ? '' : @argv['STAGES']
  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



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

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



71
72
73
74
75
76
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 71

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

#multi_apps?Boolean

Returns:



67
68
69
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 67

def multi_apps?
  stages.find { |stage| stage.include?(':') }.present?
end

#prepare_job(options) ⇒ Object

rubocop:disable CyclomaticComplexity



214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 214

def prepare_job(options)
  options = options.stringify_keys
  branch_name = options.fetch('branch', {})
  app = options.fetch('app', '')
  box = options['env_options']['BOX']
  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 = branch_name.present? ? { 'BRANCH' => branch_name }.merge(options['env_options']) : options['env_options']
  job_env_options = custom_command? && env_options['ACTION'].present? ? env_options.except('ACTION') : env_options
  @job_count += 1
  job = CapistranoMulticonfigParallel::Job.new(Actor.current, options.merge(
                                                                action: custom_command? && env_options['ACTION'].present? ? env_options['ACTION'] : options['action'],
                                                                env_options: job_env_options,
                                                                count: @job_count
  ))
  @jobs << job
end

#prepare_options(options) ⇒ Object



235
236
237
238
239
240
241
242
243
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 235

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



113
114
115
116
117
118
119
120
121
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 113

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

#runObject



168
169
170
171
172
173
174
175
176
177
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 168

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



190
191
192
193
194
195
196
197
198
199
200
201
202
203
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 190

def run_async_jobs
  return unless @jobs.present?
  @jobs.pmap do |job|
    @manager.async.delegate(job)
  end
  unless can_tag_staging?
    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



36
37
38
39
40
41
42
43
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 36

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

#startObject



22
23
24
25
26
27
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 22

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

#tag_staging_exists?Boolean

check exists task from capistrano-gitflow

Returns:



123
124
125
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 123

def tag_staging_exists? # check exists task from capistrano-gitflow
  find_loaded_gem('capistrano-gitflow').present?
end

#verify_app_dependenciesObject

Raises:



29
30
31
32
33
34
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 29

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



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

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

#wait_jobs_terminationObject



205
206
207
208
209
210
211
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 205

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:



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

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

#worker_environmentsObject



164
165
166
# File 'lib/capistrano_multiconfig_parallel/application.rb', line 164

def worker_environments
  @jobs.map { |job| job['env'] }
end