perl/root/help.md

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 "/".