init commit for f26
This commit is contained in:
Radoslav Pitonak
parent
36044c60ef
commit
c0fd69dfb7
20 changed files with 3637 additions and 0 deletions
191
root/help.1
Normal file
191
root/help.1
Normal file
|
|
@ -0,0 +1,191 @@
|
|||
.TH "php" "1" "" "Rado Pitonak \<rpitonak@redhat.com\>" "DATE 07.04.2017" ""
|
||||
|
||||
|
||||
.SH NAME
|
||||
.PP
|
||||
php \- source to image builder of php applications.
|
||||
|
||||
|
||||
.SH DESCRIPTION
|
||||
.PP
|
||||
Image for building php application as reproducible Docker image using source to image. Image is based on fedora.
|
||||
|
||||
.SH USAGE
|
||||
.PP
|
||||
To pull the php container run:
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
# docker pull modularitycontainers/php
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
To build your php application run:
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
# s2i build <SOURCE\-REPOSITORY> modularitycontainers/php <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
|
||||
The following environment variables set their equivalent property value in the php.ini file:
|
||||
|
||||
.PP
|
||||
ERROR\_REPORTING
|
||||
Informs PHP of which errors, warnings and notices you would like it to take action for.
|
||||
Default: E\_ALL \& \~E\_NOTICE
|
||||
|
||||
.PP
|
||||
DISPLAY\_ERRORS
|
||||
Controls whether or not and where PHP will output errors, notices and warnings.
|
||||
Default: ON
|
||||
|
||||
.PP
|
||||
DISPLAY\_STARTUP\_ERRORS
|
||||
Cause display errors which occur during PHP's startup sequence to be handled separately from display errors.
|
||||
Default: OFF
|
||||
|
||||
.PP
|
||||
TRACK\_ERRORS
|
||||
Store the last error/warning message in $php\_errormsg (boolean)
|
||||
Default: OFF
|
||||
|
||||
.PP
|
||||
HTML\_ERRORS
|
||||
Link errors to documentation related to the error
|
||||
Default: ON
|
||||
|
||||
.PP
|
||||
INCLUDE\_PATH
|
||||
Path for PHP source files
|
||||
Default: .:/opt/app\-root/src:/usr/share/pear
|
||||
|
||||
.PP
|
||||
SESSION\_PATH
|
||||
Location for session data files
|
||||
Default: /tmp/sessions
|
||||
|
||||
.PP
|
||||
SHORT\_OPEN\_TAG
|
||||
Determines whether or not PHP will recognize code between <? and ?> tags
|
||||
Default: OFF
|
||||
|
||||
.PP
|
||||
DOCUMENTROOT
|
||||
Path that defines the DocumentRoot for your application (ie. /public)
|
||||
Default: /
|
||||
|
||||
.PP
|
||||
The following environment variables set their equivalent property value in the opcache.ini file:
|
||||
|
||||
.PP
|
||||
OPCACHE\_MEMORY\_CONSUMPTION
|
||||
The OPcache shared memory storage size in megabytes
|
||||
Default: 128
|
||||
|
||||
.PP
|
||||
OPCACHE\_REVALIDATE\_FREQ
|
||||
How often to check script timestamps for updates, in seconds. 0 will result in OPcache checking for updates on every request.
|
||||
Default: 2
|
||||
|
||||
.PP
|
||||
You can also override the entire directory used to load the PHP configuration by setting:
|
||||
|
||||
.PP
|
||||
PHPRC
|
||||
Sets the path to the php.ini file
|
||||
|
||||
.PP
|
||||
PHP\_INI\_SCAN\_DIR
|
||||
Path to scan for additional ini configuration files
|
||||
|
||||
.PP
|
||||
You can override the Apache MPM prefork settings to increase the performance for of the PHP application. In case you set
|
||||
the Cgroup limits in Docker, the image will attempt to automatically set the
|
||||
optimal values. You can override this at any time by specifying the values
|
||||
yourself:
|
||||
|
||||
.PP
|
||||
HTTPD\_START\_SERVERS
|
||||
The StartServers directive sets the number of child server processes created on startup.
|
||||
Default: 8
|
||||
|
||||
.PP
|
||||
HTTPD\_MAX\_REQUEST\_WORKERS
|
||||
The MaxRequestWorkers directive sets the limit on the number of simultaneous requests that will be served.
|
||||
\fB\fCMaxRequestWorkers\fR was called \fB\fCMaxClients\fR before version httpd 2.3.13.
|
||||
Default: 256 (this is automatically tuned by setting Cgroup limits for the container using this formula:
|
||||
\fB\fCTOTAL\_MEMORY / 15MB\fR. The 15MB is average size of a single httpd process.
|
||||
|
||||
.PP
|
||||
You can use a custom composer repository mirror URL to download packages instead of the default 'packagist.org':
|
||||
|
||||
.PP
|
||||
COMPOSER\_MIRROR
|
||||
Adds a custom composer repository mirror URL to composer configuration. Note: This only affects packages listed in composer.json.
|
||||
|
||||
.SH HOT DEPLOY
|
||||
.PP
|
||||
In order to immediately pick up changes made in your application source code, you need to run your built image with the \fB\fCOPCACHE\_REVALIDATE\_FREQ=0\fR environment variable passed to the Docker \fB\fC\-e\fR run flag:
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
# docker run \-e OPCACHE\_REVALIDATE\_FREQ=0 \-p 8080:8080 php\-app
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
To change your source code in running container, use Docker's exec command:
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
# docker exec \-it <CONTAINER\_ID> /bin/bash
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
After you Docker exec into the running container, your current directory is set to \fB\fC/opt/app\-root/src\fR, where the source code is located.
|
||||
|
||||
.SH SECURITY IMPLICATIONS
|
||||
.PP
|
||||
\-p 8080:8080
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
Opens container port 8080 and maps it to the same port on the Host.
|
||||
|
||||
.fi
|
||||
.RE
|
||||
121
root/help.md
Normal file
121
root/help.md
Normal file
|
|
@ -0,0 +1,121 @@
|
|||
% php(1)
|
||||
% Rado Pitonak \<rpitonak@redhat.com\>
|
||||
% DATE 07.04.2017
|
||||
|
||||
# NAME
|
||||
php - source to image builder of php applications.
|
||||
|
||||
# DESCRIPTION
|
||||
Image for building php application as reproducible Docker image using source to image. Image is based on fedora.
|
||||
## USAGE
|
||||
|
||||
To pull the php container run:
|
||||
|
||||
# docker pull modularitycontainers/php
|
||||
|
||||
To build your php application run:
|
||||
|
||||
# s2i build <SOURCE-REPOSITORY> modularitycontainers/php <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.
|
||||
|
||||
The following environment variables set their equivalent property value in the php.ini file:
|
||||
|
||||
ERROR_REPORTING
|
||||
Informs PHP of which errors, warnings and notices you would like it to take action for.
|
||||
Default: E_ALL & ~E_NOTICE
|
||||
|
||||
DISPLAY_ERRORS
|
||||
Controls whether or not and where PHP will output errors, notices and warnings.
|
||||
Default: ON
|
||||
|
||||
DISPLAY_STARTUP_ERRORS
|
||||
Cause display errors which occur during PHP's startup sequence to be handled separately from display errors.
|
||||
Default: OFF
|
||||
|
||||
TRACK_ERRORS
|
||||
Store the last error/warning message in $php_errormsg (boolean)
|
||||
Default: OFF
|
||||
|
||||
HTML_ERRORS
|
||||
Link errors to documentation related to the error
|
||||
Default: ON
|
||||
|
||||
INCLUDE_PATH
|
||||
Path for PHP source files
|
||||
Default: .:/opt/app-root/src:/usr/share/pear
|
||||
|
||||
SESSION_PATH
|
||||
Location for session data files
|
||||
Default: /tmp/sessions
|
||||
|
||||
SHORT_OPEN_TAG
|
||||
Determines whether or not PHP will recognize code between <? and ?> tags
|
||||
Default: OFF
|
||||
|
||||
DOCUMENTROOT
|
||||
Path that defines the DocumentRoot for your application (ie. /public)
|
||||
Default: /
|
||||
|
||||
The following environment variables set their equivalent property value in the opcache.ini file:
|
||||
|
||||
OPCACHE_MEMORY_CONSUMPTION
|
||||
The OPcache shared memory storage size in megabytes
|
||||
Default: 128
|
||||
|
||||
OPCACHE_REVALIDATE_FREQ
|
||||
How often to check script timestamps for updates, in seconds. 0 will result in OPcache checking for updates on every request.
|
||||
Default: 2
|
||||
|
||||
You can also override the entire directory used to load the PHP configuration by setting:
|
||||
|
||||
PHPRC
|
||||
Sets the path to the php.ini file
|
||||
|
||||
PHP_INI_SCAN_DIR
|
||||
Path to scan for additional ini configuration files
|
||||
|
||||
You can override the Apache MPM prefork settings to increase the performance for of the PHP application. In case you set
|
||||
the Cgroup limits in Docker, the image will attempt to automatically set the
|
||||
optimal values. You can override this at any time by specifying the values
|
||||
yourself:
|
||||
|
||||
HTTPD_START_SERVERS
|
||||
The StartServers directive sets the number of child server processes created on startup.
|
||||
Default: 8
|
||||
|
||||
HTTPD_MAX_REQUEST_WORKERS
|
||||
The MaxRequestWorkers directive sets the limit on the number of simultaneous requests that will be served.
|
||||
`MaxRequestWorkers` was called `MaxClients` before version httpd 2.3.13.
|
||||
Default: 256 (this is automatically tuned by setting Cgroup limits for the container using this formula:
|
||||
`TOTAL_MEMORY / 15MB`. The 15MB is average size of a single httpd process.
|
||||
|
||||
You can use a custom composer repository mirror URL to download packages instead of the default 'packagist.org':
|
||||
|
||||
COMPOSER_MIRROR
|
||||
Adds a custom composer repository mirror URL to composer configuration. Note: This only affects packages listed in composer.json.
|
||||
|
||||
## HOT DEPLOY
|
||||
|
||||
In order to immediately pick up changes made in your application source code, you need to run your built image with the `OPCACHE_REVALIDATE_FREQ=0` environment variable passed to the Docker `-e` run flag:
|
||||
|
||||
# docker run -e OPCACHE_REVALIDATE_FREQ=0 -p 8080:8080 php-app
|
||||
|
||||
To change your source code in running container, use Docker's exec command:
|
||||
|
||||
# docker exec -it <CONTAINER_ID> /bin/bash
|
||||
|
||||
After you Docker exec into the running container, your current directory is set to `/opt/app-root/src`, where the source code is located.
|
||||
|
||||
## SECURITY IMPLICATIONS
|
||||
|
||||
-p 8080:8080
|
||||
|
||||
Opens container port 8080 and maps it to the same port on the Host.
|
||||
Loading…
Add table
Add a link
Reference in a new issue