diff options
| -rw-r--r-- | doc/ikiwiki.setup.sample | 29 | ||||
| -rw-r--r-- | website/mirrors.mdwn | 57 |
2 files changed, 86 insertions, 0 deletions
diff --git a/doc/ikiwiki.setup.sample b/doc/ikiwiki.setup.sample new file mode 100644 index 0000000..97e77c8 --- /dev/null +++ b/doc/ikiwiki.setup.sample @@ -0,0 +1,29 @@ +use IkiWiki::Setup::Standard { + wikiname => "Monkeysphere", + adminemail => 'webmaster@monkeysphere.info', + + srcdir => "/path/to/cloned/monkeysphere/repo/website", + destdir => "/path/to/web/dir", + + url => "http://monkeysphere.info", + + rcs => "git", + + wrappers => [ + { + wrapper => "/path/to/post-receive/hook", + wrappermode => "0755", + } + ], + + rss => 1, + atom => 1, + verbose => 0, + syslog => 0, + + add_plugins => [qw{goodstuff favicon toc sidebar}], + + + tagbase => "tags", + +} diff --git a/website/mirrors.mdwn b/website/mirrors.mdwn new file mode 100644 index 0000000..8445a26 --- /dev/null +++ b/website/mirrors.mdwn @@ -0,0 +1,57 @@ +[[meta title="Mirroring the web site"]] + +In keeping with the philosophy of distributed development, our web site is +stored in our git repositories and converted into html by +[ikiwiki](http://ikiwiki.info/). + +We're mirrored on several servers. Rather than using ikiwiki's [pinger/pingee +approach to distribution](http://ikiwiki.info/tips/distributed_wikis/), we've +opted for a method that uses ssh. + +The steps for creating a new mirror are: + + * Add etch-backports to your /etc/apt/sources.list: + deb http://www.backports.org/debian etch-backports main contrib non-free + * Add the following lines to your /etc/apt/preferences file: + Package: ikiwiki + Pin: release a=etch-backports + Pin-Priority: 999 + + # needed by ikiwiki + Package: libcgi-formbuilder-perl + Pin: release a=etch-backports + Pin-Priority: 999 + + Package: git-core + Pin: release a=etch-backports + Pin-Priority: 999 + * Install git-core and ikiwiki + aptitude update; aptitutde install git-core ikiwiki + * Create a new user. Change the new users shell to git-shell: + adduser -s /usr/bin/git-shell <username> + * Add webmaster@george's public key to this user's ~/.ssh/authorized_keys file + * Add web site configuration that the user has write access to. If you are using Apache, include the following rewrite: + RewriteEngine On + RewriteCond %{HTTP_HOST} !^(YOURHOSTNAME|web)\.monkeysphere\.info$ [NC] + RewriteCond %{HTTP_HOST} !^$ + RewriteRule ^/(.*) http://web.monkeysphere.info/$1 [L,R] + * Upload and edit ikiwiki.setup.sample from the docs directory + * As the new user, create two new git repos + mkdir monkeysphere.git; cd monkeysphere.git; git init --bare; cd ../ + git clone monkeysphere.git # this will create a second git repo called monkeysphere + * Change the mode of monkeysphere.git/hooks/post-receive to 755 + chmod 755 monkesphere.git/hooks/post-receive + * Edit the file so that it executes the post-receive hook ikiwiki generates (as you specified in the ikiwiki.setup file) + +The steps to be taken on the mirror site should now be complete. The following steps should be taken by a Monkeysphere admin user: + + * Add a new dns record for SERVERNAME.monkeysphere.info. + * Test the ssh connection by logging in as webmaster@george.riseup.net + * Add the new server as a remote on webmaster@george.riseup.net:monkeysphere.git + cd ~/monkeysphere.git + git add remote SERVERNAME USER@SERVERNAME.monkeysphere.info:/path/to/repo + * Test: + git pusch SERVERNAME + + + |