kumomta/docs/reference/kumo/make_queue_config.md

kumo.make_queue_config { PARAMS }

Constructs a configuration object that specifies how a queue will behave.

This function should be called from the get_queue_config event handler to provide the configuration for the requested queue.

The following keys are possible:

egress_pool

The name of the egress pool which should be used as the source of this traffic.

If you do not specify an egress pool, a default pool named unspecified will be used. That pool contains a single source named unspecified that has no specific source settings: it will just make a connection using whichever IP the kernel chooses.

See kumo.define_egress_pool().

max_age

Limits how long a message can remain in the queue. The value is expressed in seconds. The default value is 7 days.

kumo.on('get_queue_config', function(queue_name)
  return kumo.make_queue_config {
    -- Age out messages after being in the queue for 20 minutes
    max_age = 20 * 60,
  }
end)

max_retry_interval

Messages are retried using an exponential backoff as described under retry_interval below. max_retry_interval sets an upper bound on the amount of time between delivery attempts.

The default is that there is no upper limit.

The value is expressed in seconds.

kumo.on('get_queue_config', function(queue_name)
  return kumo.make_queue_config {
    -- Retry at most every hour
    max_retry_interval = 60 * 60,
  }
end)

retry_interval

Messages are retried using an exponential backoff. retry_interval sets the base interval; if a message cannot be immediately delivered and encounters a transient failure, then a (jittered) delay of retry_interval seconds will be applied before trying again. If it transiently fails a second time, retry_interval will be doubled and so on, doubling on each attempt.

The default is 20 minutes.

The value is expressed in seconds.

kumo.on('get_queue_config', function(queue_name)
  return kumo.make_queue_config {
    -- 20 minutes
    retry_interval = 20 * 60,
  }
end)