Instantly Run An App in the Cloud

(Difference between revisions)
Jump to: navigation, search
(matched overview bullets to actual titles; they were different because I found that a different structure was needed once I dove into it and wrote it all)
(added blog deliverable)
Line 209: Line 209:
=== Deliverables: ===
=== Deliverables: ===
What will the student hand in?
Create one blog item, with URL, that talks about:
# What you learned
#* Both specific to OpenShift and generally about Cloud Computing and PaaS
# What troubles or more info you came across
#* Troubleshooting you did, additional info you searched about, etc
# What other ways you might use a PaaS environment in the future
#* What other apps and coding platforms/languages could you use?
#* Why is the git "Source Code" feature so killer? What could it enable you to do?
=== Assessment: ===
=== Assessment: ===

Revision as of 20:36, 31 July 2015

Title Instantly Run An App in the Cloud Using OpenShift
Overview Students need to know what Cloud Computing really means, how it fits into the wider computing context, and how they can use an open source cloud alternative to quickly host coding platforms for them to toy around in. This activity sets out to do all of this as a walkthrough learn-as-you-go tutorial.
Prerequisite Knowledge Command line skills and Beginner Git experience (git activity 1)
Learning Objectives
  • Understand what Cloud / Utility Computing is
  • Be able to quickly spin up an app in an online PaaS environment
  • Learn the context of SSH and URLs and components of online applications



What is the rational for this activity?

Students need to know what Cloud Computing really means, how it fits into the wider computing context, and what the different types are (IaaS, PaaS, SaaS). Students can dig into PasS, as a powerful development platform - and understand how quickly, easily, and powerfully they can spin up new applications. Gone are the days of having to setup a physical server, know the details on how to setup the OS, fiddle with the kernel, setup web-servers (Apache), databases (Postgres, Mysql), and middle-ware micros-services (AMQP Message busses, JBoss Fuse, Apache Camel). In a PaaS environment like OpenShift, the developer just fires up an instance of whatever pieces they want, and start coding. Seriously - its that easy. Of course, the developer has to know how to develop in said language or platform, but it makes development considerably easier by removing focus from lower layers. Basically, those lower layers (most mentioned above) are automated away by the PaaS platform.

We need an activity that can show students, step-by-visual-step, how to start up a new coding environment and actually code a small chunk of working software on Openshift. Make it something sexy, like Node.js. Make it an effective piece of code (contact someone within red hat for advise) and it would be even more amazing.

Background readings:


You may have heard of Software as a Service (SaaS), or Cloud Computing before. Examples of SaaS are that of Google Docs, Twitter, DropBox. Another flavor of Cloud Computing is Platform as a Service (PaaS). This cloud-hosted service allows developers to program apps and functionality in an easy to grasp and scale and demo online environment. You can push stuff live very quickly, and you dont have to worry about backup or the Operating System, or getting database services running. Your infrastructure and coding platform are pre-taken-care-of. You just code your app. Lets go signup for one and start a simple blog app.


Here are the major steps you will implement:

  • Get OpenShift Online account
  • Quick Setup
  • Quick Win - Start Wordpress
  • Setup Wordpress Instance
  • Instance launched
  • Startup / Use Wordpress

Get OpenShift Online account

One such PaaS provider (amongst many) is Red Hats OpenShift. Other examples are Heroku, Google AppEngine, Engineyard, Microsoft Azure, VMWare's CloudFoundry. The list goes on. However, one of the cool things bout OpenShift is that its open sourced. You will remain free to move your code and environment to other vendors within OpenShift. Say that Red Hat starts charging too much - many vendors can be implementing the same environment,allowing you to easily move (at least, more easily than proprietary solutions). Alternatively, you could take OpenShifts code and implement your own PaaS server, on your computer at home. Only those whose source code is open sourced can claim this.


Quick Setup

  • Login to OpenShift Online
  • Click on the Settings tab on the webpage
  • Namespace field, fill it in
    • This will define the URL that you and others will visit to see your live apps that your create.
    • So, for example, we enter "teachingoss" and our URLs will be something like:


  • Public Keys, for now, we will leave this blank
    • If you know what a public key is, and you have one on your existing machine, go ahead and enter it here
    • This will allow you to extremely easily access the SSH command line of your virtual app
    • We will touch on it in a later activity

Quick Win - Start Wordpress

Lets actually do something with OpenShift! Wordpress is an open source blogging platform. They have an online SaaS offering (Software as a Service), and you can also implement your own instance of wordpress to operate and customize your own blog. You might operate your own if you want to customize the looks of it, or add custom functionality via plugins (which there thousands of), or if you just want to be in control of your data. Lets go.

  • Click on the Applications tab
  • If you have not started an app already, click the text Create your first application now
  • A list of applications, coding platforms, coding languages, and middleware appear in a large grid / list.
    • This is how you can explore what Red Hat offers "out of the box".
    • Dont worry though, this is open source, and the community provides hundreds more at
    • We wont use hub.openshift in this example
  • Choose Wordpress as the app that we will launch.
    • Troubleshoot: If you dont see Wordpress, there is a search field where you can type it in and find it


Setup Wordpress Instance

  • You should now be in the screen that launches Wordpress, called Wordpress Quickstart
  • See the screenshot below and note the red circled fields; those need interaction


Lets go through each of the fields, what they mean, and fill out a few:

  • Based On explains what this application is, where you can get more info, and who maintains it (if its Red Hat upkept or community created)
  • Public URL sets the http:// address that you will use to get to your Wordpress instance
    • Notice that the "-teachingoss" (or whatever you used) from the earlier setup step, is hardcoded here
    • You are now prepending that hardcoded piece of the url, so that each specific app that you start (you can run many) has a unique URL
    • Enter "wordpress" here
  • Source Code tells OpenShift where to get the code for Wordpress to start off of
    • Very powerful feature alert!
    • This one is already set (dont change it) because it is a pre-made one from Red Hat and OpenShift, however, you could tell OpenShift to use any piece of code here, if it is properly arranged
    • Do not change this setting
  • Gears sets what and how big of virtual resources your Wordpress instance gets access to
    • RAM, Harddrive, etc.
    • For this free hosted version of Openshift, you can only use "small"
    • Small is useful for most beginning and one-off projects
    • Organizations and heavily-trafficked websites may want to use bigger gears to allow more bandwidth or faster responses to many users
  • Scaling tells OpenShift if you want this application to be auto-scaled
    • Auto-scaling is for dynamically provisioning more and more or less and less instances to handle an unknown amount of traffic
    • You wont need this unless you expect large and fluctuating traffic coming to your application
    • It is very useful for advertisement or startup use-cases, where a sudden reddit-cloud or popular advertisement sends thousands to your website
    • This is a key benefit of PaaS; it allows developers to code / setup their application, and not worry as much about how to scale it later
  • Region tells OpenShift where to physically start your virtual machine
    • Because OpenShift online relies on Amazon Web Services (AWS) to start these instances, it uses Amazons region terminology
    • The choice for one or a handful of users wont make a different - a few milliseconds
    • However, if you think hundreds of users will access your application from the west coast, or europe, you can change this here


  • After filling out what is needed, click Create Application
  • This could take 1-5 minutes, depending on how trafficked the web is currently
    • Basically you are starting up a new virtual machine and installing a few applications - so it takes time
    • Note: this slowness may also be a bug of the web interface; when doing this via the command-line, it is often quicker

Instance launched

  • Change the code?
    • The next page asks "Will you be changing the code of this application?"
    • In this activity, we will not be, so you select Now now, continue
    • However, lets discuss the other options and what this means
    • If you selected "Yes, help me get started", it brings up some additional prompts explaining that Git is used to sync code, and that you can get interactive SSH shell access to the command line of this virtual app box.
    • To do this, you would need to setup a public SSH keypair
    • This is involved, and we wont handle it here; however, know that it exists


  • Finally, you see the Instance page for this new Wordpress app you have started!


  • You can see that the PHP and MySQL cartridges were started, and you are even given the login/passwords for these.
  • RECORD THESE CREDENTIALS, as you will use them later
  • It tells you what was started, what gears are involved, what location it is hosted at, how many gears it takes (its size), and how much storage it is allotted, amongst other info
  • You can always visit this Instance Info page once wordpress is running
  • Technically, this costs someone money; Red Hat is paying for this via Amazon
  • If you find youself not using it anymore, Delete the application... / Shut it down; Dont waste resources; Recycle; All that jazz!

Startup / Use Wordpress

Now lets actually see our Wordpress Instance running and quickly set it up, so that we can get to a genuinely useful screen (making a new blog, seeing existing blogs).

  • Start by clicking the URL on the Instance page; For us it is
  • Click Continue when asked what language you prefer
  • Fill out the Welcome page and RECORD your username and password
    • Note that anyone visiting this page would be able to do this same thing
    • This means if someone stumbled upon it, while in this initial setup-phase, they would steal your website
    • Dont ever let an app sit in this "setup" phase very long, or it can get hacked
  • Now use those credentials to Login' to the Wordpress instance
  • Voila! You have access to your Blogs dashboard and can add new blogs, etc



Create one blog item, with URL, that talks about:

  1. What you learned
    • Both specific to OpenShift and generally about Cloud Computing and PaaS
  2. What troubles or more info you came across
    • Troubleshooting you did, additional info you searched about, etc
  3. What other ways you might use a PaaS environment in the future
    • What other apps and coding platforms/languages could you use?
    • Why is the git "Source Code" feature so killer? What could it enable you to do?


How will the activity be graded?

How will learning will be measured?

Include sample assessment questions/rubrics.

Criteria Level 1 (fail) Level 2 (pass) Level 3 (good) Level 4 (exceptional)
The purpose of the project
Why the project is open source


What should the instructor know before using this activity?

What are some likely difficulties that an instructor may encounter using this activity?

Additional Information:

Knowledge Area/Knowledge Unit What ACM Computing Curricula 2013 knowledge area and units does this activity cover? ACM_Body_of_Knowledge
Topic What specific topics are addressed? The Computing Curriucula 2013 provides a list of topics -
Level of Difficulty Is this activity easy, medium or challenging?
Estimated Time to Completion How long should it take for the student to complete the activity?
Materials/Environment What does the student need? Internet access, IRC client, Git Hub account, LINUX machine, etc.?
Author Who wrote this activity?
Source Is there another activity on which this activity is based? If so, please provide a link to the original resource.
License Under which license is this material made available? (

Suggestions to Open Source Mentors:

Suggestions for an open source community member who is working in conjunction with the instructor.

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License

CC license.png

Personal tools
Learning Resources
HFOSS Projects