perl(1) -- S2I builder of perl applications
=============================================

## USAGE

To pull the perl container run:

      # docker pull koscicz/perl

To build your perl application use run:

      # s2i build <SOURCE-REPOSITORY> koscicz/perl <NAME-OF-APP>

To run your application in docker container:

      # docker run -p 8080:8080 <NAME-OF-APP>

## ENVIROMENT VARIABLES

To set environment variables, you can place them as a key value pair into a `.sti/environment`
file inside your source code repository.

ENABLE\_CPAN\_TEST

    Allow the installation of all specified cpan packages and the running of their tests. The default value is `false`.

CPAN_MIRROR

    This variable specifies a mirror URL which will used by cpanminus to install dependencies.
    By default the URL is not specified.

PERL\_APACHE2\_RELOAD

    Set this to "true" to enable automatic reloading of modified Perl modules.

HTTPD\_START\_SERVERS

    The [StartServers](https://httpd.apache.org/docs/2.4/mod/mpm_common.html#startservers)
    directive sets the number of child server processes created on startup. Default is 8.

HTTPD\_MAX\_REQUEST\_WORKERS

    Number of simultaneous requests that will be handled by Apache. The default
    is 256, but it will be automatically lowered if memory is limited.

PSGI_FILE

    Override PSGI application detection.

    If the PSGI_FILE variable is set to empty value, no PSGI application will
    be detected and mod_perl not be reconfigured.

    If the PSGI_FILE variable is set and non-empty, it will define path to
    the PSGI application file. No detection will be used.

    If the PSGI_FILE variable does not exist, autodetection will be used:
    If exactly one ./*.psgi file exists, mod_perl will be configured to
    execute that file.

PSGI\_URI\_PATH

    This variable overrides location URI path that is handled path the PSGI
    application. Default value is "/".