Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Automates controlling and provisioning cloud server instances. DevOps for the JVM.
Clojure Shell Other
branch: pallet-0.3

This branch is 54 commits ahead, 1805 commits behind develop

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
assembly
bin
doc
examples
pallet/src/server
resources
src
test
.gitignore
ChangeLog
README.md
epl-v10.html
pom.xml

README.md

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.

Usage

See demo documentation.

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

Support

On the group, or #pallet on freenode irc.

Installation

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.

Quickstart

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

License

Licensed under EPL

Contributors

Copyright 2010 Hugo Duncan.

Something went wrong with that request. Please try again.