A shell script embedding in clojure
Clojure Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


pallet logo

Pallet is used to provision and maintain compute nodes, and aims to solve the problem of providing a consistently configured running image across a range of clouds. It is designed for use from the Clojure REPL, from clojure code, and from the command line.

It uses jclouds to gain portable access to different cloud providers. While jclouds solves the issue of creating, destroying and configuring cloud level access to nodes, it does not address the differences in images used across providers. This is what Pallet adds.

defnode is used to decalre node types, specifying the image template and possibly bootstrap and other configuration. The converge function can then be used to control the number of nodes of each type that are running in your cloud, and applies the declared configuration as required. The lift function can also be used to apply configuration without adjusting node counts. Both converge and lift accept inline definiton of configuration actions that should be run.

In pallet, low level resources can be combined in clojure functions, known as crates, that are used to specify configuration. Crates are clojure functions that have an initial request argument, and can call other crates, with arguments, as required. The request argument is used to carry the configuration request state, and is updated, and returned by each reasource function. The request map must be threaded through each resource or crate call.

Crates can be packaged and distributed as clojure jar files.

Some basic documentation is available.


See demo documentation.

There is an introductory screencast, showing a basic node configuration, and starting and stopping a node.


On the group, or #pallet on freenode irc.


Pallet is distributed as a jar, and is available in the clojars repository.

Installation is with Leiningen, maven, or your favourite maven repository aware build tool.


If you just want to try out pallet, then you can follow these instructions:

  • Download the tarfile or zipfile, and unpack.

  • Install Leiningen.

  • In a shell, go to the directory containing the pallet source code and enter

      $ lein deps
      $ lein repl

You should now have a working repl, which you can use to explore pallet. You might want to make the basic pallet commands available without namespace prefix by typing the following at the repl.

    user> (use 'pallet.repl)
user> (use-pallet)

See also

jclouds, chef, crane


Licensed under EPL


Copyright 2010 Hugo Duncan.