shoryuken 2.0.11 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. checksums.yaml +4 -4
  2. data/.codeclimate.yml +20 -0
  3. data/.rubocop.yml +8 -2
  4. data/.travis.yml +7 -5
  5. data/CHANGELOG.md +92 -10
  6. data/Gemfile +1 -0
  7. data/README.md +20 -57
  8. data/Rakefile +0 -1
  9. data/bin/cli/base.rb +42 -0
  10. data/bin/cli/sqs.rb +188 -0
  11. data/bin/shoryuken +47 -9
  12. data/examples/default_worker.rb +1 -12
  13. data/lib/shoryuken/client.rb +3 -25
  14. data/lib/shoryuken/default_worker_registry.rb +9 -5
  15. data/lib/shoryuken/environment_loader.rb +29 -67
  16. data/lib/shoryuken/fetcher.rb +22 -53
  17. data/lib/shoryuken/launcher.rb +5 -29
  18. data/lib/shoryuken/manager.rb +72 -184
  19. data/lib/shoryuken/message.rb +4 -13
  20. data/lib/shoryuken/middleware/chain.rb +1 -18
  21. data/lib/shoryuken/middleware/server/auto_extend_visibility.rb +21 -18
  22. data/lib/shoryuken/middleware/server/exponential_backoff_retry.rb +26 -19
  23. data/lib/shoryuken/polling.rb +204 -0
  24. data/lib/shoryuken/processor.rb +6 -14
  25. data/lib/shoryuken/queue.rb +36 -38
  26. data/lib/shoryuken/runner.rb +143 -0
  27. data/lib/shoryuken/util.rb +3 -9
  28. data/lib/shoryuken/version.rb +1 -1
  29. data/lib/shoryuken/worker.rb +1 -1
  30. data/lib/shoryuken.rb +78 -39
  31. data/shoryuken.gemspec +6 -6
  32. data/spec/integration/launcher_spec.rb +4 -3
  33. data/spec/shoryuken/client_spec.rb +2 -43
  34. data/spec/shoryuken/default_worker_registry_spec.rb +12 -10
  35. data/spec/shoryuken/environment_loader_spec.rb +34 -0
  36. data/spec/shoryuken/fetcher_spec.rb +18 -52
  37. data/spec/shoryuken/manager_spec.rb +56 -97
  38. data/spec/shoryuken/middleware/chain_spec.rb +0 -24
  39. data/spec/shoryuken/middleware/server/auto_delete_spec.rb +2 -2
  40. data/spec/shoryuken/middleware/server/auto_extend_visibility_spec.rb +7 -3
  41. data/spec/shoryuken/middleware/server/exponential_backoff_retry_spec.rb +56 -33
  42. data/spec/shoryuken/polling_spec.rb +239 -0
  43. data/spec/shoryuken/processor_spec.rb +5 -5
  44. data/spec/shoryuken/queue_spec.rb +110 -63
  45. data/spec/shoryuken/{cli_spec.rb → runner_spec.rb} +10 -24
  46. data/spec/shoryuken_spec.rb +13 -1
  47. data/spec/spec_helper.rb +8 -20
  48. data/test_workers/endless_interruptive_worker.rb +41 -0
  49. data/test_workers/endless_uninterruptive_worker.rb +44 -0
  50. metadata +34 -35
  51. data/.hound.yml +0 -6
  52. data/lib/shoryuken/cli.rb +0 -210
  53. data/lib/shoryuken/sns_arn.rb +0 -27
  54. data/lib/shoryuken/topic.rb +0 -17
  55. data/spec/shoryuken/sns_arn_spec.rb +0 -42
  56. data/spec/shoryuken/topic_spec.rb +0 -32
  57. data/spec/shoryuken_endpoint.yml +0 -6
  58. /data/{LICENSE.txt → LICENSE} +0 -0
@@ -0,0 +1,204 @@
1
+ module Shoryuken
2
+ module Polling
3
+ QueueConfiguration = Struct.new(:name, :options) do
4
+ def hash
5
+ name.hash
6
+ end
7
+
8
+ def ==(other)
9
+ case other
10
+ when String
11
+ if options.empty?
12
+ name == other
13
+ else
14
+ false
15
+ end
16
+ else
17
+ super
18
+ end
19
+ end
20
+
21
+ alias_method :eql?, :==
22
+
23
+ def to_s
24
+ if options.empty?
25
+ name
26
+ else
27
+ "#<QueueConfiguration #{name} options=#{options.inspect}>"
28
+ end
29
+ end
30
+ end
31
+
32
+ class BaseStrategy
33
+ include Util
34
+
35
+ def next_queue
36
+ fail NotImplementedError
37
+ end
38
+
39
+ def messages_found(queue, messages_found)
40
+ fail NotImplementedError
41
+ end
42
+
43
+ def active_queues
44
+ fail NotImplementedError
45
+ end
46
+
47
+ def ==(other)
48
+ case other
49
+ when Array
50
+ @queues == other
51
+ else
52
+ if other.respond_to?(:active_queues)
53
+ active_queues == other.active_queues
54
+ else
55
+ false
56
+ end
57
+ end
58
+ end
59
+
60
+ private
61
+
62
+ def delay
63
+ Shoryuken.options[:delay].to_f
64
+ end
65
+ end
66
+
67
+ class WeightedRoundRobin < BaseStrategy
68
+ def initialize(queues)
69
+ @initial_queues = queues
70
+ @queues = queues.dup.uniq
71
+ @paused_queues = []
72
+ end
73
+
74
+ def next_queue
75
+ unpause_queues
76
+ queue = @queues.shift
77
+ return nil if queue.nil?
78
+
79
+ @queues << queue
80
+ QueueConfiguration.new(queue, {})
81
+ end
82
+
83
+ def messages_found(queue, messages_found)
84
+ if messages_found == 0
85
+ pause(queue)
86
+ return
87
+ end
88
+
89
+ maximum_weight = maximum_queue_weight(queue)
90
+ current_weight = current_queue_weight(queue)
91
+ if maximum_weight > current_weight
92
+ logger.info { "Increasing '#{queue}' weight to #{current_weight + 1}, max: #{maximum_weight}" }
93
+ @queues << queue
94
+ end
95
+ end
96
+
97
+ def active_queues
98
+ unparse_queues(@queues)
99
+ end
100
+
101
+ private
102
+
103
+ def pause(queue)
104
+ return unless @queues.delete(queue)
105
+ @paused_queues << [Time.now + delay, queue]
106
+ logger.debug "Paused '#{queue}'"
107
+ end
108
+
109
+ def unpause_queues
110
+ return if @paused_queues.empty?
111
+ return if Time.now < @paused_queues.first[0]
112
+ pause = @paused_queues.shift
113
+ @queues << pause[1]
114
+ logger.debug "Unpaused '#{pause[1]}'"
115
+ end
116
+
117
+ def current_queue_weight(queue)
118
+ queue_weight(@queues, queue)
119
+ end
120
+
121
+ def maximum_queue_weight(queue)
122
+ queue_weight(@initial_queues, queue)
123
+ end
124
+
125
+ def queue_weight(queues, queue)
126
+ queues.count { |q| q == queue }
127
+ end
128
+ end
129
+
130
+ class StrictPriority < BaseStrategy
131
+ def initialize(queues)
132
+ # Priority ordering of the queues, highest priority first
133
+ @queues = queues
134
+ .group_by { |q| q }
135
+ .sort_by { |_, qs| -qs.count }
136
+ .map(&:first)
137
+
138
+ # Pause status of the queues, default to past time (unpaused)
139
+ @paused_until = queues
140
+ .each_with_object(Hash.new) { |queue, h| h[queue] = Time.at(0) }
141
+
142
+ # Start queues at 0
143
+ reset_next_queue
144
+ end
145
+
146
+ def next_queue
147
+ next_queue = next_active_queue
148
+ next_queue.nil? ? nil : QueueConfiguration.new(next_queue, {})
149
+ end
150
+
151
+ def messages_found(queue, messages_found)
152
+ if messages_found == 0
153
+ pause(queue)
154
+ else
155
+ reset_next_queue
156
+ end
157
+ end
158
+
159
+ def active_queues
160
+ @queues
161
+ .reverse
162
+ .map.with_index(1)
163
+ .reject { |q, _| queue_paused?(q) }
164
+ .reverse
165
+ end
166
+
167
+ private
168
+
169
+ def next_active_queue
170
+ reset_next_queue if queues_unpaused_since?
171
+
172
+ size = @queues.length
173
+ size.times do
174
+ queue = @queues[@next_queue_index]
175
+ @next_queue_index = (@next_queue_index + 1) % size
176
+ return queue unless queue_paused?(queue)
177
+ end
178
+
179
+ nil
180
+ end
181
+
182
+ def queues_unpaused_since?
183
+ last = @last_unpause_check
184
+ now = @last_unpause_check = Time.now
185
+
186
+ last && @paused_until.values.any? { |t| t > last && t <= now }
187
+ end
188
+
189
+ def reset_next_queue
190
+ @next_queue_index = 0
191
+ end
192
+
193
+ def queue_paused?(queue)
194
+ @paused_until[queue] > Time.now
195
+ end
196
+
197
+ def pause(queue)
198
+ return unless delay > 0
199
+ @paused_until[queue] = Time.now + delay
200
+ logger.debug "Paused '#{queue}'"
201
+ end
202
+ end
203
+ end
204
+ end
@@ -1,28 +1,20 @@
1
- require 'json'
2
-
3
1
  module Shoryuken
4
2
  class Processor
5
- include Celluloid
6
3
  include Util
7
4
 
8
5
  def initialize(manager)
9
6
  @manager = manager
10
7
  end
11
8
 
12
- attr_accessor :proxy_id
13
-
14
9
  def process(queue, sqs_msg)
15
- @manager.async.real_thread(proxy_id, Thread.current)
16
-
17
10
  worker = Shoryuken.worker_registry.fetch_worker(queue, sqs_msg)
11
+ body = get_body(worker.class, sqs_msg)
18
12
 
19
- body = get_body(worker.class, sqs_msg)
20
-
21
- worker.class.server_middleware.invoke(worker, queue, sqs_msg, body) do
22
- worker.perform(sqs_msg, body)
23
- end
24
-
25
- @manager.async.processor_done(queue, current_actor)
13
+ worker.class.server_middleware.invoke(worker, queue, sqs_msg, body) do
14
+ worker.perform(sqs_msg, body)
15
+ end
16
+ ensure
17
+ @manager.processor_done(queue)
26
18
  end
27
19
 
28
20
  private
@@ -1,22 +1,21 @@
1
1
  module Shoryuken
2
2
  class Queue
3
+ FIFO_ATTR = 'FifoQueue'
4
+ MESSAGE_GROUP_ID = 'ShoryukenMessage'
5
+ VISIBILITY_TIMEOUT_ATTR = 'VisibilityTimeout'
6
+
3
7
  attr_accessor :name, :client, :url
4
8
 
5
9
  def initialize(client, name)
6
10
  self.name = name
7
11
  self.client = client
8
- begin
9
- self.url = client.get_queue_url(queue_name: name).queue_url
10
- rescue Aws::SQS::Errors::NonExistentQueue => e
11
- raise e, "The specified queue '#{name}' does not exist"
12
- end
12
+ self.url = client.get_queue_url(queue_name: name).queue_url
13
+ rescue Aws::SQS::Errors::NonExistentQueue => e
14
+ raise e, "The specified queue '#{name}' does not exist."
13
15
  end
14
16
 
15
17
  def visibility_timeout
16
- client.get_queue_attributes(
17
- queue_url: url,
18
- attribute_names: ['VisibilityTimeout']
19
- ).attributes['VisibilityTimeout'].to_i
18
+ queue_attributes.attributes[VISIBILITY_TIMEOUT_ATTR].to_i
20
19
  end
21
20
 
22
21
  def delete_messages(options)
@@ -36,54 +35,53 @@ module Shoryuken
36
35
  end
37
36
 
38
37
  def receive_messages(options)
39
- client.receive_message(options.merge(queue_url: url)).
40
- messages.
41
- map { |m| Message.new(client, self, m) }
38
+ client.receive_message(options.merge(queue_url: url)).messages.map { |m| Message.new(client, self, m) }
39
+ end
40
+
41
+ def fifo?
42
+ @_fifo ||= queue_attributes.attributes[FIFO_ATTR] == 'true'
42
43
  end
43
44
 
44
45
  private
45
46
 
47
+ def queue_attributes
48
+ # Note: Retrieving all queue attributes as requesting `FifoQueue` on non-FIFO queue raises error.
49
+ # See issue: https://github.com/aws/aws-sdk-ruby/issues/1350
50
+ client.get_queue_attributes(queue_url: url, attribute_names: ['All'])
51
+ end
52
+
46
53
  def sanitize_messages!(options)
47
- options = case
48
- when options.is_a?(Array)
49
- { entries: options.map.with_index do |m, index|
50
- { id: index.to_s }.merge(m.is_a?(Hash) ? m : { message_body: m })
51
- end }
52
- when options.is_a?(Hash)
53
- options
54
- end
54
+ if options.is_a?(Array)
55
+ entries = options.map.with_index do |m, index|
56
+ { id: index.to_s }.merge(m.is_a?(Hash) ? m : { message_body: m })
57
+ end
55
58
 
56
- validate_messages!(options)
59
+ options = { entries: entries }
60
+ end
61
+
62
+ options[:entries].each(&method(:sanitize_message!))
57
63
 
58
64
  options
59
65
  end
60
66
 
61
- def sanitize_message!(options)
62
- options = case
63
- when options.is_a?(String)
64
- # send_message('message')
65
- { message_body: options }
66
- when options.is_a?(Hash)
67
- options
68
- end
67
+ def add_fifo_attributes!(options)
68
+ return unless fifo?
69
69
 
70
- validate_message!(options)
70
+ options[:message_group_id] ||= MESSAGE_GROUP_ID
71
+ options[:message_deduplication_id] ||= Digest::SHA256.hexdigest(options[:message_body].to_s)
71
72
 
72
73
  options
73
74
  end
74
75
 
75
- def validate_messages!(options)
76
- options[:entries].map { |m| validate_message!(m) }
77
- end
76
+ def sanitize_message!(options)
77
+ options = { message_body: options } if options.is_a?(String)
78
78
 
79
- def validate_message!(options)
80
- body = options[:message_body]
81
- if body.is_a?(Hash)
79
+ if (body = options[:message_body]).is_a?(Hash)
82
80
  options[:message_body] = JSON.dump(body)
83
- elsif !body.is_a?(String)
84
- fail ArgumentError, "The message body must be a String and you passed a #{body.class}"
85
81
  end
86
82
 
83
+ add_fifo_attributes!(options)
84
+
87
85
  options
88
86
  end
89
87
  end
@@ -0,0 +1,143 @@
1
+ $stdout.sync = true
2
+
3
+ require 'singleton'
4
+ require 'optparse'
5
+ require 'erb'
6
+
7
+ require 'shoryuken'
8
+
9
+ module Shoryuken
10
+ # rubocop:disable Lint/InheritException
11
+ # rubocop:disable Metrics/AbcSize
12
+ # See: https://github.com/mperham/sidekiq/blob/33f5d6b2b6c0dfaab11e5d39688cab7ebadc83ae/lib/sidekiq/cli.rb#L20
13
+ class Shutdown < Interrupt; end
14
+
15
+ class Runner
16
+ include Util
17
+ include Singleton
18
+
19
+ def run(options)
20
+ self_read, self_write = IO.pipe
21
+
22
+ %w(INT TERM USR1 USR2 TTIN).each do |sig|
23
+ begin
24
+ trap sig do
25
+ self_write.puts(sig)
26
+ end
27
+ rescue ArgumentError
28
+ puts "Signal #{sig} not supported"
29
+ end
30
+ end
31
+
32
+ loader = EnvironmentLoader.setup_options(options)
33
+
34
+ # When cli args exist, override options in config file
35
+ Shoryuken.options.merge!(options)
36
+
37
+ daemonize(Shoryuken.options)
38
+ write_pid(Shoryuken.options)
39
+
40
+ loader.load
41
+
42
+ initialize_concurrent_logger
43
+
44
+ @launcher = Shoryuken::Launcher.new
45
+
46
+ if (callback = Shoryuken.start_callback)
47
+ logger.info { 'Calling Shoryuken.on_start block' }
48
+ callback.call
49
+ end
50
+
51
+ fire_event(:startup)
52
+
53
+ begin
54
+ @launcher.run
55
+
56
+ while (readable_io = IO.select([self_read]))
57
+ signal = readable_io.first[0].gets.strip
58
+ handle_signal(signal)
59
+ end
60
+ rescue Interrupt
61
+ @launcher.stop(shutdown: true)
62
+ exit 0
63
+ end
64
+ end
65
+
66
+ private
67
+
68
+ def initialize_concurrent_logger
69
+ return unless Shoryuken.logger
70
+
71
+ Concurrent.global_logger = lambda do |level, progname, msg = nil, &block|
72
+ Shoryuken.logger.log(level, msg, progname, &block)
73
+ end
74
+ end
75
+
76
+ def daemonize(options)
77
+ return unless options[:daemon]
78
+
79
+ files_to_reopen = []
80
+ ObjectSpace.each_object(File) do |file|
81
+ files_to_reopen << file unless file.closed?
82
+ end
83
+
84
+ Process.daemon(true, true)
85
+
86
+ files_to_reopen.each do |file|
87
+ begin
88
+ file.reopen file.path, 'a+'
89
+ file.sync = true
90
+ rescue ::Exception
91
+ end
92
+ end
93
+
94
+ [$stdout, $stderr].each do |io|
95
+ File.open(options[:logfile], 'ab') do |f|
96
+ io.reopen(f)
97
+ end
98
+ io.sync = true
99
+ end
100
+ $stdin.reopen('/dev/null')
101
+ end
102
+
103
+ def write_pid(options)
104
+ return unless (path = options[:pidfile])
105
+
106
+ File.open(path, 'w') { |f| f.puts(Process.pid) }
107
+ end
108
+
109
+ def execute_soft_shutdown
110
+ logger.info { 'Received USR1, will soft shutdown down' }
111
+
112
+ @launcher.stop
113
+ fire_event(:quiet, true)
114
+ exit 0
115
+ end
116
+
117
+ def print_threads_backtrace
118
+ Thread.list.each do |thread|
119
+ logger.info { "Thread TID-#{thread.object_id.to_s(36)} #{thread['label']}" }
120
+ if thread.backtrace
121
+ logger.info { thread.backtrace.join("\n") }
122
+ else
123
+ logger.info { '<no backtrace available>' }
124
+ end
125
+ end
126
+ end
127
+
128
+ def handle_signal(sig)
129
+ logger.info { "Got #{sig} signal" }
130
+
131
+ case sig
132
+ when 'USR1' then execute_soft_shutdown
133
+ when 'TTIN' then print_threads_backtrace
134
+ when 'USR2'
135
+ logger.warn { "Received #{sig}, will do nothing. To execute soft shutdown, please send USR1" }
136
+ else
137
+ logger.info { "Received #{sig}, will shutdown down" }
138
+
139
+ raise Interrupt
140
+ end
141
+ end
142
+ end
143
+ end
@@ -1,13 +1,5 @@
1
1
  module Shoryuken
2
2
  module Util
3
- def watchdog(last_words)
4
- yield
5
- rescue => ex
6
- logger.error { last_words }
7
- logger.error { ex }
8
- logger.error { ex.backtrace.join("\n") }
9
- end
10
-
11
3
  def logger
12
4
  Shoryuken.logger
13
5
  end
@@ -42,7 +34,9 @@ module Shoryuken
42
34
  && !sqs_msg.is_a?(Array) \
43
35
  && sqs_msg.message_attributes \
44
36
  && sqs_msg.message_attributes['shoryuken_class'] \
45
- && sqs_msg.message_attributes['shoryuken_class'][:string_value] == ActiveJob::QueueAdapters::ShoryukenAdapter::JobWrapper.to_s
37
+ && sqs_msg.message_attributes['shoryuken_class'][:string_value] \
38
+ == ActiveJob::QueueAdapters::ShoryukenAdapter::JobWrapper.to_s \
39
+ && body
46
40
 
47
41
  "ActiveJob/#{body['job_class']}"
48
42
  else
@@ -1,3 +1,3 @@
1
1
  module Shoryuken
2
- VERSION = '2.0.11'
2
+ VERSION = '3.0.0'.freeze
3
3
  end
@@ -63,7 +63,7 @@ module Shoryuken
63
63
 
64
64
  def normalize_worker_queue!
65
65
  queue = @shoryuken_options['queue']
66
- if queue.respond_to? :call
66
+ if queue.respond_to?(:call)
67
67
  queue = queue.call
68
68
  @shoryuken_options['queue'] = queue
69
69
  end