2015-02-28 18:19:27 +00:00
|
|
|
Propellor is a single system, but it's made up of some logically separate
|
|
|
|
|
components.
|
|
|
|
|
|
|
|
|
|
* Propellor is a Haskell library. The library can be installed
|
|
|
|
|
[from hackage](http://hackage.haskell.org/package/propellor)
|
|
|
|
|
in the usual ways. It complies with the
|
|
|
|
|
[[Haskell Package Version Policy|interface_stability]].
|
|
|
|
|
* `~/.propellor/` is a git repository, which contains at least your
|
|
|
|
|
`config.hs` file and a cabal file. This gets deployed to each machine
|
|
|
|
|
you manage with propellor, where it's installed as `/usr/local/propellor/`
|
|
|
|
|
* There can also be a propellor command in your PATH. If you `apt-get
|
|
|
|
|
install propellor`, you'll get one installed, or `cabal install propellor`
|
|
|
|
|
will put the command in `~/.cabal/bin/propellor`. This propellor command
|
|
|
|
|
is just a wrapper; it builds and runs what you have set up in `~/.propellor/`
|
|
|
|
|
|
2015-03-22 14:22:58 +00:00
|
|
|
## full .propellor repository
|
2015-03-22 14:21:52 +00:00
|
|
|
|
2015-02-28 18:19:27 +00:00
|
|
|
Typically, the `~/.propellor/` git repository is set up by running the
|
|
|
|
|
propellor command, or by [[cloning propellor|install]]. That makes
|
|
|
|
|
the repository contain the full source code to propellor, including
|
|
|
|
|
the Haskell library.
|
|
|
|
|
|
|
|
|
|
So if you want to, you can edit any part of Propellor's source code.
|
|
|
|
|
Don't like how a property works, or need to make it more general? Just edit
|
|
|
|
|
then copy in `~/.propellor/src/Propellor/` and it will be used. See
|
|
|
|
|
[[contributing]] if you want to send your improvements back.
|
|
|
|
|
|
2015-03-22 14:22:58 +00:00
|
|
|
## minimal .propellor repository
|
2015-03-22 14:21:52 +00:00
|
|
|
|
2015-02-28 18:19:27 +00:00
|
|
|
All that really needs to be in `~/.propellor/` though, is a `config.hs`
|
2015-03-22 14:04:02 +00:00
|
|
|
file, and a cabal file. To use propellor this way, you can first
|
|
|
|
|
install propellor, and then copy the two files from the
|
|
|
|
|
[mininalconfig branch](http://source.propellor.branchable.com/?p=source.git;a=tree;h=refs/heads/minimalconfig;hb=refs/heads/minimalconfig),
|
|
|
|
|
or clone it:
|
2015-02-28 18:19:27 +00:00
|
|
|
|
2015-03-22 14:04:02 +00:00
|
|
|
git clone ssh://b-propellor@propellor.branchable.com/propellor.branchable.com .propellor --branch minimalconfig --single-branch
|
2015-03-22 14:32:54 +00:00
|
|
|
|
2015-03-22 14:33:17 +00:00
|
|
|
In this configuration, when propellor is deploying itself to a new host,
|
2015-03-22 14:32:54 +00:00
|
|
|
it will automatically install the version of the propellor library
|
|
|
|
|
specified in the cabal file.
|
