Mercurial > dive4elements > river
view artifacts/doc/howto_commit_windows.txt @ 9043:fda171e16988
Do not halt on warnings: this is necessary because we use slf4j-log which is only an indirect, but necessary dependency
author | gernotbelger |
---|---|
date | Wed, 02 May 2018 15:27:46 +0200 |
parents | 819528f6fabb |
children |
line wrap: on
line source
Diese Anleitung erklärt wie man Änderungen an der Codebasis von D4E-River unter Windows durchführen kann. In dieser Anleitung wird dazu TortoiseHg und Putty verwendet. Hintergrund: D4E-River wird mit dem Versionskontrollsystem Mercurial ( http://de.wikipedia.org/wiki/Mercurial ) verwaltet und ist auf der Plattform "Wald" ( http://wald.intevation.org/ ) gehostet. TortoiseHg ist eine Windows Explorer Erweiterung um ein graphisches Frontend für Mercurial zu bieten. Schritte 1-3 sind einmalig auszuführen. Schritt 4 muss immer wenn man eine Änderung durchführen möchte geschehen. Schritt 1: Registrieren eines Benutzerkontos auf wald.intevation.de * Browser öffnen auf Seite https://www.wald.intevation.org/account/register.php Das zugehörige Wurzelzertifikat kann unter https://ssl.intevation.de (Root CA 2010) beschafft werden. * Accountdetails eintragen (Nur Felder mit * müssen beachtet werden) * Registrieren drücken. -> Ihnen wird eine E-Mail mit einem Link zur Bestätigung gesendet. * Link aus der E-Mail öffnen. * Unter: https://wald.intevation.org/projects/dive4elements/ einen Beitrittsgesuch (Link dafür ist Rechts unten auf der Seite unter den Mitgliedern) Knappen Kommentar einfügen: "Beitrittsgesuch Frau Mustermann" o.Ä. -> Ein Admin in diesem Projekt muss Sie nun manuell freischalten. Schritt 2: SSH Schlüssel erstellen und in Wald hinterlegen (Dieser Teil geht davon aus das Putty bereits installiert ist) * Puttygen starten * "Generate a public/private key pair" Ausführen * ggf. Einen Key Comment z.B. "Wald Schluessel" angeben. * ggf. Eine passphrase angeben * Save private key -> Schlüssel abspeichern z.B: c:\Benutzer\name\wald-schluessel.ppk * Save public key -> Öffentlichen Schlüssel abspeichern z.B: c:\Benutzer\name\wald-schluessel-pub.txt * Kopieren Sie den Inhalt des Bereichs "Public key for pasting into OpenSSH authorized_keys file:" * Fügen Sie den öffentlichen Schlüssel in dem Eingabefeld unter: http://wald.intevation.org/account/editsshkeys.php ein. * Speichern des Schlüssels durch drücken auf den Button "Aktualisierung". ! Achtung: Es kann bis zu einer Stunde dauern bis der Schlüssel im System synchronisiert ist. Schritt 3: TortoiseHg (Software zur Versionskontrolle) installieren * Unter: http://tortoisehg.bitbucket.org/ TortoiseHg herunterladen Die passende Version hängt von der Architektur ihres Systems (32/64-Bit ab) * TortoiseHg installieren. Die Standardoptionen sind ausreichend. * Fügen Sie nun den Privaten Schlüssel den Sie in Schritt 2 generiert haben in Pageant ein. (Wenn Pageant noch nicht installiert ist kann auch der Pageant aus TortoiseHg verwendet werden. z.B. Installiert in (C:\Programme\TortoiseHg\Pageant.exe) * Navigieren Sie im Windows Explorer in ein Verzeichnis in welchem das D4E-River Repository angelegt werden soll. * Rechtsklick im Windows Explorer zeigt nun neue Kontext Optionen für TortoiseHg. TortoiseHg -> clone * Tragen Sie als Quelle ssh://<ihrbenutzername>@scm.wald.intevation.org/hg/dive4elements/river/ ein. Als Ziel einen Ordnernamen für ihr Lokales Repository. -> Bei der ersten Verbindung werden Sie darauf hingewiesen das der Host Key des Servers noch unbekannt ist. Der RSA Fingerprint von Wald ist: 24:d2:13:1f:fa:02:54:f1:79:4f:5d:a0:aa:d3:ed Tritt kein Fehler auf haben Sie nun einen Authentifizierten Klon des D4E-River Repositories. Schritt 4: Änderungen durchführen. * Sicherstellen das Pageant gestartet ist und den Key enthält. * Aktualisieren der lokalen Kopie im Ordner des Repositories - Rechtsklick -> TortoiseHg -> Synchronize - Auswählen "Nach dem Abfurfen" -> Update - Eingehende Änderungen von der ausgewählten URL abrufen * Änderungen an den Dateien durchführen. * Rechtsklick auf die geänderte Datei -> Hg Commit... * Eine Versionsmeldung im Fenster die knapp zusammenfasst was / warum Sie etwas geändert haben. (Am liebsten in Englisch) z.B.: "Corrected usage of the word 'fixation' in english translations" * Änderungen zum Server übertragen - Rechtsklick -> TortoiseHg -> Synchronize - Ausgehende Änderungen an die ausgewählte URL übertragen Hinweis: Beim ersten "Commit" werden Sie gebeten sich zu Identifizieren. Im darauffolgenden Einstellungs Fenster müssen Sie dann einen Benutzernamen Angeben. Dieser sollte das Format vorname nachname <email> haben. z.B.: Andre Heinecke <aheinecke@intevation.de>