https://github.com/agrison/hello-clj-clever-cloud

Sample clojure app running on clever-cloud
https://github.com/agrison/hello-clj-clever-cloud

Last synced: 8 months ago
JSON representation

Sample clojure app running on clever-cloud

• Host: GitHub
• URL: https://github.com/agrison/hello-clj-clever-cloud
• Owner: agrison
• Created: 2016-06-24T08:05:02.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2016-06-24T11:20:34.000Z (almost 10 years ago)
• Last Synced: 2025-03-06T10:43:04.997Z (over 1 year ago)
• Language: Clojure
• Size: 8.67 MB
• Stars: 0
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Sample Clojure webapp running on clever-cloud

## Why?

There is no official `clojure` & `leiningen` support at the moment on clever-cloud, even if I'm sure that this is totally on track? 😃.

But it's really easy to achieve it by building locally (or Jenkins or whatever) and using the [JAR deployement support of clever-cloud](https://www.clever-cloud.com/doc/java/java-jar/).

## Prerequisites

You will need Java and Leiningen installed on your machine, but if you are already a fan of Clojure, you got this covered.

## Create the application

### Bootstrap

    lein compojure new app

### Edit the app

Then just for fun, bump some versions, in order to use bleeding edge state-of-the-art fully unicorn-approved awesome technology.

Edit **project.clj**:

```clojure

(defproject app "0.1.0-SNAPSHOT"

  :description "FIXME: write description"

  :url "http://example.com/FIXME"

  :min-lein-version "2.0.0"

  :dependencies [[org.clojure/clojure "1.9.0-alpha5"]

                 [compojure "1.5.1"]      

                 [ring/ring-defaults "0.2.1"]

                 [ring/ring-jetty-adapter "1.5.0"]   

                 [ring "1.5.0"]]                     

  :plugins [[lein-ring "0.9.7"]]

  :ring {:handler app.handler/app}

  :profiles

  {:dev {:dependencies [[javax.servlet/servlet-api "2.5"]

                        [ring/ring-mock "0.3.0"]]}}

  :main app.handler)

```

We will need a standalone JAR, in order to do that, our `handler` namespace needs to generate a Java class using `(:gen-class)` and we need a `main` method that starts jetty on port `8080` (default port for a clever-cloud application).

Edit **src/app/handler.clj**:

```clojure

(ns app.handler

  (:gen-class)

  (:require [compojure.core :refer :all]

            [compojure.route :as route]

            [compojure.handler :as handler]

            [ring.adapter.jetty :as jetty]]))

(defroutes app-routes

  (GET "/" [] "Hello World")

  (route/not-found "Not Found"))

(def app

  (handler/site app-routes))

(defn -main [& args]

  (jetty/run-jetty app {:port 8080}))

```

### clever-cloud specifics

As explained on the clever-cloud docs regarding JAR deployment, add a `jar.json` file to the `clevercloud/` directory:

    cat < clevercloud/jar.json

    {

      "deploy": {

        "jarName": "target/app-0.1.0-SNAPSHOT-standalone.jar"

      }

    }

    EOF

That way, clever-cloud knows what JAR to deploy & run.

### That's it

Yes, that's all there is to it.

## Build

    lein uberjar

    # add the jar to repository

    git add -f target/app-0.1.0-SNAPSHOT-standalone.jar

    git push -u origin master

## clever-cloud

Go sign-in or create an account on [clever-cloud](https://clever-cloud.com) then load your personal dashbord.

### Add an application

![](tutorial/1-add-application.png)

### Create an application from a Github repository

![](tutorial/2-add-github-application.png)

### Select `Java + Maven`

![](tutorial/3-select-java-maven.png)

Newly created java applications run on java 8 by default.

You can set the java version with the `JAVA_VERSION` environment variable.

### Edit the instance (if you want)

By default it will select an XS instance, for such a hello world application, I will select a pico instance.

Click the **EDIT** button:

![](tutorial/4-edit-instance.png)

Click the **pico** circle button, then **NEXT**:

![](tutorial/5-select-pico.png)

### Create the application

Click the **CREATE** button:

![](tutorial/6-click-create.png)

### Select your addons

For this simple hello world app I click **I DON'T NEED ANY ADD-ON**:

![](tutorial/7-no-addon.png)

### Start the application

Click the play button under **This app is currently stopped**:

![](tutorial/8-start-app.png)

Then click the **read logs** link above that pretty little orange circle:

![](tutorial/9-read-logs.png)

### Wait for the build to success

![](tutorial/10-build-success.png)

### Wait for the app to deploy

![](tutorial/11-deploy-success.png)

### Check that the application is UP

If you can see that little comforting green circle:

![](tutorial/12-app-is-up.png)

### Open the application

Click that **Open the application** button:

![](tutorial/13-open-app.png)

### Profit!

You're awesome.

![](tutorial/14-profit.png)

## Downside

- The uberjar can become large.

- You have to build locally and push that artifact.

Hopefully clever-cloud will support clojure and leiningen soon enough? 😃

## Disclaimer

I'm not at all affiliated with clever-cloud even if I find [@waxzce](https://twitter.com/waxzce), [@clementd](https://twitter.com/clementd) and the rest of the clever-cloud team totally awesome for what they have built so far 😎