comparison artifacts/doc/howto_commit_windows.txt @ 7766:945d25675a32

merged.
author Raimund Renkert <rrenkert@intevation.de>
date Thu, 27 Feb 2014 16:45:36 +0100
parents 819528f6fabb
children
comparison
equal deleted inserted replaced
7765:03cb95071d21 7766:945d25675a32
1 Diese Anleitung erklärt wie man Änderungen an der Codebasis von
2 D4E-River unter Windows durchführen kann. In dieser Anleitung
3 wird dazu TortoiseHg und Putty verwendet.
4
5 Hintergrund:
6 D4E-River wird mit dem Versionskontrollsystem Mercurial
7 ( http://de.wikipedia.org/wiki/Mercurial ) verwaltet und ist auf
8 der Plattform "Wald" ( http://wald.intevation.org/ ) gehostet.
9 TortoiseHg ist eine Windows Explorer Erweiterung um ein graphisches
10 Frontend für Mercurial zu bieten.
11
12
13 Schritte 1-3 sind einmalig auszuführen. Schritt 4 muss immer wenn
14 man eine Änderung durchführen möchte geschehen.
15
16 Schritt 1: Registrieren eines Benutzerkontos auf wald.intevation.de
17
18 * Browser öffnen auf Seite https://www.wald.intevation.org/account/register.php
19 Das zugehörige Wurzelzertifikat kann unter https://ssl.intevation.de
20 (Root CA 2010) beschafft werden.
21 * Accountdetails eintragen (Nur Felder mit * müssen beachtet werden)
22 * Registrieren drücken.
23 -> Ihnen wird eine E-Mail mit einem Link zur Bestätigung gesendet.
24 * Link aus der E-Mail öffnen.
25 * Unter: https://wald.intevation.org/projects/dive4elements/ einen Beitrittsgesuch
26 (Link dafür ist Rechts unten auf der Seite unter den Mitgliedern)
27 Knappen Kommentar einfügen: "Beitrittsgesuch Frau Mustermann" o.Ä.
28 -> Ein Admin in diesem Projekt muss Sie nun manuell freischalten.
29
30 Schritt 2: SSH Schlüssel erstellen und in Wald hinterlegen
31
32 (Dieser Teil geht davon aus das Putty bereits installiert ist)
33 * Puttygen starten
34 * "Generate a public/private key pair" Ausführen
35 * ggf. Einen Key Comment z.B. "Wald Schluessel" angeben.
36 * ggf. Eine passphrase angeben
37 * Save private key -> Schlüssel abspeichern z.B: c:\Benutzer\name\wald-schluessel.ppk
38 * Save public key -> Öffentlichen Schlüssel abspeichern z.B: c:\Benutzer\name\wald-schluessel-pub.txt
39 * Kopieren Sie den Inhalt des Bereichs "Public key for pasting into OpenSSH authorized_keys file:"
40 * Fügen Sie den öffentlichen Schlüssel in dem Eingabefeld unter:
41 http://wald.intevation.org/account/editsshkeys.php
42 ein.
43 * Speichern des Schlüssels durch drücken auf den Button "Aktualisierung".
44
45 ! Achtung: Es kann bis zu einer Stunde dauern bis der Schlüssel im System
46 synchronisiert ist.
47
48
49 Schritt 3: TortoiseHg (Software zur Versionskontrolle) installieren
50 * Unter: http://tortoisehg.bitbucket.org/ TortoiseHg herunterladen
51 Die passende Version hängt von der Architektur ihres Systems (32/64-Bit ab)
52 * TortoiseHg installieren. Die Standardoptionen sind ausreichend.
53 * Fügen Sie nun den Privaten Schlüssel den Sie in Schritt 2 generiert haben
54 in Pageant ein.
55 (Wenn Pageant noch nicht installiert ist kann auch der Pageant aus TortoiseHg
56 verwendet werden. z.B. Installiert in (C:\Programme\TortoiseHg\Pageant.exe)
57 * Navigieren Sie im Windows Explorer in ein Verzeichnis in welchem
58 das D4E-River Repository angelegt werden soll.
59 * Rechtsklick im Windows Explorer zeigt nun neue Kontext Optionen für TortoiseHg.
60 TortoiseHg -> clone
61 * Tragen Sie als Quelle ssh://<ihrbenutzername>@scm.wald.intevation.org/hg/dive4elements/river/
62 ein. Als Ziel einen Ordnernamen für ihr Lokales Repository.
63 -> Bei der ersten Verbindung werden Sie darauf hingewiesen das der Host Key des Servers
64 noch unbekannt ist. Der RSA Fingerprint von Wald ist:
65 24:d2:13:1f:fa:02:54:f1:79:4f:5d:a0:aa:d3:ed
66
67 Tritt kein Fehler auf haben Sie nun einen Authentifizierten Klon des D4E-River
68 Repositories.
69
70
71 Schritt 4: Änderungen durchführen.
72 * Sicherstellen das Pageant gestartet ist und den Key enthält.
73 * Aktualisieren der lokalen Kopie im Ordner des Repositories
74 - Rechtsklick -> TortoiseHg -> Synchronize
75 - Auswählen "Nach dem Abfurfen" -> Update
76 - Eingehende Änderungen von der ausgewählten URL abrufen
77 * Änderungen an den Dateien durchführen.
78 * Rechtsklick auf die geänderte Datei -> Hg Commit...
79 * Eine Versionsmeldung im Fenster die knapp zusammenfasst was / warum
80 Sie etwas geändert haben. (Am liebsten in Englisch)
81 z.B.: "Corrected usage of the word 'fixation' in english translations"
82 * Änderungen zum Server übertragen
83 - Rechtsklick -> TortoiseHg -> Synchronize
84 - Ausgehende Änderungen an die ausgewählte URL übertragen
85
86 Hinweis: Beim ersten "Commit" werden Sie gebeten sich zu Identifizieren.
87 Im darauffolgenden Einstellungs Fenster müssen Sie dann einen Benutzernamen
88 Angeben. Dieser sollte das Format vorname nachname <email> haben.
89 z.B.: Andre Heinecke <aheinecke@intevation.de>

http://dive4elements.wald.intevation.org