cadey
/
propellor
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Merge branch 'joeyconfig'

This commit is contained in:
Joey Hess 2014-04-19 16:44:17 -04:00
parent 730a94a839 7cb414b314
commit 8834a8ff3c
1 changed files with 14 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
doc/README.mdwn
View File

@ -1,27 +1,25 @@
This is a configuration management system using Haskell and Git. [Propellor](https://propellor.branchable.com/) is a
configuration management system using Haskell and Git.
[Propellor](https://propellor.branchable.com/) enures that the system it's Each system has a list of properties, which Propellor ensures
run against satisfies a list of properties, taking action as necessary when are satisfied.
a property is not yet met.
Propellor is configured via a git repository, which typically lives Propellor is configured via a git repository, which typically lives
in ~/.propellor/. The git repository contains a config.hs file, in `~/.propellor/` on your development machine. Propellor clones the
and also the entire source code to propellor. 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 trigger propellor to run on a host, run `propellor --spin $host`.
to make changes and push them out to hosts. Each host will also have a Or run `/usr/local/propellor/propellor` on the host. Or use the
clone of the repository, and in that clone "make" can be used to build and [runPropellor property](http://hackage.haskell.org/package/propellor-0.4.0/docs/Propellor-Property-Cron.html)
run propellor. This can be done by a cron job (which propellor can set up), to have Propellor set up a cron job.
or a remote host can be triggered to update by running propellor on your
laptop: propellor --spin $host
Properties are defined using Haskell. Edit config.hs to get started. Properties are defined using Haskell. Edit `~/.propellor/config.hs`
For API documentation, see <http://hackage.haskell.org/package/propellor/> 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 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 the full power of Haskell. Hopefully that power can be put to good use in
making declarative properties that are powerful, nicely idempotent, and 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 ## quick start