Subversion/Hooks: Unterschied zwischen den Versionen

Aus schokokeks.org Wiki
Zur Navigation springen Zur Suche springen
(Part zu Jabber hinzugefügt)
K (typo)
 
(3 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
==Wozu?==
Subversion-Hooks lassen sich dazu verwenden, Benutzern über Jabber oder Mail über Veränderungen in Repositories zu informieren. ''Hooks'' sind allgemein gesprochen Einstiegspunkte, die eine bestimmte Software bietet.
Subversion-Hooks lassen sich dazu verwenden, Benutzern über Jabber oder Mail über Veränderungen in Repositories zu informieren. ''Hooks'' sind allgemein gesprochen Einstiegspunkte, die eine bestimmte Software bietet.  


==Implementation==
=Implementation=
Das zentrale Script ''commit-notification.rb'' ist, wie man unschwer an der Dateiendung erkennt, ein Ruby-Script. Es versteht die vier Argumente ''-r'' (''--revision''), ''-d'' (''--repos''), ''-c'' (''--config''), ''-u'' (''--user'') und ''-p'' (''--password''). Die Parameter sind mandatory, sprich: ohne sie funktioniert es es nicht. Der verwendete Hook ''post-commit'' wird in der Datei ''/path/to/repository/hooks/post-commit'' spezifiziert und muss folgenden Inhalt haben:
 
<pre>#! /bin/sh
Das zentrale Script ''commit-notification.rb'' ist, wie man unschwer an der Dateiendung erkennt, ein Ruby-Script. Es versteht die vier Argumente ''-r'' (''--revision''), ''-d'' (''--repos''), ''-c'' (''--config''), ''-u'' (''--user'') und ''-p'' (''--password''). Die Parameter sind zwingend notwendig, ohne sie funktioniert es nicht. Der verwendete Hook ''post-commit'' wird in der Datei ''/path/to/repository/hooks/post-commit'' spezifiziert und muss folgenden Inhalt haben:
REPOS="$1"
#! /bin/sh
REV="$2"
REPOS="$1"
/usr/local/bin/subversion/commit-notification.rb \
REV="$2"
  --revision "$REV" \
/usr/local/bin/subversion/commit-notification.rb \
  --repos "$REPOS" \
    --revision "$REV" \
  --config /home/user/path/to/file.ini \
    --repos "$REPOS" \
  --user 'jabberuser' \
    --config /home/user/path/to/file.ini \
  --password 'jabbersecret'</pre>
    --user 'jabberuser' \
    --password 'jabbersecret'
 
=Jabber=


==Jabber==
Damit Nachrichten per Jabber versandt werden können, muss man dem Script sowohl den Benutzer als auch das Passwort mitgeben. Der Benutzer wird im Format ''username@server.com/Resource'' angegeben. Man kann dazu entweder einen existierenden Benutzer angeben oder auch einen neuen registrieren. Letzteres sollte mit den Administratoren abgesprochen werden.
Damit Nachrichten per Jabber versandt werden können, muss man dem Script sowohl den Benutzer als auch das Passwort mitgeben. Der Benutzer wird im Format ''username@server.com/Resource'' angegeben. Man kann dazu entweder einen existierenden Benutzer angeben oder auch einen neuen registrieren. Letzteres sollte mit den Administratoren abgesprochen werden.


==Konfiguration==
==Konfiguration==
''commit-notification.rb'' ist so implementiert, dass jeder User die von ihm gewünschten Einstellungen vornehmen kann. Dazu gehört sowohl die Angabe der Mail- und Jabberadresse, als auch die Art der Benachrichtigung (derzeitig: Jabber oder Mail). Die Einstellungen werden in der Datei ''datei.ini'' vorgenommen. Wie sich auch hier an der Dateiendung erkennen lässt, handelt es sich bei der Datei um ein Ini-File, die wie folgt aufgebaut ist:
''commit-notification.rb'' ist so implementiert, dass jeder User die von ihm gewünschten Einstellungen vornehmen kann. Dazu gehört sowohl die Angabe der Mail- und Jabberadresse, als auch die Art der Benachrichtigung (derzeitig: Jabber oder Mail). Die Einstellungen werden in der Datei ''datei.ini'' vorgenommen. Wie sich auch hier an der Dateiendung erkennen lässt, handelt es sich bei der Datei um ein Ini-File, die wie folgt aufgebaut ist:
<pre>[mmustermann]
[mmustermann]
name = Max Mustermann
name = Max Mustermann
mail = mmustermann@nu2m.de
mail = mmustermann@nu2m.de
jabber = max@example.org
jabber = max@example.org
project = repos_name,
project = repos_name,
notification = mail,jabber</pre>
notification = mail,jabber
Wichtig ist dabei, dass die die Direktive ''project'' dem Namen des Repositories entspricht. Ebenso darf der Username (in eckigen Klammern notiert) nicht doppelt notiert sein.
Wichtig ist dabei, dass die die Direktive ''project'' dem Namen des Repositories entspricht. Ebenso darf der Username (in eckigen Klammern notiert) nicht doppelt notiert sein.
[[Kategorie:Webserver]]
[[Kategorie:Subversion]]

Aktuelle Version vom 11. September 2008, 17:30 Uhr

Subversion-Hooks lassen sich dazu verwenden, Benutzern über Jabber oder Mail über Veränderungen in Repositories zu informieren. Hooks sind allgemein gesprochen Einstiegspunkte, die eine bestimmte Software bietet.

Implementation

Das zentrale Script commit-notification.rb ist, wie man unschwer an der Dateiendung erkennt, ein Ruby-Script. Es versteht die vier Argumente -r (--revision), -d (--repos), -c (--config), -u (--user) und -p (--password). Die Parameter sind zwingend notwendig, ohne sie funktioniert es nicht. Der verwendete Hook post-commit wird in der Datei /path/to/repository/hooks/post-commit spezifiziert und muss folgenden Inhalt haben:

#! /bin/sh
REPOS="$1"
REV="$2"
/usr/local/bin/subversion/commit-notification.rb \
   --revision "$REV" \
   --repos "$REPOS" \
   --config /home/user/path/to/file.ini \
   --user 'jabberuser' \
   --password 'jabbersecret'

Jabber

Damit Nachrichten per Jabber versandt werden können, muss man dem Script sowohl den Benutzer als auch das Passwort mitgeben. Der Benutzer wird im Format username@server.com/Resource angegeben. Man kann dazu entweder einen existierenden Benutzer angeben oder auch einen neuen registrieren. Letzteres sollte mit den Administratoren abgesprochen werden.

Konfiguration

commit-notification.rb ist so implementiert, dass jeder User die von ihm gewünschten Einstellungen vornehmen kann. Dazu gehört sowohl die Angabe der Mail- und Jabberadresse, als auch die Art der Benachrichtigung (derzeitig: Jabber oder Mail). Die Einstellungen werden in der Datei datei.ini vorgenommen. Wie sich auch hier an der Dateiendung erkennen lässt, handelt es sich bei der Datei um ein Ini-File, die wie folgt aufgebaut ist:

[mmustermann]
name = Max Mustermann
mail = mmustermann@nu2m.de
jabber = max@example.org
project = repos_name,
notification = mail,jabber

Wichtig ist dabei, dass die die Direktive project dem Namen des Repositories entspricht. Ebenso darf der Username (in eckigen Klammern notiert) nicht doppelt notiert sein.