yogsototh/leiningen
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Tweaks to the tutorial.

Browse source 
[ci skip]
This commit is contained in:
Phil Hagelberg 2012-07-11 22:05:19 -07:00
parent 066b557e97
commit f6976823b8
1 changed files with 34 additions and 21 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

55
doc/TUTORIAL.md
View file

@ -254,8 +254,9 @@ Of course, we haven't written any tests yet, so we've just got the
skeleton failing tests that Leiningen gave us with `lein new`. But skeleton failing tests that Leiningen gave us with `lein new`. But
once we fill it in the test suite will become more useful. Sometimes once we fill it in the test suite will become more useful. Sometimes
if you've got a large test suite you'll want to run just one or two if you've got a large test suite you'll want to run just one or two
namespaces at a time. You also might want to break up your tests using namespaces at a time; `lein test my.test.stuff` will do that.. You
test selectors; see `lein help test` for more details. also might want to break up your tests using test selectors; see `lein
help test` for more details.
Running `lein test` from the command-line is suitable for regression Running `lein test` from the command-line is suitable for regression
testing, but the slow startup time of the JVM makes it a poor fit for testing, but the slow startup time of the JVM makes it a poor fit for
@ -285,7 +286,8 @@ of Leiningen projects:
For the first, you typically build an uberjar. For libraries, For the first, you typically build an uberjar. For libraries,
you will want to have them published to a repository like Clojars or a you will want to have them published to a repository like Clojars or a
private repository. For server-side applications it varies as private repository. For server-side applications it varies as
described below. described below. Generating a project with `lein new app myapp` will
start you out with a few extra defaults suitable for non-library projects.
### Uberjar ### Uberjar
@ -354,31 +356,42 @@ instruct them to use `lein run` as described above.
### Server-side Projects ### Server-side Projects
There are many ways to get your project deployed as a server-side There are many ways to get your project deployed as a server-side
application. Aside from the obvious `lein run` approach, simple application. Aside from the obvious uberjar approach, simple
programs can be packaged up as tarballs with accompanied shell scripts programs can be packaged up as tarballs with accompanied shell scripts
using the [lein-tar plugin](https://github.com/technomancy/lein-tar) using the [lein-tar plugin](https://github.com/technomancy/lein-tar)
and then deployed using and then deployed using
[pallet](http://hugoduncan.github.com/pallet/), [pallet](http://hugoduncan.github.com/pallet/),
[chef](http://opscode.com/chef/), or other mechanisms. Debian packages [chef](http://opscode.com/chef/), or other mechanisms. Debian packages
can be created with [lein-deb](https://github.com/travis/lein-deb). can be created with [lein-deb](https://github.com/travis/lein-deb).
Web applications may be deployed using .war (web application archive) Web applications may be deployed as uberjars using embedded Jetty with
files created by the `ring-jetty-adapter` or as .war (web application archive) files
[lein-ring plugin](https://github.com/weavejester/lein-ring). You can created by the
even create [lein-ring plugin](https://github.com/weavejester/lein-ring). For
[Hadoop projects](https://github.com/ndimiduk/lein-hadoop). These things beyond uberjars, server-side deployments are so varied that they
kinds of deployments are so varied that they are better-handled using are better-handled using plugins rather than tasks that are built-in
plugins rather than tasks that are built-in to Leiningen itself. to Leiningen itself.
If you do end up involving Leiningen in production, it's very If you do end up involving Leiningen in production via something like
important to ensure you take steps to freeze all the dependencies `lein trampoline run`, it's very important to ensure you take steps to
before deploying, otherwise it could be easy to end up with freeze all the dependencies before deploying, otherwise it could be
easy to end up with
[unrepeatable deployments](https://github.com/technomancy/leiningen/wiki/Repeatability). [unrepeatable deployments](https://github.com/technomancy/leiningen/wiki/Repeatability).
It's recommended to use Leiningen to create a deployable artifact in a Consider including `~/.m2/repository` in your unit of deployment along
continuous integration setting. For example, you could have a with your project code. It's recommended to use Leiningen to create a
[Jenkins](http://jenkins-ci.org) CI server run your project's full deployable artifact in a continuous integration setting. For example,
test suite, and if it passes, upload a tarball to S3. Then deployment you could have a [Jenkins](http://jenkins-ci.org) CI server run your
is just a matter of pulling down and extracting the known-good tarball project's full test suite, and if it passes, upload a tarball to S3.
on your production servers. Then deployment is just a matter of pulling down and extracting the
known-good tarball on your production servers. Over time this could
cause unused dependencies to accumulate in the local repo, bloating up
deploy artifact size, which the
[lein-clean-m2](https://github.com/technomancy/lein-clean-m2) plugin
can help with.
Also remember that the `run` task defaults to including the `user`, `dev`,
and `default` profiles, which are not suitable for production. Using
`lein trampoline with-profile production run -m myapp.main` is
recommended.
### Publishing Libraries ### Publishing Libraries
@ -416,7 +429,7 @@ projects may depend. For instructions on storing your credentials so
they don't have to be re-entered every time, see `lein help deploying`. they don't have to be re-entered every time, see `lein help deploying`.
For further details about publishing including setting up private For further details about publishing including setting up private
repositories, see the repositories, see the
[deploy guide](https://github.com/technomancy/leiningen/blob/preview/doc/DEPLOY.md) [deploy guide](https://github.com/technomancy/leiningen/blob/preview/doc/DEPLOY.md).
## That's It! ## That's It!