Installing a Django Application on Red Hat's OpenShift PAAS

It seems like everyone has their own PAAS solution these days, and if they don't have one yet, it is just a matter of time before they will. Red Hat has recently joined in on the fun with their OpenShift platform.

I decided to take it for a test drive, and share my results with you. This service is still in beta and things are changing all of the time, so these notes might not work in the future, take that into consideration when using it as a guide.

There really isn't much python documentation for this platform, and what documentation there is, is either a little out of date, or missing some important steps. Hopefully this guide will help you get your application up and running.

OpenShift is divided into two parts, Flex and Express.

Express:

"Shared cloud solution. Express is a free, cloud-based application platform for Java, Perl, PHP, Python, and Ruby applications. It's super-simple—your development environment is also your deployment environment: git push, and you're in the cloud!"

Express runs on Red Hat's servers, and currently supports Java, Ruby, PHP, Perl and Python apps. It doesn't have the same features of Flex, but if you don't need those advanced features, then express might be fine for you. Since I'm interested in deploying python apps, and Express is the only one that supports python apps, that is the one I'll show you today.

To make things easier to show you how things work, I'll create a simple django application and walk you through the steps to deploying it. I'm going to deploy a djangoCMS to express that will connect to a mysql database.

Steps:

2. Install Prerequisites:

• git
• python
• openshift client
  
  

  Git:

  I'm not going to go over the steps to install git, for more infor, you can get it from the git website. http://git-scm.com/download
  
  

  Python:

  If you are using a Mac or Linux, it most likely already has python installed, if you are using Windows, then you probably don't have python installed.  Go to the Python website and you will find instructions on how to install python on your system. http://python.org/download/
  
  

  OpenShift Client:

  For instructions on how to install the client go to this page.  https://openshift.redhat.com/app/express#mac  Here are my steps for MacOS X

$ sudo gem install json_pure
$ sudo gem install rhc

3. Create a domain.

Now that you have everything installed, your first step is to create a domain. Run the following command and replace $mydoman and $loginemail with your own domain and the login email you used when creating an account.

$ rhc-create-domain -n $mydomain -l $loginemail

4. Create an application

Now that you have a domain, you need to create an application that you can deploy to that domain. Running the following command will create a new wsgi application called 'blog'. You can name your application anything you want, within reason. We pick wsgi, because our python application will be wsgi compatible.

$ rhc-create-app -a blog -t wsgi-3.2

5. Add mysql to your app

We want to use mysql as our database backend for this blog, so we need to add mysql to our application using the command below.

$ rhc-ctl-app -a blog -e add-mysql-5.1

6. Add phpmyadmin to help you manage your database

OpenShift doesn't give you direct access to your database, so you will need a way to manage your database a different way. They provide the ability to add PHPMyAdmin to your app so that you can get to your data. This step is optional, but recommended.

$ rhc-ctl-app -a blog -e add-phpmyadmin-3.4

7. Add this upstream repo from github

When you create your application, it will create a directory with a bunch of other files and directories in it. If you were starting from scratch and building up your application you would start from here. To make things easier I created a project on github that will allow you to get up and running with DjangoCMS much faster. In order to use my project you will need to run the following commands so that it will pull down the code into your project.

$ cd blog
$ git remote add upstream -m master git://github.com/kencochrane/django-cms-openshift.git
$ git pull -s recursive -X theirs upstream master

Once the code is downloaded, you can take a look at the code, change anything you want and when you are ready you can deploy the app.

8. Deploying the app

To deploy all you need to do is push the repo upstream into open shift. To this, you just need to run the following command.

$ git push

 

When it pushes you application into open shift it will do the following. (without jenkins add-on installed)

1. stop app
2. *pre_build
3. *build
4. start_dbs
5. *deploy
6. start_app
7. *post_deploy

The steps marked with a * are scripts that are located in .openshift/action_hooks/<script_name> if you have something in those files it will run them, and if not, it will pass right by. These are very helpful if you want something to happen at points of the deployment process. For example, in the deploy script you will notice that I have some code to kick off the django syncdb, migrate, and collect static commands. These will run every time I deploy the app.

I have also created a django management command that will check to see if there is a django admin account created and if not, it will create one and set the default password. I had to do this because there is currently no way that I know of where you can kick off django management commands after the deployment is finished. It will only create the admin account once, and every other time it will just get ignored.

IMPORTANT: It is important to note that if you want to do anything related to the database, you can't do it in the pre_build or build scripts, because the database isn't available yet. This one thing caused me lots of pain, because I couldn't figure out by my migrations were not working. If you do make the mistake of trying to do something database related in the build script you will see an error like this.

"remote: ERROR 2003 (HY000): Can't connect to MySQL server on 'xxx.x.xx.x' (111)"

 

That's it, you can now checkout your application at (default admin account is admin/<password given at deploy time>):

http://blog-$yourdomain.rhcloud.com

Once you visit the page you should see the djangoCMS default page. First things first, login to the django admin, and change the password from the default password to something secure. Then get started building your own app.

Helpful tips:

Viewing logs:

If you would like to view your logs to see what is going on with your application you just need to run this command.

$ rhc-tail-files -a blog

Application information:

If you would like more information about your application you can run this command.

$ rhc-user-info

Also checkout the README file they add when you create an application, it is pretty helpful, and might answer some common questions.

What type of apps do they support?

Here is the current link which can be found if you run this commands and look at the types.

$ rhc-create-app -h

raw-0.1, php-5.3, jbossas-7.0, rack-1.1, jenkins-1.4, perl-5.10, wsgi-3.2

What else does it support?

Things are changing all of the time, but if you run this command you will get a list of the current supported addons.

$ rhc-ctl-app -L

List of supported embedded cartridges:

Obtaining list of cartridges (please excuse the delay)...

    - metrics-0.1
    - mysql-5.1
    - jenkins-client-1.4
    - 10gen-mms-agent-0.1
    - phpmyadmin-3.4
    - rockmongo-1.1
    - mongodb-2.0

 

Source: http://kencochrane.net/blog/2012/01/installing-django-application-on-openshift/