diff options
Diffstat (limited to 'docs/management.md')
-rw-r--r-- | docs/management.md | 34 |
1 files changed, 34 insertions, 0 deletions
diff --git a/docs/management.md b/docs/management.md new file mode 100644 index 0000000..350111e --- /dev/null +++ b/docs/management.md @@ -0,0 +1,34 @@ +# Management + +## Sets and supersets + +The Hydra Suite is flexible enough so you can use it to: + +* Manage a single machine using `hydractl` command. +* Manage a set or a subset of machines -- a *network* -- from the same + organization using `hydra` command. +* Manage a superset of machines -- *a constelation* -- comprised of one or more + organizations using `hydras` command. + +## Creating a new network + +Use the following commands to create the needed repositories when starting a +new network: + + hydra example init ~/file/example + hydra example config domain example.org + +This makes `~/files/example` the base folder for all configuration of the +network of machines called `example`. + +## Managing an existing network + +If you have enough credentials (ssh pubkey set in the server), you can fetch +all the needed repositories and configurations to a local folder +`~/file/example` using simply the following command: + + hydra example init ~/file/example git@admin.example.org: + +This will try to fetch a superproject from git@admin.example.org:example.git +-- if exists, plus submodules -- or each git repository used by a network +previously created by the `init` action (`config.git`, `puppet.git`, etc). |