HSR git und subversion HowTo An der HSR steht den Studierenden ein git Server für die Versionskontrolle zur Verfügung. Dieses HowTo fasst die notwendigen Informationen zur Verwendung dieses Dienstes zusammen. Die Dokumentation wurde basierend auf git.hsr.ch erstellt und ist auch für den svn Server gültig. Inhalt Allgemeines Anmelden am System Verwalten von Repositories Erstellen Einstellungen Berechtigungen Gruppen Löschen 20120920: Initiale Version, Marcel Huber 20120924: svn nur intern und über vpn erreichbar, Marcel Huber 20120924: svn von Aussen erreichbar, HSR signed Zertifikat, Marcel Huber T +41 55 222 46 30 F +41 55 222 46 29 ifs@hsr.ch www.ifs.hsr.ch Seite 1 von 8
Allgemeines Administration des Repository erfolgt über einen Browser via https Der git Server der HSR unterstützt nur das https Protokoll Der git Server ist sowohl HSR intern wie auch extern über Internet erreichbar Die Anzahl Repositories pro Person ist (vorerst) nicht limitiert Mehrere Benutzer für ein Projekt sind möglich Die Vergabe der Zugriffsrechte erfolgt durch die Besitzer des Repository Die Repositories können jederzeit von einem der Besitzer gelöscht werden Repository Benutzer sind primär HSR Benutzer, externe Benutzer können mittels Anfrage an servicedesk eingerichtet werden Wenn Sie mit der Maus über das Hilfesymbol neben einem Eingabefeld fahren, werden Informationen dazu angezeigt. Anmelden am System Der Zugriff auf die Übersichtsseite des Verwaltungstools geschieht mit einem Web-Browser unter Angabe von https://git.hsr.ch/ Nach anklicken von Login, auf der linken Seite unterhalb von Navigation, erscheint die Login-Maske, welche mit ihrem HSR Benutzernamen und entsprechendem Passwort abgefüllt wird. T +41 55 222 46 30 F +41 55 222 46 29 ifs@hsr.ch www.ifs.hsr.ch Seite 2 von 8
Nach erfolgreicher Anmeldung erscheint folgende Übersicht. Verwalten von Repositories Die Verwaltung von Repositories geschieht über das gleichnamige Register, welches mittels klick auf Repositories in der linken Navigationsleiste geöffnet wird. Danach erscheint eine Übersicht der eigenen und öffentlich sichtbaren Repositories. T +41 55 222 46 30 F +41 55 222 46 29 ifs@hsr.ch www.ifs.hsr.ch Seite 3 von 8
Erstellen Sie erstellen ein neues Repository durch klicken auf Hinzufügen (Add). Danach wird im unteren Bereich des Browserfensters eine Eingabemaske angezeigt, welche Sie nun mit den gewünschten Angaben ausfüllen können. Berechtigungen können erst verwaltet werden, wenn das Repository erzeugt wurde. Dies wird im nächsten Abschnitt betrachtet. T +41 55 222 46 30 F +41 55 222 46 29 ifs@hsr.ch www.ifs.hsr.ch Seite 4 von 8
Einstellungen Um die Einstellungen eines Repository anzuzeigen, wählen wir es aus der Liste durch anklicken aus. T +41 55 222 46 30 F +41 55 222 46 29 ifs@hsr.ch www.ifs.hsr.ch Seite 5 von 8
Im ersten unteren Register werden die grundlegenden Eigenschaften angezeigt. Darunter ist die URL zum Repository wie auch das Kommando zum Checkout zu finden. Das zweite Register zeigt die Eingabefelder wie sie zum Erstellen des Repository schon angegeben wurden. Änderungen können nur am Kontakt, der Beschreibung und am Public Flag vorgenommen werden. Beachten Sie Nachträglich können Name und Typ nicht mehr geändert werden! Öffentlich (Public) markierte Repositories können von der ganzen Welt eingesehen werden! Seien Sie also vorsichtig. T +41 55 222 46 30 F +41 55 222 46 29 ifs@hsr.ch www.ifs.hsr.ch Seite 6 von 8
Berechtigungen Berechtigungen können nur von den Besitzern (owner) des Repository verwaltet werden. Beachten Sie Die Checkbox Is Group (Gruppenberechtigung) ist nur zu setzen wenn der eingetragene Name wirklich einer Gruppe, aus dem ActiveDirectory/LDAP, entspricht! Im Namensfeld wird der HSR Loginname eingetragen. Der Name, von Benutzern welche sich noch nie an diesem System angemeldet haben, wird nicht automatisch zur Vervollständigung vorgeschlagen. Kleine, rote Ecken markieren ungespeicherte Änderungen. Gruppen Um ein Repository mit einer ganzen Gruppe von Benutzern zu teilen, können Gruppen aus dem HSR ActiveDirectory verwendet werden. Sollte für ihren Benutzerkreis noch keine Gruppe verfügbar sein, können Sie diese mit einer entsprechenden Anfrage an servicedesk@hsr.ch einrichten lassen. Beachten Sie Eine Gruppe kann beispielsweise dann sinnvoll sein, wenn ein Repository langfristig einem Institut gehören soll, die Benutzer aber oft wechseln. Dazu wird eine Institutsgruppe als Besitzer (owner) eingetragen wodurch die Verwaltung langfristig gesichert ist. Natürlich muss in diesem Fall die entsprechende Institutsgruppe gepflegt werden. Löschen Repositories können von Besitzern auch wieder gelöscht werden. Dazu wird das Repository angewählt, Remove gedrückt und danach die Meldung mit OK quittiert. T +41 55 222 46 30 F +41 55 222 46 29 ifs@hsr.ch www.ifs.hsr.ch Seite 7 von 8
Beachten Sie Archive Repository (Repository archivieren) ist nicht zutreffend, die Repositories werden wirklich gelöscht und nicht archiviert! T +41 55 222 46 30 F +41 55 222 46 29 ifs@hsr.ch www.ifs.hsr.ch Seite 8 von 8