From 7cb414b3146fff486fd1d1a2c08199218338a0a9 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Sat, 19 Apr 2014 16:44:17 -0400 Subject: tweak --- doc/README.mdwn | 30 ++++++++++++++---------------- 1 file changed, 14 insertions(+), 16 deletions(-) diff --git a/doc/README.mdwn b/doc/README.mdwn index 455741f6..f463cfa5 100644 --- a/doc/README.mdwn +++ b/doc/README.mdwn @@ -1,27 +1,25 @@ -This is a configuration management system using Haskell and Git. - -[Propellor](https://propellor.branchable.com/) enures that the system it's -run against satisfies a list of properties, taking action as necessary when -a property is not yet met. +[Propellor](https://propellor.branchable.com/) is a +configuration management system using Haskell and Git. +Each system has a list of properties, which Propellor ensures +are satisfied. Propellor is configured via a git repository, which typically lives -in ~/.propellor/. The git repository contains a config.hs file, -and also the entire source code to propellor. +in `~/.propellor/` on your development machine. Propellor clones the +repository to each host it manages, in a [[secure|security]] way. -You typically want to have the repository checked out on a laptop, in order -to make changes and push them out to hosts. Each host will also have a -clone of the repository, and in that clone "make" can be used to build and -run propellor. This can be done by a cron job (which propellor can set up), -or a remote host can be triggered to update by running propellor on your -laptop: propellor --spin $host +To trigger propellor to run on a host, run `propellor --spin $host`. +Or run `/usr/local/propellor/propellor` on the host. Or use the +[runPropellor property](http://hackage.haskell.org/package/propellor-0.4.0/docs/Propellor-Property-Cron.html) +to have Propellor set up a cron job. -Properties are defined using Haskell. Edit config.hs to get started. -For API documentation, see +Properties are defined using Haskell. Edit `~/.propellor/config.hs` +to get started. There is fairly complete +[API documentation](http://hackage.haskell.org/package/propellor/). There is no special language as used in puppet, chef, ansible, etc.. just the full power of Haskell. Hopefully that power can be put to good use in making declarative properties that are powerful, nicely idempotent, and -easy to adapt to a system's special needs. +easy to adapt to a system's special needs! ## quick start -- cgit v1.2.3