NAME

Toadfarm::Plugin::Reload - Reload toadfarm with new code

DESCRIPTION

This Mojolicious plugin allow the "Toadfarm" server to restart when a resource is hit with a special JSON payload. The payload need to be compatible with the post-receive-hook github use.

SETUP

• You need to set up a post receive hook on github to make this reloader work. Go to "https://github.com/jhthorsen/YOUR-REPO/settings/hooks" to set it up.

• The WebHook URL need to be "http://yourserver.com/some/secret/path". See CONFIG below for details.

CONFIG

This is a config template for Toadfarm:

  {
    apps => [...],
    plugins => [
      Reload => {
        path => '/some/secret/path',
        repositories => [
          {
            name => 'cool-repo',
            branch => 'some-branch',
            path => '/path/to/cool-repo',
            remote => 'whatever', # defaults to "origin"
          },
        ],
      },
      # ...
    ],
  }

Details:

• path

  This should be the path part of the URL to POST data to reload the server. Make this something semi secret to avoid random requests:

    perl -le'print join "/", "", "reload", (time.$$.rand(9999999)) =~ /(\w\w)/g'

• repositories

  This should contain a mapping between github repository names and local settings:

  • branch

    This need to match the branch which you push to github. It should be something like "production", and not "master" - unless you want every push to master to reload the server.

  • path

    This is the path on disk to the local git repo.

METHODS

register

  $self->register($app, \%config);

See "SYNOPSIS" for %config parameters.

AUTHOR

Jan Henning Thorsen - jhthorsen@cpan.org