NAME

Ubic::Service::ServerStarter - Run programs using Server::Starter

VERSION

version 0.003

SYNOPSIS

use Ubic::Service::ServerStarter;
return Ubic::Service::ServerStarter->new({
    cmd => [
        'starman',
        '--preload-app',
        '--env' => 'development',
        '--workers' => 5,
    ],
    args => {
        interval => 5,
        port => 5003,
        signal-on-hup => 'QUIT',
        signal-on-term => 'QUIT',
    },
    ubic_log => '/var/log/app/ubic.log',
    stdout   => '/var/log/app/stdout.log',
    stderr   => '/var/log/app/stderr.log',
    user     => "www-data",
});

DESCRIPTION

This service allows you to wrap any command with Server::Starter, which enables graceful reloading of that app without any downtime.

NAME

Ubic::Service::ServerStarter - ubic service class for running commands with Server::Starter

METHODS

args (optional)

Arguments to send to start_server.

cmd (required)

ArrayRef of command + options to run with server starter. Everything passed here will go be put after the -- in the start_server command:

start_server [ args ] -- [ cmd ]

This argument is required becasue we have to have something to run!

status

Coderef to special function, that will check status of your application.

ubic_log

Path to ubic log.

stdout

Path to stdout log.

stderr

Path to stderr log.

proxy_logs

Boolean flag. If enabled, ubic-guardian will replace daemon's stdout and stderr filehandles with pipes, proxy all data to the log files, and reopen them on SIGHUP.

user

User under which start_server will be started.

group

Group under which start_server will be started. Default is all user groups.

cwd

Change working directory before starting a daemon.

pidfile

Pidfile for Ubic::Daemon module.

AUTHOR

William Wolf <throughnothing@gmail.com>

COPYRIGHT AND LICENSE

William Wolf has dedicated the work to the Commons by waiving all of his or her rights to the work worldwide under copyright law and all related or neighboring legal rights he or she had in the work, to the extent allowable by law.

Works under CC0 do not require attribution. When citing the work, you should not imply endorsement by the author.