NAME

Dist::Zilla::Plugin::Dpkg::PerlbrewStarman - Generate dpkg files for your perlbrew-backed, starman-based perl app

VERSION

version 0.12

SYNOPSIS

  #  [Dpkg::PerlbrewStarman]

DESCRIPTION

Dist::Zilla::Plugin::Dpkg::PerlbrewStarman is an extension of Dist::Zilla::Plugin::Dpkg. It generates Debian control files that are suitable for a perl app that includes it's own Perlbrew and runs under Starman. It makes the following assumptions:

XXX Perlbrew

Runs under Starman

Starman is fronted by nginx or apache

It runs as a user called $packagename

It's installed at /srv/$packagename

Logs will be placed in /var/log/$packagename

psgi file is in script and is named $packagename.psgi

Config is in config/ and can be found by your app with nothing more than it's HOME variable set. (FOO_BAR_HOME)

Nginx config is in config/nginx/$packagename.conf or Apache config is at config/apache/$packagename.conf

Your app can be preloaded

Your app only listens on localhost (nginx/apache handles the rest)

You want 5 workers

This module provides defaults for the following attribute:

conffiles_template_default

control_template_default

default_template_default

init_template_default

install_template_default

postinst_template_default

postrm_template_default

ATTRIBUTES

starman_port

The port to use for starman.

startup_time

The amount of time (in seconds) that the init script will wait on startup. Some applications may require more than the default amount of time (30 seconds).

uid

The UID of the user we're adding for the package. This is helpful for syncing UIDs across multiple installations

web_server

Set the web server we'll be working with for this package. Supported values are apache and nginx.

AUTHOR

Cory G Watson <gphat@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Infinity Interactive, Inc.

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