Mercurial > dive4elements > river
comparison artifacts/doc/howto_commit_windows.txt @ 7749:819528f6fabb
Add german howto to describe how to set up putty / wald and mercurial on windows
| author | Andre Heinecke <aheinecke@intevation.de> |
|---|---|
| date | Mon, 24 Feb 2014 18:55:14 +0100 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| 7748:316a9eeb0836 | 7749:819528f6fabb |
|---|---|
| 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> |