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.

AUTHOR

COPYRIGHT AND LICENSE