NAME

proclet - foreman for perl

SYNOPSIS

$ cat Procfile
memd: memcached -v -p 11211
plack: plackup -p 9022 -e 'sub { [200, [], ["OK"]] }'
$ proclet start

DESCRIPTION

proclet is foreman for perl, manages Procfile-based applications.

proclet does not support EXPORT yet.

RUNNING

proclet start is used to run your application directly from the command line.

The following options control how the application is run:

-h, --help

Display help message

-c, --concurrency: Str

The number of each process type to run. The value passed in should be in the format process=num,process=num

-e, --env: Str

An alternate environment file. You can specify more than one file by using: --env file1,file2.

-f, --procfile: Str

An alternate Procfile to load, implies -d at the Procfile root

--color

Colored log

-p, --port: Num

Port number which used as the base for this application. Should be a multiple of 1000

PROCFILE

A Procfile should contain both a name for the process and the command used to run it.

web: bundle exec thin start
job: bundle exec rake jobs:work

ENVIRONMENT

If a .env file exists in the current directory, the default environment will be read from it. This file should contain key/value pairs, separated by =, with one key/value pair per line.

FOO=bar
BAZ=qux

DEFAULT OPTIONS

If a .foreman file exists in the current directory, default options will be read from it. This file should be in YAML format with the long option name as keys. Example:

concurrency: alpha=0,bravo=1
color: 1

PORT ASSIGNMENT

As same as foreman, proclet starts to assign from port 5000 by default. and assigns them in blocks of 100 per service in the order used in your Procfile. You can specify an alternate starting port number with the -p option.

AUTHOR

Masahiro Nagano <kazeburo {at} gmail.com>

SEE ALSO

Proclet, https://github.com/ddollar/foreman, http://blog.daviddollar.org/2011/05/06/introducing-foreman.html

LICENSE

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