The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

Mojolicious::Plugin::Minion::Workers

★★★ Доброго всем ★★★

¡ ¡ ¡ ALL GLORY TO GLORIA ! ! !

VERSION

0.090771 (up to Minion 9.07/100+minor)

NAME

Mojolicious::Plugin::Minion::Workers - does extend base Mojolicious::Plugin::Minion on manage Minion workers.

SYNOPSIS

  # Mojolicious (define amount workers in config)
  $self->plugin('Minion::Workers' => {Pg => ..., workers=>2, manage=>1, });
  # or pass to $app->minion->workers->manage(<num>) for run later
  $self->plugin('Minion::Workers' => {Pg => ...});

  # Mojolicious::Lite (define amount workers in config)
  plugin 'Minion::Workers' => {Pg => ..., workers=>2};

  # Add tasks to your application
  app->minion->add_task(something_slow => sub {
    my ($job, @args) = @_;
    sleep 5;
    say 'This is a background worker process.';
  });
  
  # But you can define tasks in config as well
  $self->plugin('Minion::Workers' => {Pg => ..., tasks => { foo_task => sub { ... }, }, });
  
  # Start manage with amount workers
  app->minion->workers->manage(4);
  # or get from config
  app->minion->workers->manage();

  # Start jobs from anywhere in your application

DESCRIPTION

Mojolicious::Plugin::Minion::Workers is a Mojolicious plugin for the Minion job queue and has extending base Mojolicious::Plugin::Minion for enable workers managment.

Extend base plugin config

Mojolicious::Plugin::Minion::Workers apply all config options of the base plugin Mojolicious::Plugin::Minion, and define following:

workers => <integer>

Amount of Minion workers need to start/restart. This value can be overriden on $app->minion->workers->manage(...).

  ..., workers => 4, ...

manage => <boolean>

Start/restart Minion workers during plugin registration. Defaults to false. If this option is not set then you can start workers by $app->minion->workers->manage() see below.

tasks = > <hashref>

You can define Minion tasks in config.

  ..., tasks => {foo_task => sub { ... }, ...},

Pg => <connection url> | <Mojo::Pg object> | <coderef>

If config parameter Pg is a coderef then returned value of $conf->{Pg} = $conf->{Pg}->($app); will assigned to Pg.

  ..., Pg => sub { my $app = shift; ... }, ...

Manage workers

Mojolicious::Plugin::Minion::Workers add attr workers to the $app->minion object. $app->minion->workers object has following public methods.

manage(integer amount)

Start/restart Minion passed amount workers or get its from plugin config. None workers mean skip managment.

  $app->minion->workers->manage(2);

Tested on standard shell commands (on Linux):

  $ perl script/app.pl daemon         # one minion worker will be starting
  $ perl script/app.pl prefork        # your amount minion workers will be starting
  $ morbo script/app.pl                # when morbo restarts on watch changes one minion worker will be restarting too
  $ hypnotoad script/app.pl           # your amount minion workers will be starting
  $ hypnotoad script/app.pl           # on hot deploy minion workers will be restarting too
  $ hypnotoad -s script/app.pl        # minion workers will stoping too

NOTE. For shell commands $ morbo script/app.pl and $ perl script/app.pl daemon amount workers always one process.

NOTE. In case with hypnotoad if you want $ kill -USR2 app_pid then Minion workers will not restarts, sorry. Always use hot deploy command $ hypnotoad script/app.pl .

BIG NOTE. When minion workers restarts (hypnotoad | morbo) then ALL exists minion processes stoped then runned. So if you run many separate apps with one database backend then dont use this module or set separate backend databases as well.

HELPERS

Mojolicious::Plugin::Minion::Workers enable all helpers through base plugin Mojolicious::Plugin::Minion, thus you dont need apply base plugin (auto register).

METHODS

Mojolicious::Plugin::Minion::Workers inherits all methods from Mojolicious::Plugin::Minion and override the following new ones.

register

  $plugin->register(Mojolicious->new, <config pairs>);

Register plugin in Mojolicious application.

SEE ALSO

Mojolicious::Plugin::Minion, Minion, Mojolicious::Guides, https://mojolicious.org.

AUTHOR

Михаил Че (Mikhail Che), <mche[-at-]cpan.org>

BUGS / CONTRIBUTING

Please report any bugs or feature requests at https://github.com/mche/Mojolicious-Plugin-Minion-Workers/issues. Pull requests also welcome.

COPYRIGHT

Copyright 2019+ Mikhail Che.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.