Openshift Nginx Cartridge

Welcome to a life where nginx is possible on openshift.

This cartridge allow you to create a scalable nginx application, defaulting to using nginx version 1.9.12. Combine this with the PHP cartridge and you have a scalable application using the latest versions.

Just create your app using:

rhc create-app myapp http://cartreflect-claytondev.rhcloud.com/github/bcphung/openshift-cartridge-nginx

If you want to install a specific nginx version you can add --env OPENSHIFT_NGINX_VERSION=<version> to the command. For example to install nginx 1.8.0 you can use:

rhc create-app myapp --env OPENSHIFT_NGINX_VERSION=1.9.12 http://cartreflect-claytondev.rhcloud.com/github/bcphung/openshift-cartridge-nginx

Versions

Currently this cartridge has the following versions:

1.8.1
1.9.12

If you need another version you can compile it yourself and submit a PR to get it integrated.

Compiling a new version

To compile a new version you will first need a openshift application.

rhc create-app nginx http://cartreflect-claytondev.rhcloud.com/github/bcphung/openshift-cartridge-nginx?commit=develop&r=1

Now clone the repository and create a nginx folder. Now copy the usr/compile directory from this repository. Now set the versions you need to compile in the nginx/compile/versions file. Commit and push the application repository.

SSH into you app and go to the compile folder (cd ${OPENSHIFT_REPO_DIR}/nginx/compile) and start compiling by running the following command:

./all

Once compiling is done you can download the nginx.tar.gz from you application. Extract the nginx-{version} from the archive and place them into the openshift-cartridge-nginx/usr folder. Last but not least edit the openshift-cartridge-nginx/manifest.yml and add the versions.

All done just commit and push to your openshift-cartridge-nginx repo and use:

http://cartreflect-claytondev.rhcloud.com/github/<user>/openshift-cartridge-nginx