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.