# NAME

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

# VERSION

version 0.11

# 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](http://search.cpan.org/perldoc?Starman)
- Starman is fronted by nginx or apache
- 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).

## 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.