heroku-grunt

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 18 Open GitHub ↗

Details the creation of an application that can be hosted on Heroku and built with Grunt

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# _Build First_, Deploy, Build Again

[![heroku.jpg][1]][2]

_This repository is part of the **JavaScript Application Design: A Build First Approach** book's code samples_, the full original for the code samples [can be found here][3]. You can [learn more about the book itself here][4].

This tutorial is part of the code samples accompanying the book [in _Chapter 4_][5], about the release flow, deployments, and hosted application monitoring.

Back in [**ch04e05** Heroku Deployments][6] we learned how to install, create, configure, and deploy to a environment hosted on the Heroku platform. We've left out a particularly important piece of information though. How are we supposed to get a Grunt build on our Heroku environment?

### Heroku and Grunt Builds

Where is the result of our Grunt build _supposed to go_? Should we _check in_ build results to source control? Should we add a `grunt build` step to our **Procfile**? The answer lies in [Heroku Buildpacks][7], as explained [in the book][4].

In this case, we will use the [heroku-buildpack-nodejs-grunt][8], which helps us run Grunt builds on the Heroku platform. Buildpacks are glorified bundles of shell scripts which Heroku uses to as an interface to compile all sorts of applications.

Mostly, the buildpack lets us keep our Grunt dependencies in `devDependencies` like we've been doing. We wouldn't be able to do this using the default Heroku build pack for Node.js, as it currently runs `npm install --production`, omitting the modules in `devDependencies`. We want to keep them in `devDependencies` because they're not really part of the running application, but merely a part of the build.

### Stepping Through

In this sample I'll just be running a JSHint task for simplicity's sake, but we _could use this same setup to compile Jade templates_, for example, and the files would still live in the environment.

If you don't have an account on Heroku, the Toolbelt, haven't log on or didn't yet upload an RSA key, make sure to check out the previous example, [**ch04e05** Heroku Deployments][9], you'll need to do those things to be able to follow through with this tutorial.

![heroku-auth.png][10]

## Create the Heroku Application

Next up we need to create a Heroku app, using the special buildpack we've been talking about.

```shell
heroku create thing --buildpack https://github.com/mbuchetics/heroku-buildpack-nodejs-grunt.git
```

![heroku-create-buildpack.png][11]

## Deploying stays the same

```shell
git push heroku master
```

![heroku-deploy.png][12]

But suddenly, _**a wild Grunt build appears**_! The `heroku` Grunt task alias will be invoked. In this case, we've aliased it to `['jshint']`. These were taken _before setting options for the linter_, to use the `"node"` profile.

![heroku-jshint.png][13]

Note that if the build fails, **the deployment won't go through**.

That's all that we need to do in order to run Grunt builds on Heroku!

[1]: http://i.imgur.com/0IbfRuR.jpg
  [2]: https://www.heroku.com/ "Heroku Platform"
  [3]: https://github.com/bevacqua/buildfirst
  [4]: http://bevacqua.io/buildfirst "JavaScript Application Design: A Build First Approach"
  [5]: https://github.com/bevacqua/buildfirst/tree/master/ch04
  [6]: https://github.com/bevacqua/buildfirst/tree/master/ch04/05_heroku-deployments "Heroku Deployments"
  [7]: https://devcenter.heroku.com/articles/buildpacks
  [8]: https://github.com/mbuchetics/heroku-buildpack-nodejs-grunt "mbuchetics/heroku-buildpack-nodejs-grunt on GitHub"
  [9]: https://github.com/bevacqua/buildfirst/tree/master/ch04/05_heroku-deployments "Heroku Deployments"
  [10]: http://i.imgur.com/xKEeGDv.png "Authenticating with Heroku CLI"
  [11]: http://i.imgur.com/cxyvlBr.png "Creating an application with a buildpack"
  [12]: http://i.imgur.com/KWABxcp.png "Deploying to Heroku"
  [13]: http://i.imgur.com/6iU2wOq.png "Linting in Heroku"

heroku-grunt

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README