async-job-adapter-active_job 0.20.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 438122b9f40ef9fd97ebe48bb50ff7a015a4dcd4837f6d9cd70cfb2dfba86a70
-  data.tar.gz: 19308266ced3a1fe91990d4b865aeb68cbdd5b82c1f99e4f62de068c0e0f97f2
+  metadata.gz: c511212f8812f17482be72b895a5a8bb1448cceb7be848be1c03e32c1b7a4c77
+  data.tar.gz: eaa270226a7a42a0de5f1a46dd088e43f2e43638574ea40a6550cb1b63faa900
 SHA512:
-  metadata.gz: 64ec94d3dd9421049c342ab7702cb2f9ed4ae38859f76ba5a41d9f09bb1cc0a459f43d5229969a10a58e800e98ae0d68e065a8e65ab06d63e75694bccf13cfd7
-  data.tar.gz: 26733df41fe820a33a31dddae659610ee11a7d709f2b3fcbff4d0319e850c6b46ac676cfa4d8566cc0ffbf5aa10a6c0fdacc418836d70f1e6fdf036206329d55
+  metadata.gz: d6b8ce9d35e14fffc33065016159afd0e3dcd2ca76a977c04b75e5eb99039452576fe5c14404a6c93daf92e680b33b16c1d904e2ebbe09923daff33397c71e0b
+  data.tar.gz: 18e5902aaf6ae3df933126083fc61f2bb1390d84dd36fe08012f6a30838a52bcce29199960c6d840b2d87b761c0702bd15ee208d677d61c1606506c868f17a5c

data/context/production-deployment.md

@@ -31,14 +31,22 @@ Replace the built-in `default` queue definition in `config/initializers/async_jo
 ```ruby
 require "async/job/processor/redis"
 
+redis_endpoint = Async::Redis::Endpoint.parse(ENV.fetch("REDIS_URL"))
+
 Rails.application.configure do
 	config.async_job.define_queue "default" do
-		dequeue Async::Job::Processor::Redis
+		dequeue Async::Job::Processor::Redis, endpoint: redis_endpoint
 	end
 end
 ```
 
-The processor connects to Redis on its local default endpoint unless another endpoint is provided. With one logical queue, the default `async-job` prefix is sufficient. Configure distinct, stable prefixes when multiple queue definitions share a Redis endpoint.
+Set `REDIS_URL` in both the Rails and worker process environments. It may use the `redis://` or `rediss://` scheme and include credentials, a port, and a database number:
+
+```shell
+$ REDIS_URL=redis://redis.example.com:6379/0 bundle exec async-job-adapter-active_job-server
+```
+
+Without an explicit endpoint, the processor connects to `redis://localhost:6379`. With one logical queue, the default `async-job` prefix is sufficient. Configure distinct, stable prefixes when multiple queue definitions share a Redis endpoint.
 
 ## Starting Workers
 
@@ -50,6 +58,8 @@ $ RAILS_ENV=production bundle exec async-job-adapter-active_job-server
 
 The server loads the Rails environment and starts every defined queue. The service container supervises worker instances and reports their readiness.
 
+By default, `config/environment.rb` is preloaded in the parent process before worker processes are forked. This avoids loading application dependencies for the first time after a fork and allows workers to share preloaded application code.
+
 If the command cannot run from the application root, set `RAILS_ROOT` explicitly:
 
 ```shell

data/context/queue-configuration.md

@@ -36,6 +36,24 @@ end
 
 Processors can accept positional and keyword arguments after the processor class.
 
+## Redis Endpoints
+
+Without an explicit `endpoint`, the Redis processor connects to `redis://localhost:6379`. Pass an ruby:`Async::Redis::Endpoint` when Redis runs on another host, requires credentials, uses a different database, or accepts TLS connections:
+
+```ruby
+redis_endpoint = Async::Redis::Endpoint.parse(ENV.fetch("REDIS_URL"))
+
+Rails.application.configure do
+	config.async_job.define_queue "default" do
+		dequeue Async::Job::Processor::Redis, endpoint: redis_endpoint
+	end
+end
+```
+
+`REDIS_URL` may use either the `redis://` or `rediss://` scheme and can include credentials, a port, and a database number, for example `redis://username:password@redis.example.com:6379/1`. Keep credentials in the environment rather than writing them into the initializer.
+
+The bundled worker loads the Rails environment, so Rails and worker processes use the same queue definition. Ensure `REDIS_URL` is present and identical in both process environments.
+
 ## Redis Prefixes
 
 Without an explicit `prefix`, every Redis processor uses `async-job`. Queue definition names do not alter that default, so two definitions using the same Redis endpoint and prefix operate on the same underlying queue.

data/lib/async/job/adapter/active_job/environment.rb

@@ -22,6 +22,12 @@ module Async
 						ENV.fetch("RAILS_ROOT", Dir.pwd)
 					end
 					
+					# The paths to preload before worker processes are forked.
+					# @returns [Array(String)]
+					def preload
+						["config/environment"]
+					end
+					
 					# Get the default dispatcher instance.
 					# @returns [Object] The dispatcher from the Railtie.
 					def dispatcher

data/lib/async/job/adapter/active_job/service.rb

@@ -15,6 +15,15 @@ module Async
 			module ActiveJob
 				# A job server that can be run as a service.
 				class Service < Async::Service::Generic
+					# Preload the application before worker processes are forked.
+					def start
+						Array(@evaluator.preload).each do |path|
+							require File.expand_path(path, @evaluator.root)
+						end
+						
+						super
+					end
+					
 					# Load the Rails environment and start the job server.
 					def setup(container)
 						container_options = @evaluator.container_options

data/lib/async/job/adapter/active_job/version.rb

@@ -7,7 +7,7 @@ module Async
 	module Job
 		module Adapter
 			module ActiveJob
-				VERSION = "0.20.0"
+				VERSION = "0.21.0"
 			end
 		end
 	end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-job-adapter-active_job
 version: !ruby/object:Gem::Version
-  version: 0.20.0
+  version: 0.21.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -129,7 +129,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.16
 specification_version: 4
 summary: A asynchronous job queue for Ruby on Rails.
 test_files: []