lisp-openshift

This package provides everything you need to start hosting Common Lisp-based web applications on OpenShift, Red Hat's free, auto-scaling Platform as a Service (PaaS) cloud solution.

The default app template uses SBCL and a quicklisp-based dev platform with the hunchentoot web server.

lisp-openshift will auto-provision a lisp environment into your DIY OpenShift project. It does this by downloading and extracting the contents of the SBCL RPM package from the Fedora Project's Extra Packages for Enterprise Linux (EPEL) repository. This package is installed in your application's persistent data directory.

Running on OpenShift

Create an account at http://openshift.redhat.com/

Install your command line tools as instructed at https://www.openshift.com/get-started#cli

Create a DIY application

rhc app create -a myapp -t diy-0.1

Add this upstream lisp-openshift repo

cd myapp
git remote add upstream -m master git://github.com/bigos/lisp-openshift.git
git pull -s recursive -X theirs upstream master

Set up quicklisp

download quicklisp

curl -O http://beta.quicklisp.org/quicklisp.lisp

install quicklisp

HOME=`pwd` sbcl --load quicklisp.lisp

and follow instructions at: http://www.quicklisp.org/beta/#installation

Install Hunchentoot

Start Lisp like this

HOME=`pwd` sbcl

When you see the Lisp prompt eval following

(ql:quickload :hunchentoot)

Add quicklisp files to git repo

git add .
git commit -am "installed Hunchentoot"

Then push the repo upstream

git push

That's it! You can now have a look at your application here:

http://myapp-$namespace.rhcloud.com

Using application's own Quicklisp

Quicklisp is a library manager for Common Lisp. This project contains a Quicklisp repository of core packages for simple web applications, however, the upstream Quicklisp project hosts over 700 libraries.

To install more libraries into your project's repository, simply set HOME to your application's current directory like this HOME=pwd sbcl and use ql:quickload as usual.

* (ql:quickload :cl-mongo)

This would add the cl-mongo package to your application.

Links

Happy hacking!

Anthony Green