For All the World to See: Deploying Haskell with Heroku

In several different articles now, we’ve explored how to build web apps using Haskell. See for instance, our and our series. But all this is meaningless in the end if we don’t have a way to deploy our code so that other people on the internet can find it! In this next series, we’ll explore how we can use common services to deploy Haskell code. It’ll involve a few more steps than code in more well-supported languages! Haskell Web Series API integrations If you’ve never programmed in Haskell at all, you’ve got a few things to learn before you start deploying code! Download our for tips on how to start learning! But maybe you’ve done some Haskell already, and need some more ideas for libraries to use. In that case, take a look at our for guidance! Beginners Checklist Production Checklist Deploying Code on Heroku In this article, we’re going to focus on using the service to deploy our code. Heroku allows us to do this with ease. We can get a quick prototype out for free, making it ideal for Hackathons. Like most platforms though, Heroku is easiest to use with more common languages. Heroku can automatically detect Javascript or Python apps and take the proper steps. Since Haskell isn’t used as much, we’ll need one extra specification to get Heroku support. Luckily, most of the hard work is already done for us. Heroku Buildpacks Heroku uses the concept of a “buildpack” to determine how to turn your project into runnable code. You’ll deploy your app by pushing your code to a remote repository. Then the buildpack will tell Heroku how to construct the executables you need. If you specify a Node.js project, Heroku will find your file and download everything from NPM. If it’s Python, Heroku will install and do the same thing. package.json pip Heroku does not have any default buildpacks for Haskell projects. However, there is a we can use (star this repository!). It will tell our Heroku container to download Stack, and then use Stack to build all our executables. So let’s see how we can build a rudimentary Haskell project using this process. buildpack on Github Creating Our Application We’ll need to start by making a free account on Heroku. Then we’ll download the Heroku CLI so we can connect from the terminal. Use the command and enter your credentials. heroku login Now we want to create our application. In your terminal, into the directory that has your Haskell Stack project. Make sure it’s also a Github repository already. It’s fine if the repository is only local for now. Run this command to create your application (replace with your desired app name): cd haskell-test-app heroku create haskell-test-app \ -b https://github.com/mfine/heroku-buildpack-stack The argument specifies our buildpack. We'll pull it from the specified Github repository. If this works, you should be able to go to your Heroku dashboard and see an entry for your new application. You’ll have a Heroku domain for your project that you can see on project settings. -b Now we need to make a Procfile. This tells Heroku the specific binary we need to run to start our web server. Make sure you have an executable in your file that starts up the server. Then in the , you’ll specify that executable under the name: .cabal Procfile web web: run-server Note though that you can’t use a hard-coded port! Heroku will choose a port for you. You can get it by retrieving the environment variable. Here’s what your code might look like: PORT runServer :: IO ()runServer = do port getEnv “PORT” Run port (serve myAPI myServer) Now you’ll need to “scale” the application to make sure it has at least a single machine to run on. From your repository, run the command: heroku ps:scale web=1 Finally, we need to push our application to the Heroku container. To do this, make sure Heroku added the remote Github repository. You can do this with the following command: heroku git remote -v It should show you two remotes named , one for fetch, and one for push. If those don’t exist, you can add them like so: heroku heroku git:remote -a haskell-test-app Then you can finish up by running this command: git push heroku master You should see terminal output indicating that Heroku recognizes your application. If you wait long enough, you’ll start to see the Stack build process. If you have any environment variables for your project, set them from the app dashboard. You can also set variables with the following command: heroku config:set VAR_NAME=var_value Once our app finishes building, you can visit the URL Heroku gives you. It should look like . You’ve now deployed your Haskell code to the cloud! https://your-app.herokuapp.com Weaknesses There are a few weaknesses to this system. The main one is that our entire build process takes place on the cloud. This might seem like an advantage, and it has its perks. Haskell applications can take a LONG time to compile though. This is especially true if the project is large and involves Template Haskell. Services like Heroku often have timeouts on their build process. So if compilation takes too long, the build will fail. Luckily, the containers will cache previous results. This means Stack won’t have to keep re-downloading all the libraries. So even if our first build times out, the second might succeed. Conclusion This concludes part 1 of our Haskell Deployment series. We’ll see the same themes quite a bit throughout this series. It’s definitely possible to deploy our Haskell code using common services. But we often have to do a little bit more work to do so. Next week, we’ll see how we can automate our deployment process by incorporating . Circle CI Want some more tips on developing web applications with Haskell? Download our to learn about some other libraries you can use! For a more detailed explanation of one approach, read our series. Production Checklist Haskell Web Skills