.TH "perl" "1" "" "Jan Koscielniak \<jkosciel@redhat.com\>" "DATE 11.04.2017"  ""
.BR perl (1) 
\-\- S2I builder of perl applications
.SH USAGE
.PP
To pull the perl container run:
.PP
.RS
.nf
  # docker pull koscicz/perl
.fi
.RE
.PP
To build your perl application use run:
.PP
.RS
.nf
  # s2i build <SOURCE\-REPOSITORY> koscicz/perl <NAME\-OF\-APP>
.fi
.RE
.PP
To run your application in docker container:
.PP
.RS
.nf
  # docker run \-p 8080:8080 <NAME\-OF\-APP>
.fi
.RE
.SH ENVIROMENT VARIABLES
.PP
To set environment variables, you can place them as a key value pair into a \fB\fC\&.sti/environment\fR
file inside your source code repository.
.PP
ENABLE_CPAN_TEST
.PP
.RS
.nf
Allow the installation of all specified cpan packages and the running of their tests. The default value is `false`.
.fi
.RE
.PP
CPAN_MIRROR
.PP
.RS
.nf
This variable specifies a mirror URL which will used by cpanminus to install dependencies.
By default the URL is not specified.
.fi
.RE
.PP
PERL_APACHE2_RELOAD
.PP
.RS
.nf
Set this to "true" to enable automatic reloading of modified Perl modules.
.fi
.RE
.PP
HTTPD_START_SERVERS
.PP
.RS
.nf
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.
.fi
.RE
.PP
HTTPD_MAX_REQUEST_WORKERS
.PP
.RS
.nf
Number of simultaneous requests that will be handled by Apache. The default
is 256, but it will be automatically lowered if memory is limited.
.fi
.RE
.PP
PSGI_FILE
.PP
.RS
.nf
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.
.fi
.RE
.PP
PSGI_URI_PATH
.PP
.RS
.nf
This variable overrides location URI path that is handled path the PSGI
application. Default value is "/".
.fi
.RE