SVN Administration für das KTM-Projekt

Transkript

1 SVN Administration für das KTM-Projekt Allgemeines Der Server auf dem dieser Service läuft heißt ktm.ee.hm.edu Auf diesem Rechner existiert ein Benutzerkonto svnuser. Via ssh/scp kann man sich auch auf von außen auf diesen Rechner einloggen. Dieser Account ist nur für die Administration des SVN-Bereichs nötig (z. B. Neuanlegen eines Benutzers, Ändern von Zugriffsberechtigungen für ein Teilprojekt, etc.) Alle für Sie notwendigen Daten befinden sich unterhalb Ihres Heimatverzeichnisses /store1/svnuser. Sollten Sie das Passwort für Ihren Shell-Zugang ändern wollen, dann verwenden Sie bitte das Kommando "passwd" via SSH. Dieses Kommando ändert nur Ihr Passwort für den Shell-Zugang (ssh/scp) auf ktm.ee.hm.edu (sonst nirgends). SICHERHEITSHINWEISE: Gehen Sie mit der Ressource "Server" (Festplattenspeicherplatz, Prozesse,...) sinnvoll um! Verwenden Sie den SVN-Dienst nur für Aufgaben des KTM-Projekts. Arbeiten Sie via SSH-Terminallogin nur für die SVN-, Benutzer- und Gruppenverwaltung. Alle Dateien sind von Ihrem Heimatverzeichnis aus zugänglich! Zugriff via SSH haben max. 3 Mitarbeiter, die gegenüber Hr. Tasin als Ansprechpartner dienen. Das Verteilen des Passwortes des Benutzers svnuser ist nicht gestattet. Ändert sich der Ansprechpartner, so ist dies Hr. Tasin unverzüglich mitzuteilen und ein neues Passwort zu vergeben. Verzeichnisaufbau Sie finden folgende Verzeichnisstruktur vor:. -- bin -- svn-devs.list (Liste der Mailadressen, die bei Änderung im SVN benachrichtigt werden) `-- repository (SVN Repositorium) -- README.txt -- conf -- access (Zugriffsrichtlinien) -- htpasswd (SVN-Passwortdatei) `-- svnmailer.conf (Benachrichtigungskonfig.-Datei) -- dav -- db -- current -- format -- fs-type

2 -- revprops ` revs ` transactions -- uuid `-- write-lock -- format -- hooks `-- locks -- db-logs.lock `-- db.lock SVN Allgemeines zum SVN Das Repositorium ist über folgende Adresse erreichbar: Diese Adresse wird auch als Repository-URL in SVN-Clientanwendungen (z. B. Tortoise, RapidSVN, u. ä.) verwendet. Bitte beachten Sie das als Protokoll. Es ist nur Zugriff via SSL gestattet. Ein Ändern oder Hochladen von Dateien in das SVN ist nur mit Usernamen/Passwort zulässig. Das komplette SVN befindet sich unterhalb des svnuser-heimatverzeichnisses in /store1/svnuser/repository. Wenn eine RAW-Sicherung gemacht werden soll, reicht also ein Backup dieses Verzeichnisses; der Rechner wird aber täglich (als virtuelle Maschine) auf ein zusätzliches NAS gesichert. Normalerweise sollte das also kein Problem sein, aber zur Migration auf einen anderen Rechner ist dieses Backup sicherlich auch sinnvoll. Authentifizierungsdaten Die Benutzer, die auf dieses Repositorium zugreifen dürfen finden Sie in der Datei /store1/svnuser/repository/conf/htpasswd. Sie besteht immer aus mustermann1:$apr1$1u5sl...$zwccn4q6zyfvgc39yv.p./ mustermann2:$apr1$1u5sl...$zwccn4q6zyfvgc39yv.p./... Ein zusätzlicher Benutzer wird durch Hinzufügen einer Zeile eingerichtet. Manuelle Einrichtung Der Verwalter als svnuser kann eine SSH-Terminalsitzung auf ktm.ee.hm.edu öffnen und htpasswd verwenden, um sich eine dieser Zeilen zu erzeugen. Nachfolgend ein Beispielaufruf für den Benutzer mustermann:

3 htpasswd -nm mustermann New password: Re-type new password: mustermann:$apr1$1u5sl...$zwccn4q6zyfvgc39yv.p./ Danach kann die fett dargestellte Zeile in die Datei ~/repository/conf/htpasswd hinzugefügt werden. Der folgende Befehl vereinfacht den Vorgang (d. h. das manuelle Kopieren der erzeugten Zeile in die Datei ~/repository/conf/htpasswd enfällt): htpasswd -m ~/repository/conf/htpasswd mustermann New password: Re-type new password: Adding password for user mustermann Über folgenden Befehl ist das Löschen eines Benutzers möglich: htpasswd2 -D ~/repository/conf/htpasswd mustermann Deleting password for user mustermann Zugriffsberechtigung Ein neu eingerichteter Benutzer hat dann jedoch nur die Benutzerberechtigung eines Gastes. Damit dieser Benutzer auch auf das Repositorium schreiben kann, muss man ihn der entsprechenden Gruppe zuordnen. Dies geschieht in der Datei /store1/svnuser/repository/conf/access. Sie sieht im Augenblick wie folgt aus: [groups] admin-developers = tasin ktm-developers = tasin ktm-users = [/public] * = = rw [/] * = = = r Das bedeutet es gibt die Gruppen admin-developers, sg-developers und sg-users. (Der Beispielbenutzer "mustermann" müsste einer dieser Gruppen zugeordnet werden. Also entweder in Zeile 2 oder 3 hinzugefügt werden.) Im Augenblick hat nur die Gruppe admin-developers im obengenannten Fall Zugriff auf das Wurzelverzeichnis des Repositoriums. Auf das Verzeichnis /public hat nur die Gruppe admin-developers Schreibzugriff und alle anderen Lesezugriff. Auf das Wurzelverzeichnis haben nur Gruppenmitglieder Zugriff.

4 Dies kann den Bedürfnissen des Projekts entsprechend angepasst werden. SSL Der Datenverkehr zum und vom Repositorium erfolgt verschlüsselt via SSL. Es wird ein global überprüfbares Zertifikat für den Zugriff verwendet. Benachrichtigung bei Änderung Es wurde auch eine automatische Benachrichtigungsfunktion eingerichtet. D. h. sollte jemand etwas am Repositorium ändern so wird eine Benachrichtigungsmail an geschickt. Diese Adresse ist ein Alias für alle Mailadressen (Benutzer), die in der Datei /store1/svnuser/svn-devs.list stehen. (Pro Zeile eine Mailadresse eintragen.) Sobald eine Benachrichtigungsmail abzusetzen ist, werden die in der Datei svn-devs.list enthaltenen Mailadressen benachrichtigt. Tragen Sie in den Listen nur Mailadressen ein, wenn der entsprechende Adressat Ihnen die Erlaubnis dazu gegeben hat! Mailinglisten über Aliases Für das KTM-Projekt wurden noch folgende Listen eingetragen: (Auszug aus /etc/aliases) webmaster: :include:/store1/svnuser/maillisten/wordpress-webmaster.list www: :include:/store1/svnuser/maillisten/wordpress-webmaster.list redaktion: :include:/store1/svnuser/maillisten/wordpress-redaktion.list team: :include:/store1/svnuser/maillisten/team.list alumni: :include:/store1/svnuser/maillisten/alumni.list svn-admin: :include:/store1/svnuser/maillisten/svn-admin.list svn-devs: :include:/store1/svnuser/maillisten/svn-devs.list Links steht der Benutzername (z. B. und rechts die Liste in der die effektiven Mailadresse stehen die unter dem Alias adressiert werden. Tragen Sie in den Listen nur Mailadressen ein, wenn der entsprechende Adressat Ihnen die Erlaubnis dazu gegeben hat! WebSVN Zusätzlich wurde der Server mit einer Webschnittstelle ausgestattet. Diese ist über folgende Adresse einsehbar: Die Authentifizierung am System erfolgt mit dem gleichen Usernamen & Passwort, der den Zugriff auf das SVN ermöglicht. Die Richtlinien, was der entsprechende Benutzer einsehen darf, wird ebenfalls durch die SVN-Richtlinien festgelegt.

5 Links SVN-Client (Windows): Versionskontrolle mit SVN: