sidekiq 6.1.3 → 6.2.0

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of sidekiq might be problematic. Click here for more details.

data/4.0-Upgrade.md DELETED
@@ -1,53 +0,0 @@
1
- # Welcome to Sidekiq 4.0!
2
-
3
- Sidekiq 4.0 contains a redesigned, more efficient core with less overhead per job.
4
- See my blog for [an overview of Sidekiq 4's higher performance](http://www.mikeperham.com/2015/10/14/optimizing-sidekiq/).
5
-
6
- ## What's New
7
-
8
- * Sidekiq no longer uses Celluloid. If your application code uses Celluloid,
9
- you will need to pull it in yourself.
10
-
11
- * `redis-namespace` has been removed from Sidekiq's gem dependencies. If
12
- you want to use namespacing ([and I strongly urge you not to](http://www.mikeperham.com/2015/09/24/storing-data-with-redis/)), you'll need to add the gem to your Gemfile:
13
- ```ruby
14
- gem 'redis-namespace'
15
- ```
16
-
17
- * **Redis 2.8.0 or greater is required.** Redis 2.8 was released two years
18
- ago and contains **many** useful features which Sidekiq couldn't
19
- leverage until now. **Redis 3.0.3 or greater is recommended** for large
20
- scale use [#2431](https://github.com/mperham/sidekiq/issues/2431).
21
-
22
- * Jobs are now fetched from Redis in parallel, making Sidekiq more
23
- resilient to high network latency. This means that Sidekiq requires
24
- more Redis connections per process. You must have a minimum of
25
- `concurrency + 2` connections in your pool or Sidekiq will exit.
26
- When in doubt, let Sidekiq size the connection pool for you.
27
-
28
- * Worker data is no longer updated in real-time but rather upon every
29
- heartbeat. Don't expect the `Sidekiq::Workers` API to be millisecond-precise.
30
-
31
- * There's a new testing API based off the `Sidekiq::Queues` namespace. All
32
- assertions made against the Worker class still work as expected.
33
- ```ruby
34
- assert_equal 0, Sidekiq::Queues["default"].size
35
- HardWorker.perform_async("log")
36
- assert_equal 1, Sidekiq::Queues["default"].size
37
- assert_equal "log", Sidekiq::Queues["default"].first['args'][0]
38
- Sidekiq::Queues.clear_all
39
- ```
40
-
41
- ## Upgrade
42
-
43
- First, make sure you are using Redis 2.8 or greater. Next:
44
-
45
- * Upgrade to the latest Sidekiq 3.x.
46
- ```ruby
47
- gem 'sidekiq', '< 4'
48
- ```
49
- * Fix any deprecation warnings you see.
50
- * Upgrade to 4.x.
51
- ```ruby
52
- gem 'sidekiq', '< 5'
53
- ```
data/5.0-Upgrade.md DELETED
@@ -1,56 +0,0 @@
1
- # Welcome to Sidekiq 5.0!
2
-
3
- Sidekiq 5.0 contains a reworked job dispatch and execution core to integrate
4
- better with the new Rails 5.0 Executor. It also drops support for older
5
- versions of Ruby and Rails and adds support for RTL languages in the Web UI.
6
-
7
- ## What's New
8
-
9
- * Integrate job logging and retry logic directly in with the job
10
- execution logic in Sidekiq::Processor. Previously this logic was
11
- defined as middleware. In Rails 5.0, ActiveSupport::Executor handles ActiveRecord
12
- connection management, job callbacks, development mode class loading,
13
- etc. Because of its extensive responsibilities, the Executor can't be
14
- integrated as Sidekiq middleware; the logging/retry logic had to be pulled out
15
- too. Sidekiq 4.2 had a hack to make it work but this redesign provides
16
- a cleaner integration. [#3235]
17
- * The Delayed Extensions `delay`, `delay_for` and `delay_until` APIs are
18
- no longer available by default. The extensions allow you to marshal
19
- job arguments as YAML, leading to cases where job payloads could be many
20
- 100s of KB or larger if not careful, leading to Redis networking
21
- timeouts or other problems. As noted in the Best Practices wiki page,
22
- Sidekiq is designed for jobs with small, simple arguments.
23
-
24
- Add this line to your initializer to re-enable them and get the old behavior:
25
- ```ruby
26
- Sidekiq::Extensions.enable_delay!
27
- ```
28
- The old `Sidekiq.remove_delay!` API has been removed as it is now the default. [#3299]
29
- * Sidekiq's quiet signal is now `TSTP` (think of it as **T**hread
30
- **ST**o**P**) instead of USR1 as USR1 is not available on JRuby.
31
- USR1 will continue to be supported in Sidekiq 5.x for backwards
32
- compatibility and will be removed in Sidekiq 6.x. [#3302]
33
- * The Web UI is now bi-directional - it can render either LTR
34
- (left-to-right) or RTL languages. With this change, **Farsi, Arabic,
35
- Hebrew and Urdu** are officially supported. [#3381]
36
- * Jobs which can't be parsed due to invalid JSON are now pushed
37
- immediately to the Dead set since they require manual intervention and
38
- will never execute successfully as is. The Web UI has been updated to
39
- more gracefully display these jobs. [#3296]
40
- * **Rails 3.2** is no longer supported.
41
- * **Ruby 2.0 and Ruby 2.1** are no longer supported. Ruby 2.2.2+ is required.
42
-
43
- ## Upgrade
44
-
45
- As always, please upgrade Sidekiq **one major version at a time**.
46
- If you are already running Sidekiq 4.x, then:
47
-
48
- * Upgrade to the latest Sidekiq 4.x.
49
- ```ruby
50
- gem 'sidekiq', '< 5'
51
- ```
52
- * Fix any deprecation warnings you see.
53
- * Upgrade to 5.x.
54
- ```ruby
55
- gem 'sidekiq', '< 6'
56
- ```
data/6.0-Upgrade.md DELETED
@@ -1,72 +0,0 @@
1
- # Welcome to Sidekiq 6.0!
2
-
3
- Sidekiq 6.0 contains some breaking changes which streamline proper operation
4
- of Sidekiq. It also drops support for EOL versions of Ruby and Rails.
5
-
6
- ## What's New
7
-
8
- This release has major breaking changes. Read and test carefully in production.
9
-
10
- - ActiveJobs can now use `sidekiq_options` directly to configure Sidekiq
11
- features/internals like the retry subsystem. Prefer the native
12
- Sidekiq::Worker APIs as some Sidekiq features (e.g. unique jobs) do not work well with AJ.
13
- (requires Rails 6.0.2)
14
- ```ruby
15
- class MyJob < ActiveJob::Base
16
- queue_as :myqueue
17
- sidekiq_options retry: 10, backtrace: 20
18
- def perform(...)
19
- end
20
- end
21
- ```
22
- - Logging has been redesigned to allow pluggable formatters and several
23
- formats ship with Sidekiq:
24
- * default - your typical output on macOS
25
- * heroku - enabled specifically when running in Heroku
26
- * json - a JSON format for search indexing, one hash per line
27
-
28
- Sidekiq will enable the best formatter for the detected environment but
29
- you can override it by configuring the log formatter explicitly. See
30
- 'sidekiq/logger' for implementation details.
31
-
32
- ```ruby
33
- Sidekiq.configure_server do |config|
34
- config.log_formatter = AcmeCorp::PlainLogFormatter.new
35
- # config.log_formatter = Sidekiq::Logger::Formatters::JSON.new
36
- end
37
- ```
38
- Please see the [Logging](https://github.com/mperham/sidekiq/wiki/Logging) wiki page for the latest documentation and notes.
39
- - **Remove the daemonization, logfile and pidfile command line arguments and `sidekiqctl` binary**.
40
- I've [noted for years](https://www.mikeperham.com/2014/09/22/dont-daemonize-your-daemons/)
41
- how modern services should be managed with a proper init system.
42
- Managing services manually is more error-prone, let your operating system do it for you.
43
- systemd, upstart, and foreman are three options. See the Deployment wiki page for the latest details.
44
- - **Validate proper usage of the `REDIS_PROVIDER` variable.**
45
- This variable is meant to hold the name of the environment
46
- variable which contains your Redis URL, so that you can switch Redis
47
- providers quickly and easily with a single variable change. It is not
48
- meant to hold the actual Redis URL itself. If you want to manually set
49
- the Redis URL then you may set `REDIS_URL` directly. [#3969]
50
- - **Increase default shutdown timeout from 8 seconds to 25 seconds.**
51
- Both Heroku and ECS now use 30 second shutdown timeout
52
- by default and we want Sidekiq to take advantage of this time. If you
53
- have deployment scripts which depend on the old default timeout, use `-t 8` to
54
- get the old behavior. [#3968]
55
- * **Rails <5** is no longer supported. Rails 6+ only works in zeitwerk mode.
56
- * **Ruby <2.5** is no longer supported.
57
- * **Redis <4** is no longer supported.
58
-
59
- ## Upgrade
60
-
61
- As always, please upgrade Sidekiq **one major version at a time**.
62
- If you are already running Sidekiq 5.x, then:
63
-
64
- * Upgrade to the latest Sidekiq 5.x.
65
- ```ruby
66
- gem 'sidekiq', '< 6'
67
- ```
68
- * Fix any deprecation warnings you see.
69
- * Upgrade to 6.x.
70
- ```ruby
71
- gem 'sidekiq', '< 7'
72
- ```
data/COMM-LICENSE DELETED
@@ -1,97 +0,0 @@
1
- END-USER LICENSE AGREEMENT
2
-
3
- ------------------------------------------------------------------------------
4
-
5
- IMPORTANT: THIS SOFTWARE END-USER LICENSE AGREEMENT ("EULA") IS A LEGAL AGREEMENT (“Agreement”) BETWEEN YOU (THE CUSTOMER, EITHER AS AN INDIVIDUAL OR, IF PURCHASED OR OTHERWISE ACQUIRED BY OR FOR AN ENTITY, AS AN ENTITY) AND CONTRIBUTED SYSTEMS. READ IT CAREFULLY BEFORE COMPLETING THE INSTALLATION PROCESS AND USING SIDEKIQ PRO AND RELATED SOFTWARE COMPONENTS (“SOFTWARE”). IT PROVIDES A LICENSE TO USE THE SOFTWARE AND CONTAINS WARRANTY INFORMATION AND LIABILITY DISCLAIMERS. BY INSTALLING AND USING THE SOFTWARE, YOU ARE CONFIRMING YOUR ACCEPTANCE OF THE SOFTWARE AND AGREEING TO BECOME BOUND BY THE TERMS OF THIS AGREEMENT.
6
-
7
- ------------------------------------------------------------------------------
8
-
9
- In order to use the Software under this Agreement, you must receive a “Source URL” at the time of purchase, in accordance with the scope of use and other terms specified for each type of Software and as set forth in this Section 1 of this Agreement.
10
-
11
- 1. License Grant
12
-
13
- 1.1 General Use. This Agreement grants you a non-exclusive, non-transferable, limited license to the use rights for the Software, without the right to grant sublicenses, subject to the terms and conditions in this Agreement. The Software is licensed, not sold.
14
-
15
- 1.2 Unlimited Organization License. If you purchased an Organization License (included with the Sidekiq Pro Software), you may install the Software on an unlimited number of Hosts. “Host” means any physical or virtual machine which is controlled by you. You may also run an unlimited number of Workers. “Worker” means a thread within a Sidekiq server process which executes jobs. You may concurrently run the software on an unlimited number of Hosts, with each host running an unlimited number of Workers.
16
-
17
- 1.3 Limited Enterprise License. If you purchased a Limited License for the Sidekiq Enterprise Software, you may install the Software on an unlimited number of Hosts. “Host” means any physical or virtual machine which is controlled by you. The aggregate number of Workers run by the hosts must not exceed the maximum number of Workers authorized at the time of purchase. “Worker” means a thread within a Sidekiq server process which executes jobs. In order to run additional Workers, you must purchase an additional allowance from Contributed Systems.
18
-
19
- 1.4 Enterprise Site License. If you purchased a Site License for the Sidekiq Enterprise Software, you may install the Software on an unlimited number of Hosts. “Host” means any physical or virtual machine which is controlled by you. You may also run an unlimited number of Workers. “Worker” means a thread within a Sidekiq server process which executes jobs. You may concurrently run the software on an unlimited number of Hosts, with each host running an unlimited number of Workers.
20
-
21
- 1.5 Appliance License. If you purchased an Appliance License, you may distribute the Software in any applications, frameworks, or elements (collectively referred to as an “Application” or “Applications”) that you develop using the Software in accordance with this EULA, provided that such distribution does not violate the restrictions set forth in section 3 of this EULA. You must not remove, obscure or interfere with any copyright, acknowledgment, attribution, trademark, warning or disclaimer statement affixed to, incorporated in or otherwise applied in connection with the Software. You are required to ensure that the Software is not reused by or with any applications other than those with which you distribute it as permitted herein. For example, if You install the Software on a customer's server, that customer is not permitted to use the Software independently of your Application. You must inform Contributed Systems of your knowledge of any infringing use of the Software by any of your customers. You are liable for compliance by those third parties with the terms and conditions of this EULA. You will not owe Contributed Systems any royalties for your distribution of the Software in accordance with this EULA.
22
-
23
- 1.6 Archive Copies. You are entitled to make a reasonable amount of copies of the Software for archival purposes. Each copy must reproduce all copyright and other proprietary rights notices on or in the Software Product.
24
-
25
- 1.7 Electronic Delivery. All Software and license documentation shall be delivered by electronic means unless otherwise specified on the applicable invoice or at the time of purchase. Software shall be deemed delivered when it is made available for download by you (“Delivery”).
26
-
27
- 2. Modifications. Contributed Systems shall provide you with source code so that you can create Modifications of the original software. “Modification” means: (a) any addition to or deletion from the contents of a file included in the original Software or previous Modifications created by You, or (b) any new file that contains any part of the original Software or previous Modifications. While you retain all rights to any original work authored by you as part of the Modifications, We continue to own all copyright and other intellectual property rights in the Software.
28
-
29
- 3. Restricted Uses.
30
-
31
- 3.1 You shall not (and shall not allow any third party to): (a) decompile, disassemble, or otherwise reverse engineer the Software or attempt to reconstruct or discover any source code, underlying ideas, algorithms, file formats or programming interfaces of the Software by any means whatsoever (except and only to the extent that applicable law prohibits or restricts reverse engineering restrictions); (b) distribute, sell, sublicense, rent, lease or use the Software for time sharing, hosting, service provider or like purposes, except as expressly permitted under this Agreement; (c) redistribute the Software or Modifications other than by including the Software or a portion thereof within your own product, which must have substantially different functionality than the Software or Modifications and must not allow any third party to use the Software or Modifications, or any portions thereof, for software development or application development purposes; (d) redistribute the Software as part of a product, "appliance" or "virtual server"; (e) redistribute the Software on any server which is not directly under your control; (f) remove any product identification, proprietary, copyright or other notices contained in the Software; (g) modify any part of the Software, create a derivative work of any part of the Software (except as permitted in Section 4), or incorporate the Software, except to the extent expressly authorized in writing by Contributed Systems; (h) publicly disseminate performance information or analysis (including, without limitation, benchmarks) from any source relating to the Software; (i) utilize any equipment, device, software, or other means designed to circumvent or remove any form of Source URL or copy protection used by Contributed Systems in connection with the Software, or use the Software together with any authorization code, Source URL, serial number, or other copy protection device not supplied by Contributed Systems; (j) use the Software to develop a product which is competitive with any Contributed Systems product offerings; or (k) use unauthorized Source URLS or keycode(s) or distribute or publish Source URLs or keycode(s), except as may be expressly permitted by Contributed Systems in writing. If your unique Source URL is ever published, Contributed Systems reserves the right to terminate your access without notice.
32
-
33
- 3.2 UNDER NO CIRCUMSTANCES MAY YOU USE THE SOFTWARE AS PART OF A PRODUCT OR SERVICE THAT PROVIDES SIMILAR FUNCTIONALITY TO THE SOFTWARE ITSELF.
34
-
35
- The Open Source version of the Software (“LGPL Version”) is licensed
36
- under the terms of the GNU Lesser General Public License version 3.0
37
- (“LGPL”) and not under this EULA.
38
-
39
- 4. Ownership. Notwithstanding anything to the contrary contained herein, except for the limited license rights expressly provided herein, Contributed Systems and its suppliers have and will retain all rights, title and interest (including, without limitation, all patent, copyright, trademark, trade secret and other intellectual property rights) in and to the Software and all copies, modifications and derivative works thereof (including any changes which incorporate any of your ideas, feedback or suggestions). You acknowledge that you are obtaining only a limited license right to the Software, and that irrespective of any use of the words “purchase”, “sale” or like terms hereunder no ownership rights are being conveyed to you under this Agreement or otherwise.
40
-
41
- 5. Fees and Payment. The Software license fees will be due and payable in full as set forth in the applicable invoice or at the time of purchase. If the Software does not function properly within two weeks of purchase, please contact us within those two weeks for a refund. You shall be responsible for all taxes, withholdings, duties and levies arising from the order (excluding taxes based on the net income of Contributed Systems).
42
-
43
- 6. Support, Maintenance and Services. Subject to the terms and conditions of this Agreement, as set forth in your invoice, and as set forth on the Sidekiq Pro support page (https://github.com/mperham/sidekiq/wiki/Commercial-Support), support and maintenance services may be included with the purchase of your license subscription.
44
-
45
- 7. Term of Agreement.
46
-
47
- 7.1 Term. This Agreement is effective as of the Delivery of the Software and expires at such time as all license and service subscriptions hereunder have expired in accordance with their own terms (the “Term”). For clarification, the term of your license under this Agreement may be perpetual, limited for Evaluation Version, or designated as a fixed-term license in the Invoice, and shall be specified at your time of purchase. Either party may terminate this Agreement (including all related Invoices) if the other party: (a) fails to cure any material breach of this Agreement within thirty (30) days after written notice of such breach, provided that Contributed Systems may terminate this Agreement immediately upon any breach of Section 3 or if you exceed any other restrictions contained in Section 1, unless otherwise specified in this agreement; (b) ceases operation without a successor; or (c) seeks protection under any bankruptcy, receivership, trust deed, creditors arrangement, composition or comparable proceeding, or if any such proceeding is instituted against such party (and not dismissed within sixty (60) days)). Termination is not an exclusive remedy and the exercise by either party of any remedy under this Agreement will be without prejudice to any other remedies it may have under this Agreement, by law, or otherwise.
48
-
49
- 7.2 Termination. Upon any termination of this Agreement, you shall cease any and all use of any Software and destroy all copies thereof.
50
-
51
- 7.3 Expiration of License. Upon the expiration of any term under this Agreement, (a) all Software updates and services pursuant to the license shall cease, (b) you may only continue to run existing installations of the Software, (c) you may not install the Software on any additional Hosts, and (d) any new installation of the Software shall require the purchase of a new license subscription from Contributed Systems.
52
-
53
- 8. Disclaimer of Warranties. The Software is provided "as is," with all faults, defects and errors, and without warranty of any kind. Contributed Systems does not warrant that the Software will be free of bugs, errors, viruses or other defects, and Contributed Systems shall have no liability of any kind for the use of or inability to use the Software, the Software content or any associated service, and you acknowledge that it is not technically practicable for Contributed Systems to do so.
54
- To the maximum extent permitted by applicable law, Contributed Systems disclaims all warranties, express, implied, arising by law or otherwise, regarding the Software, the Software content and their respective performance or suitability for your intended use, including without limitation any implied warranty of merchantability, fitness for a particular purpose.
55
-
56
- 9. Limitation of Liability.
57
-
58
- In no event will Contributed Systems be liable for any direct, indirect, consequential, incidental, special, exemplary, or punitive damages or liabilities whatsoever arising from or relating to the Software, the Software content or this Agreement, whether based on contract, tort (including negligence), strict liability or other theory, even if Contributed Systems has been advised of the possibility of such damages.
59
-
60
- In no event will Contributed Systems' liability exceed the Software license price as indicated in the invoice. The existence of more than one claim will not enlarge or extend this limit.
61
-
62
- 10. Remedies. Your exclusive remedy and Contributed Systems' entire liability for breach of this Agreement shall be limited, at Contributed Systems' sole and exclusive discretion, to (a) replacement of any defective software or documentation; or (b) refund of the license fee paid to Contributed Systems, payable in accordance with Contributed Systems' refund policy.
63
-
64
- 11. Acknowledgements.
65
-
66
- 11.1 Consent to the Use of Data. You agree that Contributed Systems and its affiliates may collect and use technical information gathered as part of the product support services. Contributed Systems may use this information solely to improve products and services and will not disclose this information in a form that personally identifies you.
67
-
68
- 11.2 Verification. We or a certified auditor acting on our behalf, may, upon its reasonable request and at its expense, audit you with respect to the use of the Software. Such audit may be conducted by mail, electronic means or through an in-person visit to your place of business. Any such in-person audit shall be conducted during regular business hours at your facilities and shall not unreasonably interfere with your business activities. We shall not remove, copy, or redistribute any electronic material during the course of an audit. If an audit reveals that you are using the Software in a way that is in material violation of the terms of the EULA, then you shall pay our reasonable costs of conducting the audit. In the case of a material violation, you agree to pay Us any amounts owing that are attributable to the unauthorized use. In the alternative, We reserve the right, at our sole option, to terminate the licenses for the Software.
69
-
70
- 11.3 Government End Users. If the Software and related documentation are supplied to or purchased by or on behalf of the United States Government, then the Software is deemed to be "commercial software" as that term is used in the Federal Acquisition Regulation system. Rights of the United States shall not exceed the minimum rights set forth in FAR 52.227-19 for "restricted computer software". All other terms and conditions of this Agreement apply.
71
-
72
- 12. Third Party Software. Examples included in Software may provide links to third party libraries or code (collectively “Third Party Software”) to implement various functions. Third Party Software does not comprise part of the Software. In some cases, access to Third Party Software may be included along with the Software delivery as a convenience for demonstration purposes. Such source code and libraries may be included in the “…/examples” source tree delivered with the Software and do not comprise the Software. Licensee acknowledges (1) that some part of Third Party Software may require additional licensing of copyright and patents from the owners of such, and (2) that distribution of any of the Software referencing or including any portion of a Third Party Software may require appropriate licensing from such third parties.
73
-
74
-
75
- 13. Miscellaneous
76
-
77
- 13.1 Entire Agreement. This Agreement sets forth our entire agreement with respect to the Software and the subject matter hereof and supersedes all prior and contemporaneous understandings and agreements whether written or oral.
78
-
79
- 13.2 Amendment. Contributed Systems reserves the right, in its sole discretion, to amend this Agreement from time. Amendments to this Agreement can be located at: https://github.com/mperham/sidekiq/blob/master/COMM-LICENSE.
80
-
81
- 13.3 Assignment. You may not assign this Agreement or any of its rights under this Agreement without the prior written consent of Contributed Systems and any attempted assignment without such consent shall be void.
82
-
83
- 13.4 Export Compliance. You agree to comply with all applicable laws and regulations, including laws, regulations, orders or other restrictions on export, re-export or redistribution of software.
84
-
85
- 13.5 Indemnification. You agree to defend, indemnify, and hold harmless Contributed Systems from and against any lawsuits, claims, losses, damages, fines and expenses (including attorneys' fees and costs) arising out of your use of the Software or breach of this Agreement.
86
-
87
- 13.6 Governing Law. This Agreement is governed by the laws of the State of Oregon and the United States without regard to conflicts of laws provisions thereof, and without regard to the United Nations Convention on the International Sale of Goods or the Uniform Computer Information Transactions Act, as currently enacted by any jurisdiction or as may be codified or amended from time to time by any jurisdiction. The jurisdiction and venue for actions related to the subject matter hereof shall be the state of Oregon and United States federal courts located in Portland, Oregon, and both parties hereby submit to the personal jurisdiction of such courts.
88
-
89
- 13.7 Attorneys' Fees and Costs. The prevailing party in any action to enforce this Agreement will be entitled to recover its attorneys' fees and costs in connection with such action.
90
-
91
- 13.8 Severability. If any provision of this Agreement is held by a court of competent jurisdiction to be invalid, illegal, or unenforceable, the remainder of this Agreement will remain in full force and effect.
92
-
93
- 13.9 Waiver. Failure or neglect by either party to enforce at any time any of the provisions of this licence Agreement shall not be construed or deemed to be a waiver of that party's rights under this Agreement.
94
-
95
- 13.10 Headings. The headings of sections and paragraphs of this Agreement are for convenience of reference only and are not intended to restrict, affect or be of any weight in the interpretation or construction of the provisions of such sections or paragraphs.
96
-
97
- 14. Contact Information. If you have any questions about this EULA, or if you want to contact Contributed Systems for any reason, please direct correspondence to info@contribsys.com.
data/Ent-2.0-Upgrade.md DELETED
@@ -1,37 +0,0 @@
1
- # Welcome to Sidekiq Enterprise 2.0!
2
-
3
- Sidekiq Enterprise 2.0 adds a few new features and adds the requirement that license
4
- credentials be available at runtime. Note that Sidekiq 6.0 does have major breaking changes.
5
-
6
- ## What's New
7
-
8
- * Sidekiq Enterprise now requires license credentials at runtime. If you
9
- configured Bundler as described in the access email you need do
10
- nothing, everything should just work. If you are vendoring Sidekiq
11
- Enterprise you will need to configure Bundler also or set
12
- `SIDEKIQ_ENT_USERNAME=abcdef12 bundle exec sidekiq...` when starting the
13
- process. [#4232]
14
- * Dead jobs now release any unique locks they were holding when they died [#4162]
15
- * Backoff can now be customized per rate limiter by passing in a Proc [#4219]
16
- ```ruby
17
- limiter = Sidekiq::Limiter.bucket(:stripe, 10, :second, backoff: ->(limiter, job) {
18
- return job['overrated'] || 5 # wait for N seconds, where N is the number of
19
- # times we've failed the rate limit
20
- })
21
- ```
22
- * Removed deprecated APIs and warnings.
23
- * Various changes for Sidekiq 6.0
24
- * Requires Ruby 2.5+ and Redis 4.0+
25
- * Requires Sidekiq 6.0+ and Sidekiq Pro 5.0+
26
-
27
- ## Upgrade
28
-
29
- * Upgrade to the latest Sidekiq Enterprise 1.x.
30
- ```ruby
31
- gem 'sidekiq-ent', '< 2'
32
- ```
33
- * Fix any deprecation warnings you see.
34
- * Upgrade to 2.x.
35
- ```ruby
36
- gem 'sidekiq-ent', '< 3'
37
- ```
data/Ent-Changes.md DELETED
@@ -1,309 +0,0 @@
1
- # Sidekiq Enterprise Changelog
2
-
3
- [Sidekiq Changes](https://github.com/mperham/sidekiq/blob/master/Changes.md) | [Sidekiq Pro Changes](https://github.com/mperham/sidekiq/blob/master/Pro-Changes.md) | [Sidekiq Enterprise Changes](https://github.com/mperham/sidekiq/blob/master/Ent-Changes.md)
4
-
5
- Please see [sidekiq.org](https://sidekiq.org) for more details and how to buy.
6
-
7
- 2.2.1
8
- -------------
9
-
10
- - Support configurable timezones for periodic jobs [#4749]
11
- - Handle edge case leading to negative expiry in uniqueness [#4763]
12
-
13
- 2.2.0
14
- -------------
15
-
16
- - Add new **leaky bucket** rate limiter [#4414]
17
- This allows clients to burst up to X calls before throttling
18
- back to X calls per Y seconds. To limit the user to 60 calls
19
- per minute:
20
- ```ruby
21
- leaker = Sidekiq::Limiter.leaky("shopify", 60, :minute)
22
- leaker.within_limit do
23
- ...
24
- end
25
- ```
26
- See the Rate Limiting wiki page for more detail.
27
- - Rate limiters may now customize their reschedule count [#4725]
28
- To disable rate limit reschedules, use `reschedule: 0`.
29
- ```ruby
30
- Sidekiq::Limiter.concurrent("somename", 5, reschedule: 0)
31
- ```
32
- - Allow filtering by name in the Rate Limiter UI [#4695]
33
- - Add IT locale
34
-
35
- 2.1.2
36
- -------------
37
-
38
- - The Sidekiq Pro and Enterprise gem servers now `bundle install` much faster with **Bundler 2.2+** [#4158]
39
- - Now that ActiveJobs support `sidekiq_options`, add support for uniqueness in AJs [#4667]
40
-
41
- 2.1.1
42
- -------------
43
-
44
- - Add optional **app preload** in swarm, saves even more memory [#4646]
45
- - Fix incorrect queue tags in historical metrics [#4377]
46
-
47
- 2.1.0
48
- -------------
49
-
50
- - Move historical metrics to use tags rather than interpolating name [#4377]
51
- ```
52
- sidekiq.enqueued.#{name} -> sidekiq.queue.size with tag queue:#{name}
53
- sidekiq.latency.#{name} -> sidekiq.queue.latency with tag queue:#{name}
54
- ```
55
- - Remove `concurrent-ruby` gem dependency [#4586]
56
- - Add systemd `Type=notify` support for swarm [#4511]
57
- - Length swarm's boot timeout to 60 sec [#4544]
58
- - Add NL locale
59
-
60
- 2.0.1
61
- -------------
62
-
63
- - Periodic job registration API adjusted to avoid loading classes in initializer [#4271]
64
- - Remove support for deprecated ENV variables (COUNT, MAXMEM\_MB, INDEX) in swarm code
65
-
66
- 2.0.0
67
- -------------
68
-
69
- - Except for the [newly required credentials](https://github.com/mperham/sidekiq/issues/4232), Sidekiq Enterprise 2.0 does
70
- not have any significant migration steps.
71
- - Sidekiq Enterprise must now be started with valid license credentials. [#4232]
72
- - Call `GC.compact` if possible in sidekiqswarm before forking [#4181]
73
- - Changes for forward-compatibility with Sidekiq 6.0.
74
- - Add death handler to remove any lingering unique locks [#4162]
75
- - Backoff can now be customized per rate limiter [#4219]
76
- - Code formatting changes for StandardRB
77
-
78
- 1.8.1
79
- -------------
80
-
81
- - Fix excessive lock reclaims with concurrent limiter [#4105]
82
- - Add ES translations, see issues [#3949](https://github.com/mperham/sidekiq/issues/3949) and [#3951](https://github.com/mperham/sidekiq/issues/3951) to add your own language.
83
-
84
- 1.8.0
85
- -------------
86
-
87
- - Require Sidekiq Pro 4.0 and Sidekiq 5.2.
88
- - Refactor historical metrics API to use revamped Statsd support in Sidekiq Pro
89
- - Add a gauge to historical metrics for `default` queue latency [#4079]
90
-
91
- 1.7.2
92
- -------------
93
-
94
- - Add PT and JA translations
95
- - Fix elapsed time calculations to use monotonic clock [#4000, sj26]
96
- - Fix edge case where flapping leadership would cause old periodic
97
- jobs to be fired once [#3974]
98
- - Add support for sidekiqswarm memory monitoring on FreeBSD [#3884]
99
-
100
- 1.7.1
101
- -------------
102
-
103
- - Fix Lua error in concurrent rate limiter under heavy contention
104
- - Remove superfluous `freeze` calls on Strings [#3759]
105
-
106
- 1.7.0
107
- -------------
108
-
109
- - **NEW FEATURE** [Rolling restarts](https://github.com/mperham/sidekiq/wiki/Ent-Rolling-Restarts) - great for long running jobs!
110
- - Adjust middleware so unique jobs that don't push aren't registered in a Batch [#3662]
111
- - Add new unlimited rate limiter, useful for testing [#3743]
112
- ```ruby
113
- limiter = Sidekiq::Limiter.unlimited(...any args...)
114
- ```
115
-
116
- 1.6.1
117
- -------------
118
-
119
- - Fix crash in rate limiter middleware when used with custom exceptions [#3604]
120
-
121
- 1.6.0
122
- -------------
123
-
124
- - Show process "leader" tag on Busy page, requires Sidekiq 5.0.2 [#2867]
125
- - Capture custom metrics with the `save_history` API. [#2815]
126
- - Implement new `unique_until: 'start'` policy option. [#3471]
127
-
128
- 1.5.4
129
- -------------
130
-
131
- - Fix broken Cron page in Web UI [#3458]
132
-
133
- 1.5.3
134
- -------------
135
-
136
- - Remove dependency on the algorithms gem [#3446]
137
- - Allow user to specify max memory in megabytes with SIDEKIQ\_MAXMEM\_MB [#3451]
138
- - Implement logic to detect app startup failure, sidekiqswarm will exit
139
- rather than try to restart the app forever [#3450]
140
- - Another fix for doubly-encrypted arguments [#3368]
141
-
142
- 1.5.2
143
- -------------
144
-
145
- - Fix encrypted arguments double-encrypted by retry or rate limiting [#3368]
146
- - Fix leak in concurrent rate limiter, run this in Rails console to clean up existing data [#3323]
147
- ```ruby
148
- expiry = 1.month.to_i; Sidekiq::Limiter.redis { |c| c.scan_each(match: "lmtr-cfree-*") { |key| c.expire(key, expiry) } }
149
- ```
150
-
151
- 1.5.1
152
- -------------
153
-
154
- - Fix issue with census startup when not using Bundler configuration for
155
- source credentials.
156
-
157
- 1.5.0
158
- -------------
159
-
160
- - Add new web authorization API [#3251]
161
- - Update all sidekiqswarm env vars to use SIDEKIQ\_ prefix [#3218]
162
- - Add census reporting, the leader will ping contribsys nightly with aggregate usage metrics
163
-
164
- 1.4.0
165
- -------------
166
-
167
- - No functional changes, require latest Sidekiq and Sidekiq Pro versions
168
-
169
- 1.3.2
170
- -------------
171
-
172
- - Upgrade encryption to use OpenSSL's more secure GCM mode. [#3060]
173
-
174
- 1.3.1
175
- -------------
176
-
177
- - Fix multi-process memory monitoring on CentOS 6.x [#3063]
178
- - Polish the new encryption feature a bit.
179
-
180
- 1.3.0
181
- -------------
182
-
183
- - **BETA** [New encryption feature](https://github.com/mperham/sidekiq/wiki/Ent-Encryption)
184
- which automatically encrypts the last argument of a Worker, aka the secret bag.
185
-
186
- 1.2.4
187
- -------------
188
-
189
- - Fix issue causing some minutely jobs to execute every other minute.
190
- - Log a warning if slow periodic processing causes us to miss a clock tick.
191
-
192
- 1.2.3
193
- -------------
194
-
195
- - Periodic jobs could stop executing until process restart if Redis goes down [#3047]
196
-
197
- 1.2.2
198
- -------------
199
-
200
- - Add API to check if a unique lock is present. See [#2932] for details.
201
- - Tune concurrent limiters to minimize thread thrashing under heavy contention. [#2944]
202
- - Add option for tuning which Bundler groups get preloaded with `sidekiqswarm` [#3025]
203
- ```
204
- SIDEKIQ_PRELOAD=default,production bin/sidekiqswarm ...
205
- # Use an empty value for maximum application compatibility
206
- SIDEKIQ_PRELOAD= bin/sidekiqswarm ...
207
- ```
208
-
209
- 1.2.1
210
- -------------
211
-
212
- - Multi-Process mode can now monitor the RSS memory of children and
213
- restart any that grow too large. To limit children to 1GB each:
214
- ```
215
- MAXMEM_KB=1048576 COUNT=2 bundle exec sidekiqswarm ...
216
- ```
217
-
218
- 1.2.0
219
- -------------
220
-
221
- - **NEW FEATURE** Multi-process mode! Sidekiq Enterprise can now fork multiple worker
222
- processes, enabling significant memory savings. See the [wiki
223
- documentation](https://github.com/mperham/sidekiq/wiki/Ent-Multi-Process) for details.
224
-
225
-
226
- 0.7.10
227
- -------------
228
-
229
- - More precise gemspec dependency versioning
230
-
231
- 1.1.0
232
- -------------
233
-
234
- - **NEW FEATURE** Historical queue metrics, [documented in the wiki](https://github.com/mperham/sidekiq/wiki/Ent-Historical-Metrics) [#2719]
235
-
236
- 0.7.9, 1.0.2
237
- -------------
238
-
239
- - Window limiters can now accept arbitrary window sizes [#2686]
240
- - Fix race condition in window limiters leading to non-stop OverLimit [#2704]
241
- - Fix invalid overage counts when nesting concurrent limiters
242
-
243
- 1.0.1
244
- ----------
245
-
246
- - Fix crash in periodic subsystem when a follower shuts down, thanks
247
- to @justinko for reporting.
248
-
249
- 1.0.0
250
- ----------
251
-
252
- - Enterprise 1.x targets Sidekiq 4.x.
253
- - Rewrite several features to remove Celluloid dependency. No
254
- functional changes.
255
-
256
- 0.7.8
257
- ----------
258
-
259
- - Fix `unique_for: false` [#2658]
260
-
261
-
262
- 0.7.7
263
- ----------
264
-
265
- - Enterprise 0.x targets Sidekiq 3.x.
266
- - Fix racy shutdown event which could lead to disappearing periodic
267
- jobs, requires Sidekiq >= 3.5.3.
268
- - Add new :leader event which is fired when a process gains leadership.
269
-
270
- 0.7.6
271
- ----------
272
-
273
- - Redesign how overrated jobs are rescheduled to avoid creating new
274
- jobs. [#2619]
275
-
276
- 0.7.5
277
- ----------
278
-
279
- - Fix dynamic creation of concurrent limiters [#2617]
280
-
281
- 0.7.4
282
- ----------
283
- - Add additional check to prevent duplicate periodic job creation
284
- - Allow user-specified TTLs for rate limiters [#2607]
285
- - Paginate rate limiter index page [#2606]
286
-
287
- 0.7.3
288
- ----------
289
-
290
- - Rework `Sidekiq::Limiter` redis handling to match global redis handling.
291
- - Allow user to customize rate limit backoff logic and handle custom
292
- rate limit errors.
293
- - Fix scalability issue with Limiter index page.
294
-
295
- 0.7.2
296
- ----------
297
-
298
- - Fix typo which prevented limiters with '0' in their names.
299
-
300
- 0.7.1
301
- ----------
302
-
303
- - Fix issue where unique scheduled jobs can't be enqueued upon schedule
304
- due to the existing unique lock. [#2499]
305
-
306
- 0.7.0
307
- ----------
308
-
309
- Initial release.