aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKamil Cholewiński <harry666t@gmail.com>2015-11-22 16:54:15 +0100
committerKamil Cholewiński <harry666t@gmail.com>2015-11-22 16:54:15 +0100
commitec21dde4f95c8d6f36c785eaba95ec854acc3371 (patch)
tree6f3c7cb80408fa3dd24d0c32bfa562d3255fd260
parent2b5c924a3483685ff6eb704679fb3e9723f05f51 (diff)
downloadcookbook-ec21dde4f95c8d6f36c785eaba95ec854acc3371.zip
cookbook-ec21dde4f95c8d6f36c785eaba95ec854acc3371.tar.gz
cookbook-ec21dde4f95c8d6f36c785eaba95ec854acc3371.tar.bz2
le docs
-rw-r--r--docs/git-hosting.md45
-rw-r--r--docs/rtfm.md15
-rw-r--r--readme.md9
3 files changed, 65 insertions, 4 deletions
diff --git a/docs/git-hosting.md b/docs/git-hosting.md
new file mode 100644
index 0000000..4cb9e95
--- /dev/null
+++ b/docs/git-hosting.md
@@ -0,0 +1,45 @@
+# Git hosting with `gitolite` and `cgit`
+
+## RTFM
+
+- cgit: <http://git.zx2c4.com/cgit/tree/README>
+- gitolite: <http://gitolite.com/gitolite/gitolite.html>
+
+## Example `gitolite.conf`
+
+Since `gitolite.conf` is normally managed through the special
+`gitolite-admin` repository, it would be a bad idea for Ansible to try
+overwriting it. The contents should be specific to the site.
+
+Here's a nice example that works quite well for `git.rollc.at`:
+
+```
+# Define who's who
+@staff = alice bob
+@pub = charlie diana
+@devs = alice charlie eric
+
+# Only staff can mess with the config
+repo gitolite-admin
+ RW+ = @staff
+
+# Let charlie and diana create their own public repos of the form:
+# git@git.example.com:pub/charlie/myproject
+# Further explanation:
+# R = ... gitweb # include the repository in cgit's list
+# config core.sharedRepository = true # make readable by group (httpd)
+repo pub/CREATOR/[a-z].*
+ C = @staff @pub
+ RW+ = CREATOR
+ RW = WRITERS
+ R = READERS @all gitweb
+ config core.sharedRepository = true
+
+# Let anyone create their own private repos of the form:
+# git@git.example.com:priv/eric/myproject
+repo priv/CREATOR/[a-z].*
+ C = @all
+ RW+ = CREATOR
+ RW = WRITERS
+ R = READERS
+```
diff --git a/docs/rtfm.md b/docs/rtfm.md
new file mode 100644
index 0000000..fe76060
--- /dev/null
+++ b/docs/rtfm.md
@@ -0,0 +1,15 @@
+# Various RTFM's
+
+- cgit: <http://git.zx2c4.com/cgit/tree/README>
+- etckeeper: <https://etckeeper.branchable.com/README/>
+- fail2ban: <http://www.fail2ban.org/wiki/index.php/MANUAL_0_8>
+- ferm: <http://ferm.foo-projects.org/download/2.2/ferm.html>
+- gitolite: <http://gitolite.com/gitolite/gitolite.html>
+- libressl: <http://www.libressl.org/>
+- munin: <http://munin-monitoring.org/wiki/Documentation>
+- nginx: <http://nginx.org/en/docs/>
+- ngircd: <http://ngircd.barton.de/documentation.php.en>
+- openssh: <http://www.openbsd.org/openssh/>
+- openssl: <https://www.openssl.org/docs/manmaster/apps/>
+- rkhunter: <http://rkhunter.sourceforge.net/>
+- znc: <http://wiki.znc.in/ZNC#Getting_started>
diff --git a/readme.md b/readme.md
index bfc78a1..db3b236 100644
--- a/readme.md
+++ b/readme.md
@@ -26,10 +26,11 @@ Cook with kittens!
## Best dishes
-- [Basic setup for all managed boxes](/site-managed.yml)
-- [Set up your workstations](site-workstations.yml)
-- [Deploy stuff on servers](/site-servers.yml)
-- [Perform routine maintenance](/site-maintenance.yml)
+- Basic setup for all managed boxes: `site-managed.yml`
+- Set up your workstations: `site-workstations.yml`
+- Deploy stuff on servers: `site-servers.yml`
+- Perform routine maintenance: `site-maintenance.yml`
+- Chef's notes: `docs`
## No additives