After some serious Google searches on that topic I decided to gather all the information I found in one place. This quick tutorial will cover how to write OCaml server and how to deploy it on Heroku.
heroku create magnetic-mad-kangaroo
You can come up with some other fancy name, if not here’s a helper.
You just got a fresh url to the app and you can see a temporary Heroku landing page after you head to the url.
The code below is the proof of concept of how the OCaml server should look like.
open Lwt open Cohttp open Cohttp_lwt_unix let server = let callback _conn req body = body |> Cohttp_lwt.Body.to_string >|= (fun body -> Printf.sprintf "Hello! %s" body) >>= (fun body ->Server.respond_string ~status:`OK ~body ()) in Server.create ~mode:(`TCP (`Port 8000)) (Server.make ~callback ()) let () = ignore (Lwt_main.run server)
- Cohttp — an OCaml library for HTTP clients and servers.
- Lwt — helper for handling IO operations
- Cohttp lwt unix — HTTP client and server using the Lwt_unix interfaces
And can compile it and start the server with:
ocamlbuild -pkg cohttp-lwt-unix main.native ./main.native
Cohttp lwt unix package requires OCaml version ≥ 4.03 but you can easily switch between versions with opam switch version . To list all avaliable compilers you can type opam switch list --all .
But.. since Heroku is using Linux it’s not going to work if you compiled you code on another operating system. And since I’m not aware of any OCaml cross-compilers when target platform is Linux, I recommend using Vagrant or Docker for compiling OCaml server in order to not spend all night doing it as I just did.
One way of deploying app on Heroku is to push to a remote repository. But in our case it will fail as Heroku will try to detect what kind of project this is and it found out that OCaml isn’t any of the default languages. For other languages, ex. Ruby it would look for a Gemfile and then invokes the correct buildpack, a script that installs the dependencies and can take extra steps, like preprocess some code and so on. In case of OCaml we will generate a binary and deploy it, using null buildpack , which means that the only thing Heroku would have to do after it receives an executable file will be running it.
heroku buildpacks:set [http://github.com/ryandotsmith/null-buildpack.git](http://github.com/ryandotsmith/null-buildpack.git) --app magnetic-mad-kangaroo
The last step is to build and deploy our app on Heroku with heroku-builds.
To install it we have to type:
heroku plugins:install heroku-builds
We also need to create Procfile so that Heroku will know what it has to run.
And finally we can deploy our app:
heroku builds:create --app magnetic-mad-kangaroo
Then we can make some test to confirm it works:
curl -X GET [https://magnetic-mad-kangaroo.herokuapp.com/](https://magnetic-mad-kangaroo.herokuapp.com/)
If you come across any issues, you can always run heroku logs to troubleshoot.