pallet / dovecot-crate

Repository · Issues · API docs · Annotated source · Release Notes

A pallet crate to install and configure dovecot.

Dependency Information

:dependencies [[com.palletops/dovecot-crate "0.8.0-SNAPSHOT"]]

Releases

Pallet	Crate Version	Repo	GroupId
0.8.0-RC.1	0.8.0-SNAPSHOT	clojars	com.palletops	Release Notes	Source

Usage

The dovecot crate provides a server-spec function that returns a server-spec. This server spec will install and run the dovecot server (not the dashboard). You pass a map of options to configure dovecot. The :config value should be a form that will be output as the dovecot configuration.

The server-spec provides an easy way of using the crate functions, and you can use the following crate functions directly if you need to.

The settings function provides a plan function that should be called in the :settings phase. The function puts the configuration options into the pallet session, where they can be found by the other crate functions, or by other crates wanting to interact with the dovecot server. The settings are made up of a :master key, with a value as a sequence of maps, each specifying a daemon as specified in master.cnf.

The :supervision key in the settings allows running dovecot under :runit, :upstart or :nohup.

The install function is responsible for actually installing dovecot. At present installation from tarball url is the only supported method. Installation from deb or rpm url would be nice to add, as these are now available from the dovecot site.

The configure function writes the dovecot configuration file, using the form passed to the :config key in the settings function.

The run function starts the dovecot server.

Live test on vmfest

For example, to run the live test on VMFest, using Ubuntu 12.04:

lein with-profile +vmfest pallet up --selectors ubuntu-12-04 --phases install,configure,test
lein with-profile +vmfest pallet down --selectors ubuntu-12-04

License

Copyright (C) 2012, 2013 Hugo Duncan

Distributed under the Eclipse Public License.