startx/sv-php repository overview

⁠Docker OS Images : APACHE + PHP

Startx php is a base container used for dynamic web services and applications published in Dockerhub registry⁠. This container contain :

• fedora system envelope
• core OS rpm (kernel, libs) updated every week
• fundamentals tools (ex: pwgen, tar, zip) updated every week
• Apache webserver and fundamentals modules (apache release depend on the flavour you use, read down for more information)
• PHP and php-fpm (PHP release depend on the flavour you use, read down for more information)
• usefull tools (psmisc, procps, coreutils, findutils, wget, curl, vi, bash-completion) only for the :latest and :devel flavour.

You can use Startx Apache image in many ways :

• Build container based image application with s2i builder technology⁠
• Build container based image application with openshift builder image capacity⁠
• Build personalized base image with docker tools⁠
• Run as simple and lightweiht webserver with docker daemon⁠
• Run a minimal container app with docker-compose⁠
• Enrich you openshift service catalog with flavoured images streams⁠
• Add to your openshift service catalog an application builder template⁠
• Add to your openshift service catalog an application deployement template⁠

See more applications builders and sample on startx docker images repository⁠

⁠Container flavours

⁠Running this image

If you want to be guided on setting-up and installing various containers engines (docker⁠, podman⁠, s2i⁠, dockerEE⁠, kubernetes⁠, openshift⁠) you can read ours containers engines guidelines⁠.

⁠Running using docker

docker run -it -p 9213:8080 --name="example-php" startx/sv-php

• Connect to your local application

firefox http://localhost:9213

⁠Running using docker-compose

• Create a docker-compose.yml file with the following content

php:
  image: startx/sv-php:latest
  container_name: "example-php"
  ports:
    - "9213:8080"

• Execute the following command

docker-compose up -d
docker-compose logs

• Connect to your local application

firefox http://localhost:9213

⁠Using this image as Openshift Build image

⁠Openshift images streams

Openshift cluster administrator can offer this image and all its flavour to all consumers. You can import our openshift images stream⁠ in your openshift project.

You must be cluster-admin to add this image to the openshift project. If not, you can add it to your own project (skip the oc project openshift command in the next script)

# swith to the openshift project
oc project openshift
# Add image streams to the service catalog (project or cluster-wide scope)
oc create -f https://raw.githubusercontent.com/startxfr/docker-images/master/Services/php/openshift-imageStreams.yml

⁠Openshift builder template

Openshift cluster administrator can add a build and deploy template to their consumers. As an administrator, you can import our openshift builder template⁠ in your openshift project.

You must be cluster-admin to add this image to the openshift project. If not, you can add it to your own project (skip the oc project openshift command in the next script)

# swith to the openshift project
oc project openshift
# Add this template to the service catalog (project or cluster-wide scope)
oc create -f https://raw.githubusercontent.com/startxfr/docker-images/master/Services/php/openshift-template-build.yml

You can then build an application

# create an example project
oc new-project example
# start a new application
oc process -f startx-php-build-template \
    -p APP_NAME=myapp \
| oc create -f -

⁠Openshift deploy template

Openshift cluster administrator can add a deploy template to their consumers. As an administrator, you can import our openshift deploy template⁠ in your openshift project.

You must be cluster-admin to add this image to the openshift project. If not, you can add it to your own project (skip the oc project openshift command in the next script)

# swith to the openshift project
oc project openshift
# Add this template to the service catalog (project or cluster-wide scope)
oc create -f https://raw.githubusercontent.com/startxfr/docker-images/master/Services/php/openshift-template-deploy.yml

You can then deploy an application

# create a example project
oc new-project example
# start a new application
oc process -f startx-php-deploy-template \
    -p APP_NAME=myapp \
| oc create -f -

⁠Using this image as S2I builder

Create your local project (skip if you already are in a project diretory with a run bash script)

# Create a project directory
mkdir example-project
cd example-project
# create a run script
cat << "EOF"
<html><head></head><body><h1>My Web Application</h1></body></html>
EOF > index.html

Then you can use this image as an s2i builder image

# With your current directory application code
s2i build . startx/sv-php:latest startx-php-myapp
docker run --rm -d -p 9213:8080 startx-php-myapp
# With startx application sample code repository
s2i build https://github.com/startxfr/docker-images-example-php startx/sv-php startx-php-sample
docker run --rm -d -p 9213:8080 startx-php-sample

⁠Using this image as base container

You can use this Dockerfile template to start a new personalized container based on this container. Create a file named Dockerfile in your project directory and copy this content inside. See docker guide⁠ for instructions on how to use this file.

FROM startx/sv-php:latest
#... your container specifications

⁠Environment variable

⁠For advanced users

You can contribute or start this container initiative locally. Follow theses instructions⁠ to setup a working environment.

This section will help you if you want to :

• Get latest version of this container Service source code
• Enhance and share your container improvement by adding instruction in Dockefile

⁠Build & run a container using docker

1. Jump into the container directory with cd Services/php
2. Build the container using docker build -t startx-php .
3. Run this container
   • Interactively with docker run -it startx-php. If you add a second parameter (like /bin/bash) to will run this command instead of the default entrypoint. Usefull to interact with this container (ex: /bin/bash, /bin/ps -a, /bin/df -h,...)
   • As a daemon with docker run -d -p 9213:8080 startx-php

⁠Build & run a container using docker-compose

1. Jump into the container directory with cd Services/php
2. Run this container
   • Interactively with docker-compose up Startup logs appears and escaping this command stop the container
   • As a daemon with docker-compose up -d. Container startup logs can be read using docker-compose logs