Deploy Static Content to APPUiO¶
This example describes how to deploy static content, like html files, images, videos, css, js to APPUiO.
Apache based image¶
As base image we are going to use the php:latest OpenShift base image, this image is supported and includes an Apache. In our case it is going to serve the static content.
The following two workflows are supported
Source To image Workflow from Git Repository¶
the simplest way to deploy static content to APPUiO is by using the source to image workflow
The source to image deployment basically scans the git repository and decides based on some rules on how to build the source code located in the respository. In our case the static content does not need to be built, therefore it simply “copies” the content to the correct location.
/opt/app-root/src
The source to image (S2I) workflow is very powerful, in our example we only use the basic build method. The S2I workflow can easily be extended, by running custom assemble and run scripts. Check out https://docs.openshift.com/enterprise/latest/creating_images/s2i.html for further information.
CLI¶
Creating a new App inside a project
Note: please check the getting started guide for more information about creating an account, downloading the cli, login and on how to create a new APPUiO project.
oc new-app [builderimage]~[gitrepository]
RHEL
oc new-app rhscl/php-56-rhel7~https://github.com/appuio/example-php-sti-helloworld.git
or in case you want to use the centos based image:
oc new-app centos/php-56-centos7~https://github.com/appuio/example-php-sti-helloworld.git
Note: use oc expose service [servicename]
Webconsole¶
You can also deploy the static content by using the webconsole.
- Navigate to your project overview
- click add to project
- choose base builder image php:latest
- enter git repository url where the static content is located: eg. https://github.com/appuio/example-php-sti-helloworld.git
- click create
the app build is triggered and automatically deployed.
Docker Build Workflow¶
The second way to deploy your static content to APPUiO is the docker build. This approach is way more flexible, therefore you have the possibility to either install additional packages inside the image and to customize the build process of your application.
Anyway, in our case we simply add the static content which is located in the app directory in our repository to the docker image:
FROM openshift/php-56-centos7
ADD app /opt/app-root/src
CMD $STI_SCRIPTS_PATH/run
CLI¶
Creating a new app inside a project:
oc new-app [builderimage] --strategy=docker
for example:
oc new-app https://github.com/appuio/example-php-docker-helloworld.git --strategy=docker
Nginx-based image¶
The deployment of your static content inside an nginx based container works similar to the Apache-based
Source To image¶
You can trigger the deployment with the following command:
oc new-app centos/nginx-18-centos7~https://github.com/appuio/example-nginx-helloworld.git
Docker Build¶
Just change the Base image to the centos nginx image in your Dockerfile
FROM centos/nginx-18-centos7
ADD app /opt/app-root/src
CMD $STI_SCRIPTS_PATH/run
And create the app on APPUiO, which triggers a build and deployment:
oc new-app https://github.com/appuio/example-nginx-helloworld.git --strategy=docker
Continuous Integration: Trigger Rebuild¶
If you want code changes to trigger rebuilds and redeployments of your application, you can simply add webhooks. APPUiO supports generic and GitHub triggers.
Check out https://docs.openshift.com/enterprise/latest/dev_guide/builds.html#webhook-triggers for further information.