cd openshift-on-aws/modules mkdir S2i cd S2i
If you have not completed this step in a previous lab, please run through this now. If you have completed this under either the deploying application or automation section jump to the next lab.
change to the correct lab folder
cd openshift-on-aws/modules mkdir S2i cd S2i
Clone app source code
git clone https://github.com/rniksch/flask-vote-app.git
In this module you will use
Source to Image to build and launch the voting application on OpenShift.
Taking code and moving to containers results in developers writing code for their applications then defining all the parts needed to containerize the application and then further add templates or spec files which are used by orchestrators.
OpenShift attempts to make it easire and faster for developers to get code running on the platform.
Source 2 Image (s2i) does the following:
Launches a container from a "builder image" of the matching runtime. In this case that’s a python 2.7 builder image.
Executes a build of the application in the running builder container.
After a successful build, s2i commits a new image containing the built application and pushes it into the internal registry of OpenShift.
The container is launched because a new image has been created. If the container is already running from a previous build, the container will be re-deployed.
Connect to the OpenShift cluster using the cli
Connect to your Cloud 9 dev ui if you have not already done so. Connect to the workshop student landing page: https://lab2-ignitionbucket-137e1h7z6m6h0.s3-us-west-2.amazonaws.com/workshop.html [Student landing page] Find and expand your student number Follow the instructions to connect to your Cloud 9 developer IDE ./oc login api.apps.lab3-student0.egrsolutions.co.za:6443 provide the username and password for the https://lab2-ignitionbucket-137e1h7z6m6h0.s3-us-west-2.amazonaws.com/workshop.html
"oc new-app" is the command that initializes an application in various ways on OpenShift. You will use it to get your source code running on OpenShift.
perform a source to image dry run
We will make use of the
new-app command with the
looks into the current working directory ".", detects python source code and determines its associated GitHub repository.
creates a build object called a
build configuration (BC). The build configuration knows:
the location of the repository which holds the
python builder image
where to fetch the source code from, e.g. the GitHub repository
knows the name of the output image which will be pushed into the internal container registry (
image streams (IS) (a.k.a. OpenShift image objects) to track the builder and the final application image
these image streams are able to detect when images are updated and trigger a rebuild or a re-deployment of the application
creates a deployment object called a
deployment configuration (DC). The deployment configuration knows:
how to re-deploy the application should the image be updated
service object to enable discovery and access to one or more running application containers.
If there are no warnings or errors and all looks well, execute the command without the
Deploying an application using S2i
oc new-app python:2.7~. --name vote-app --dry-run
Note: Normally the "new-app" command would automatically select a matching builder image based on the source code but since our code specifically requires Python version 2.7 to function properly we explicitly provide the name and version of the builder image we want to use (python:2.7).
Now that we dry run is complete and we are not seeing issues we can run the new-app command to generate all these builing blocks from the application code and save us time and effort.
oc new-app python:2.7~. --name vote-app
This command will have listed out all the OpenShift objects that were created.
Note: Should the build configuration already exists from a previous invocation, start the build again with the following command:
oc start-build vote-app
You can follow the build process in the console and also on the command line, like this:
oc logs bc/vote-app --follow
To view the output of the build in the console, click on the build (
vote-app-1) and then on the
Wait for the build to finish before continuing.
Note, the build takes a few minutes, especially the
Copying blob… and the
Storing signatures operations can be slow.
You will see the following amongst the build output:
... Cloning "https://github.com/johnsmith/flask-vote-app.git" ... ... STEP 8: RUN /usr/libexec/s2i/assemble ... STEP 10: COMMIT temp.builder.openshift.io/... ... Successfully pushed ... Push successful
What happens during the build?
the source code is cloned.
the python builder image is launched and the code copied into it.
assemble script is executed. It knows how to build a python application.
the python dependencies are installed
the running container is committed and a new image is created
the image is then pushed into OpenShift’s internal container registry
After the build has completed, the image is automatically launched and a container in a pod is created.
You should see that the build container has completed (
vote-app-1-build Completed) and a new application container is starting
You can also run the following command to view the pods running in your project:
oc get pods
Wait for the build to complete. You should see (
Push successful) in the build log output and the build pod should show
You should see something similar to this:
NAME READY STATUS RESTARTS AGE vote-app-1-build 0/1 Completed 0 4m vote-app-1-deploy 0/1 Running 0 3m vote-app-1-gxq5k 1/1 Running 0 30s
Expose the application for testing
By default, the application is not accessible from outside of OpenShift. Now, expose the application to the external network so it can be tested:
oc expose svc vote-app
The above command creates a
route object. An OpenShift Container Platform route exposes a service at a host name, like www.example.com, so that external clients can reach it by name.
Check the route object:
oc get route
You should see the hostname to use to access the application.
Test the application
To check the application is working you can either use curl or load the URL into your browser.
Use curl to check the app is working:
or use another way which checks for the expected output:
curl -s http://vote-app-%project_namespace%.%cluster_subdomain%/ | grep "<title>"
You should see the following output which means the application is working:
The application can be further tested using our helper-script.
Post a few random votes to the application using the help-script:
To view the results use the following command. You should see the totals of all the voting options:
curl -s http://vote-app-%project_namespace%.%cluster_subdomain%/results.html | grep "data: \["
You should see something like the following, showing all the cast votes:
data: [ "3", "3", "2", "0", "1", "5", "1", "3", "2", ],
Or, view the results page in a browser:
[View Results page](http://vote-app-%project_namespace%.%cluster_subdomain%/results.html)
if the message
Application is not available is displayed, this means the application is not running yet or the build has failed.
by default, the application uses a built-in database to store the vote data. In later exercises we will configure the application to use an external MySQL database.
$ oc logs bc/vote-app Cloning "https://github.com/repo/flask-vote-app.git" ... Commit: 23d4bdeec2449deb1532280cce6be54b6f0200f0 (update) Author: Your Name <you@ example.com> Date: Wed Jul 3 09:35:55 2019 +0000 Caching blobs under "/var/cache/blobs". Getting image source signatures Copying blob sha256:db1d55616933198cd32cb3a3a658a903a9205c733af15ca6423268d83a2a5840 ... Writing manifest to image destination Storing signatures 07822e6843338f8ad388f1f34294082de46f7e897c6a743d60dde1e3af55be71 Generating dockerfile with builder image image-registry.openshift-image-registry.svc:5000/openshift/python@sha256:b604de44d1d298873ba1620e2941536a4ec2c836b43eafdcbcd61132bd446d70 STEP 1: FROM image-registry.openshift-image-registry.svc:5000/openshift/python@sha256:b604de44d1d298873ba1620e2941536a4ec2c836b43eafdcbcd61132bd446d70 STEP 2: LABEL "io.openshift.build.image"="image-registry.openshift-image-registry.svc:5000/openshift/python@sha256:b604de44d1d298873ba1620e2941536a4ec2c836b43eafdcbcd61132bd446d70" "io.openshift.build.commit.author"="Your Name <email@example.com>" "io.openshift.build.commit.date"="Wed Jul 3 09:35:55 2019 +0000" "io.openshift.build.commit.id"="23d4bdeec2449deb1532280cce6be54b6f0200f0" "io.openshift.build.commit.ref"="master" "io.openshift.build.commit.message"="update" "io.openshift.build.source-location"="https://github.com/sjbylo3/flask-vote-app.git" STEP 3: ENV OPENSHIFT_BUILD_NAME="vote-app-6" OPENSHIFT_BUILD_NAMESPACE="lab-ocp4" OPENSHIFT_BUILD_SOURCE="https://github.com/sjbylo3/flask-vote-app.git" OPENSHIFT_BUILD_REFERENCE="master" OPENSHIFT_BUILD_COMMIT="23d4bdeec2449deb1532280cce6be54b6f0200f0" STEP 4: USER root STEP 5: COPY upload/src /tmp/src STEP 6: RUN chown -R 1001:0 /tmp/src STEP 7: USER 1001 STEP 8: RUN /usr/libexec/s2i/assemble ---> Installing application source ... ---> Installing dependencies ... You are using pip version 7.1.0, however version 19.1.1 is available. You should consider upgrading via the 'pip install --upgrade pip' command. Collecting flask (from -r requirements.txt (line 1)) Downloading https://files.pythonhosted.org/packages/9a/74/670ae9737d14114753b8c8fdf2e8bd212a05d3b361ab15b44937dfd40985/Flask-1.0.3-py2.py3-none-any.whl (92kB) Collecting flask-sqlalchemy (from -r requirements.txt (line 2)) Downloading https://files.pythonhosted.org/packages/08/ca/582442cad71504a1514a2f053006c8bb128844133d6076a4df17117545fa/Flask_SQLAlchemy-2.4.0-py2.py3-none-any.whl Collecting mysql-python (from -r requirements.txt (line 3)) Downloading https://files.pythonhosted.org/packages/a5/e9/51b544da85a36a68debe7a7091f068d802fc515a3a202652828c73453cad/MySQL-python-1.2.5.zip (108kB) Collecting itsdangerous>=0.24 (from flask->-r requirements.txt (line 1)) Downloading https://files.pythonhosted.org/packages/76/ae/44b03b253d6fade317f32c24d100b3b35c2239807046a4c953c7b89fa49e/itsdangerous-1.1.0-py2.py3-none-any.whl Collecting Werkzeug>=0.14 (from flask->-r requirements.txt (line 1)) Downloading https://files.pythonhosted.org/packages/9f/57/92a497e38161ce40606c27a86759c6b92dd34fcdb33f64171ec559257c02/Werkzeug-0.15.4-py2.py3-none-any.whl (327kB) Collecting Jinja2>=2.10 (from flask->-r requirements.txt (line 1)) Downloading https://files.pythonhosted.org/packages/1d/e7/fd8b501e7a6dfe492a433deb7b9d833d39ca74916fa8bc63dd1a4947a671/Jinja2-2.10.1-py2.py3-none-any.whl (124kB) Collecting click>=5.1 (from flask->-r requirements.txt (line 1)) Downloading https://files.pythonhosted.org/packages/fa/37/45185cb5abbc30d7257104c434fe0b07e5a195a6847506c074527aa599ec/Click-7.0-py2.py3-none-any.whl (81kB) Collecting SQLAlchemy>=0.8.0 (from flask-sqlalchemy->-r requirements.txt (line 2)) Downloading https://files.pythonhosted.org/packages/62/3c/9dda60fd99dbdcbc6312c799a3ec9a261f95bc12f2874a35818f04db2dd9/SQLAlchemy-1.3.5.tar.gz (5.9MB) Collecting MarkupSafe>=0.23 (from Jinja2>=2.10->flask->-r requirements.txt (line 1)) Downloading https://files.pythonhosted.org/packages/b9/2e/64db92e53b86efccfaea71321f597fa2e1b2bd3853d8ce658568f7a13094/MarkupSafe-1.1.1.tar.gz Installing collected packages: itsdangerous, Werkzeug, MarkupSafe, Jinja2, click, flask, SQLAlchemy, flask-sqlalchemy, mysql-python Running setup.py install for MarkupSafe Running setup.py install for SQLAlchemy Running setup.py install for mysql-python Successfully installed Jinja2-2.10.1 MarkupSafe-1.1.1 SQLAlchemy-1.3.5 Werkzeug-0.15.4 click-7.0 flask-1.0.3 flask-sqlalchemy-2.4.0 itsdangerous-1.1.0 mysql-python-1.2.5 STEP 9: CMD /usr/libexec/s2i/run STEP 10: COMMIT temp.builder.openshift.io/lab-ocp4/vote-app-6:08b9efd8 Getting image source signatures Copying blob sha256:8783de338a118d308a5f8e00576afc318fac3a8a35767d95948493915cc249a8 ... Writing manifest to image destination Storing signatures --> 4efd91078c869feb60bcdbae4b6683cb12984fb20d4dc1bf208f1d7684375860 Pushing image image-registry.openshift-image-registry.svc:5000/lab-ocp4/vote-app:latest ... Getting image source signatures Copying blob sha256:db1d55616933198cd32cb3a3a658a903a9205c733af15ca6423268d83a2a5840 ... Writing manifest to image destination Storing signatures Successfully pushed //image-registry.openshift-image-registry.svc:5000/lab-ocp4/vote-app:latest@sha256:cf182b356492d25b9a5af1e014564bbb52691c530e2a8e8928ce70898a0596f5 Push successful