Re: Evolution Express - the conclusion ...

[Olav Vitters <olav vitters nl>]

On Fri, Apr 09, 2010 at 11:12:29AM -0500, Paul Cutler wrote:
> On Fri, 2010-04-09 at 14:44 +0100, Michael Meeks wrote:
> > 	* api.gnome.org is the right place to host this data

> * We'll need the git repo set up (let's call it api-web for example)
> * You get a checkout in .../git-wd/ then the hook runs a command,
> typically ./autogen.sh ; make install
> * Then a cron job executes bin/update_sites.py
> * /usr/local/www/gnomeweb/etc/website-triggers is the configuration file
> and can have api-web added

As a guide for the new sysadmins:

First off: Git module has to be created by a sysadmin, due to existing
content on api.gnome.org.


Steps (minimal):
* Download /usr/local/www/api.gnome.org @ window to ~/tmp/api-web.tar @ home
@home:
* mkdir ~/src/api-web; cd ~/src/api-web
* tar xf ~/tmp/api-web.tar
* cp ../library-web/library-web.doap api-web.doap
* vim api-web.doap
* git init
* git add .
* git commit
As per http://live.gnome.org/Git/NewRepository:
* ssh git.gnome.org create-repository api-web
* git push --exec=import ssh://git.gnome.org/git/api-web refs/heads/* refs/tags/*
* ssh git.gnome.org finish-import api-web
then:
* cd ..
* rm -rf api-web
* git clone gnome:api-web
@git
* cd /git/api-web.git
* git config hooks.update-recipients gnomeweb www gnome org
@window
* sudo -s -u root -H
* mkdir /usr/local/www/api-web
* chown gnomeweb:gnomeweb /usr/local/www/api-web
* vim ~gnomeweb/etc/website-triggers
  Add the following:
  [api-web]
  url=http://api.gnome.org/
  owner=gnome-web-list gnome org
  order=A000
* cp ~gnomeweb/hooks/art-web ~/gnomeweb/hooks/api-web
* vim ~/gnomeweb/hooks/api-web
  Change rsync line to read:
  rsync --archive  --delete --exclude=api-web.doap --exclude=.git . /usr/local/www/api-web

  Note: the website-triggers could also directly refer to
  /usr/local/www/api-web, but that means publically exposing .git and
  the api-web.doap file.

If you paid close attention you'll notice that I changed
/usr/local/www/api.gnome.org to /usr/local/www/api-web. If not in a
repository, I prefer the site name, now we have a Git repository, I
prefer the git repository name. I changed the Apache config to match and
also fixed the config a bit (logged to foundation.gnome.org instead of
api.gnome.org).

There are explanations on the website trigger scripts somewhere. Not
telling where, if it is too hard it is up to you to add better links to
it.

Lastly, I am not a Git expert, above works for me (the rm -rf + git
clone bits:).

-- 
Regards,
Olav