Part 4: Deploy an application on OpenShift on the IBM Cloud
The setup of the OpenShift cluster must be completed to finish this workshop. It is completely set up when the worker node(s) show a status of "Normal" in the "Worker Nodes" section AND
if there is a "Ingress subdomain" displayed in the "Overview" of the cluster:
Access the OpenShift Web Console via the button (1) in this dialog.
You have seen and used this Web Console in the interactive tutorials in Part 3. But notice the User ID (1) and the down arrow to right of it. If you click on it you will see an important option: "Copy Login Command". This allows you to login to your OpenShift cluster on IBM Cloud with the
ocCLI. But first you need to install the CLI.
This part of the workshop is divided in two sections:
A. Working with the OpenShift Web Console
B. Working with the
occommand line tool
A. Deploy an application from the Web Console
In the OpenShift Web Console, click "+ Create Project" and give your project a name, e.g. "blog". Click "Create".
Click on your new project "blog" in the "My Projects" list. This opens the projects Overview, which is empty and offers you some "Get started" options.
Click on "Deploy Image".
Select "Image Name" and enter
openshiftkatacoda/blog-django-pyas name, then click on the "magnifying glass".
- OpenShift reads details from the image and displays them. It fills in a name, based on the image name, and a label "app" whose content is also based on the image name.
- Leave the defaults and click "Deploy". In the resulting dialog click the "Continue to the project overview" link.
- In the project overview, click on the twistie (1) to open the overview of the application. This example should be familiar, it was used in the second tutorial on the Red Hat Learning portal. Create a Route (2), accept the defaults, and click on the resulting URL. The blog application should open. If you want, scale the deployment up and down (3).
B. Deploy an application with
oc from the command line
oc command line tool includes all the functionality of the Kubernetes native
kubectl CLI but it has also all the function required for OpenShift specifics, e.g. a
login command to access the OpenShift cluster.
Install the OpenShift
Go back to the IBM Cloud Dashboard and display your OpenShift cluster. If you closed the IBM Cloud Dashboard you can find OpenShift clusters here.
In the "Access" section of your cluster is detailed information about installing the
ocCLI and and the different methods to get access to your cluster.
Login to the OpenShift Cluster
oc is installed, copy the login command from the OpenShift Web Console and paste it into a command window (shell). It will look similar to this:
$ oc login https://c100-e.us-south.containers.cloud.ibm.com:30*** --token=z5cuqxABC-9QdqE1ivXYZ1z_Y6Tghj1qxN-abCWc1Bg
If login is successfull you will see all the projects on OpenShift that you have access to.
Keep the command line open but go back to the OpenShift Web Console.
Working with the
Go back to your command line where you used
octo logon to your OpenShift cluster.
Switch to the project you created in the Web Console with:
$ oc project blog Now using project "blog" on server "https://c100-e.us-south.containers.cloud.ibm.com:30***".
- Display all objects that belong to your project:
$ oc get all -o name pod/blog-django-py-1-qk7d9 replicationcontroller/blog-django-py-1 service/blog-django-py deploymentconfig.apps.openshift.io/blog-django-py imagestream.image.openshift.io/blog-django-py route.route.openshift.io/blog-django-py
- Display all objects that are labeled with your app name, the list should be the same as before:
$ oc get all -l app=blog-django-py -o name pod/blog-django-py-1-qk7d9 replicationcontroller/blog-django-py-1 service/blog-django-py deploymentconfig.apps.openshift.io/blog-django-py imagestream.image.openshift.io/blog-django-py route.route.openshift.io/blog-django-py
- Delete them with:
$ oc delete all -l app=blog-django-py -o name pod/blog-django-py-1-qk7d9 replicationcontroller/blog-django-py-1 service/blog-django-py deploymentconfig.apps.openshift.io/blog-django-py imagestream.image.openshift.io/blog-django-py route.route.openshift.io/blog-django-py
If you go back to the Web Console you should see that it updated the Overview which now should be empty again.
Deploy an application from the command line
- Check if the image is available:
$ oc new-app --search openshiftkatacoda/blog-django-py Docker images (oc new-app --docker-image=<docker-image> [--code=<source>]) ----- openshiftkatacoda/blog-django-py Registry: Docker Hub Tags: latest
- Deploy the image as an application:
$ oc new-app openshiftkatacoda/blog-django-py --> Found Docker image 927f823 (2 months old) from Docker Hub for "openshiftkatacoda/blog-django-py" Python 3.5 ---------- Python 3.5 available as container is a base platform for building and running various Python 3.5 applications and frameworks. Python is an easy to learn, powerful programming language. It has efficient high-level data structures and a simple but effective approach to object-oriented programming. Python's elegant syntax and dynamic typing, together with its interpreted nature, make it an ideal language for scripting and rapid application development in many areas on most platforms. Tags: builder, python, python35, python-35, rh-python35 * An image stream tag will be created as "blog-django-py:latest" that will track this image * This image will be deployed in deployment config "blog-django-py" * Port 8080/tcp will be load balanced by service "blog-django-py" * Other containers can access this service through the hostname "blog-django-py" --> Creating resources ... imagestream.image.openshift.io "blog-django-py" created deploymentconfig.apps.openshift.io "blog-django-py" created service "blog-django-py" created --> Success Application is not exposed. You can expose services to the outside world by executing one or more of the commands below: 'oc expose svc/blog-django-py' Run 'oc status' to view your app.
- Check the status of your deployment:
$ oc status --suggest In project blog on server https://c100-e.us-south.containers.cloud.ibm.com:30634 svc/blog-django-py - 172.21.51.187:8080 dc/blog-django-py deploys istag/blog-django-py:latest deployment #1 deployed 56 seconds ago - 1 pod Info: * dc/blog-django-py has no readiness probe to verify pods are ready to accept traffic or ensure deployment is successful. try: oc set probe dc/blog-django-py --readiness ... * dc/blog-django-py has no liveness probe to verify pods are still running. try: oc set probe dc/blog-django-py --liveness ...
The --suggest options even gives you infos on things that are missing in your configuration.
- Your application needs a Route to expose it externally:
$ oc expose service/blog-django-py route.route.openshift.io/blog-django-py exposed
- Display the URL of the Route:
$ oc get route/blog-django-py NAME HOST/PORT PATH SERVICES PORT TERMINATION WILDCARD blog-django-py blog-django-py-blog.harald-uebele-openshift-5290c8c8e5797924dc1ad5d1bcdb37c0-0001.us-south.containers.appdomain.cloud blog-django-py 8080-tcp None
You can see the very long URL. If you want, copy it and open it in your browser.
- Cleanup. This deletes everything including your project! This command takes a while to complete.
$ oc delete project blog project.project.openshift.io "blog" deleted
You can also delete a complete project from the Web Console.
Congratulations! You have completed this workshop!
Continue with the second workshop in this series: "Deploying Java Microservices to OpenShift on IBM Cloud".
Back to the overview