Git: Unterschied zwischen den Versionen
Aus Das Sopra Wiki
| (8 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
| Zeile 4: | Zeile 4: | ||
* Gemeinsames Arbeiten auf der selben Datenbasis zu ermöglichen. | * Gemeinsames Arbeiten auf der selben Datenbasis zu ermöglichen. | ||
Wir verwenden Git im | Wir verwenden Git im Softwarepraktikum um genau diese Punkte zu ermöglichen. Jede Gruppe erhält ihr eigenes [[#Repository|Repository]] auf [[Gitea]] (einer Plattform ähnlich zu [https://de.wikipedia.org/wiki/GitHub GitHub]), um ihr Projekt zu verwalten. | ||
__TOC__ | __TOC__ | ||
| Zeile 55: | Zeile 55: | ||
=== Remote === | === Remote === | ||
Remote ist die Bezeichnung für ein Repository, das zur Synchronisierung verwendet wird. Meistens ist dies auf einem externen Server und benötigt eine Authentifizierungsmethode um von diesem Änderungen zu holen (fetch) oder Änderungen hochzuladen (push). Im | Remote ist die Bezeichnung für ein Repository, das zur Synchronisierung verwendet wird. Meistens ist dies auf einem externen Server und benötigt eine Authentifizierungsmethode um von diesem Änderungen zu holen (fetch) oder Änderungen hochzuladen (push). Im Softwarepraktikum verwendet jede Gruppe dazu ein eigenes von uns mit [[Gitea]] gehostetes Repository. | ||
=== HEAD === | === HEAD === | ||
| Zeile 81: | Zeile 81: | ||
git config --global user.name "Jane Doe" | git config --global user.name "Jane Doe" | ||
'''Hinweis''': Seiten wie GitHub oder auch | '''Hinweis''': Seiten wie GitHub oder auch unsere [[Gitea]] Instanz verwenden die Emailadresse um den Commit einem Benutzer zuzuordnen, die eingestellten Emailadressen sollten also übereinstimmen. | ||
== Repository erstellen == | == Repository erstellen == | ||
| Zeile 93: | Zeile 93: | ||
== Repository klonen == | == Repository klonen == | ||
Um ein bestehendes Repository in einen Ordner zu klonen benutzt man den clone Befehl | [[Datei:gitea_repoUrl.png|right|thumb|500px|In der Repositoryansicht von Gitea sieht man die genauen URLs für das eigene Gruppenrepository in der roten Box.]] | ||
Um ein bestehendes Repository in einen Ordner zu klonen benutzt man den <code>clone</code> Befehl. Dabei kann entweder HTTPS oder SSH als Protokoll verwendet werden. Beachten Sie dazu auch die Anleitungen zum [[Gitea#SSH Key hinzufügen|Hinzufügen eines SSH Keys zu Gitea]] und [[Gitea#HTTPS Kennwort einrichten|Setzen eines HTTPS Kennworts für Gitea]]. | |||
Für HTTPS verwendet man folgenden Aufruf: | |||
git clone https://git.sopranium.de/<semester>/<gruppe>.git | |||
Für SSH ist der äquivalente Befehl | |||
git clone gitea@ | git clone gitea@git.sopranium.de:<gruppe>/<gruppe>.git | ||
Der Befehl <code>clone</code> legt eine exakte Kopie der gesamten Repositorydaten auf der lokalen Maschine ab. | Der Befehl <code>clone</code> legt eine exakte Kopie der gesamten Repositorydaten auf der lokalen Maschine ab. | ||
| Zeile 105: | Zeile 108: | ||
== Am Repository arbeiten == | == Am Repository arbeiten == | ||
Im Folgenden zeigen wir die grundlegenden Handgriffe, die zur Benutzung von Git notwendig sind. Um tiefer in die Materie einzutauchen empfehlen wir [https://git-scm.com/book/de/v2/Los-geht%E2%80%99s-%C3%84nderungen-nachverfolgen-und-im-Repository-speichern | Im Folgenden zeigen wir die grundlegenden Handgriffe, die zur Benutzung von Git notwendig sind. Um tiefer in die Materie einzutauchen empfehlen wir [https://git-scm.com/book/de/v2/Los-geht%E2%80%99s-%C3%84nderungen-nachverfolgen-und-im-Repository-speichern Git Pro Book]. | ||
==== Neue Datei ==== | ==== Neue Datei ==== | ||
| Zeile 199: | Zeile 202: | ||
=== Mit mehreren Branches arbeiten === | === Mit mehreren Branches arbeiten === | ||
Im | Im Softwarepraktikum verwenden wir hauptsächlich 2 Branches (siehe [[GitWorkflow| Git Workflow im Softwarepraktikum]]). | ||
* '''release''' => Hier ist der aktuelle Stand des Projekts in lauffähigem Zustand mit fertig implementierten Tasks. Dieser Branch ist Grundlage für die Bewertung des Spiels und Abgabe von Artefakten. Dieser Branch muss zu jeder Zeit ein kompillier- und lauffähiges Spiel darstellen. | * '''release''' => Hier ist der aktuelle Stand des Projekts in lauffähigem Zustand mit fertig implementierten Tasks. Dieser Branch ist Grundlage für die Bewertung des Spiels und Abgabe von Artefakten. Dieser Branch muss zu jeder Zeit ein kompillier- und lauffähiges Spiel darstellen. | ||
* '''master''' => Hier werden die Tasks entwickelt. Sie müssen nicht zwangsläufig fertig sein, aber der master Branch soll zu jeder Zeit kompillieren und laufen. | * '''master''' => Hier werden die Tasks entwickelt. Sie müssen nicht zwangsläufig fertig sein, aber der master Branch soll zu jeder Zeit kompillieren und laufen. | ||
| Zeile 266: | Zeile 269: | ||
Hat man die Konflikte in dem Tool behoben, fügt Git die Dateien automatisch zur Stage hinzu, so dass man nur noch den merge Commit machen muss. | Hat man die Konflikte in dem Tool behoben, fügt Git die Dateien automatisch zur Stage hinzu, so dass man nur noch den merge Commit machen muss. | ||
= Git | = Git installieren = | ||
Es gibt unzählige Git Clients. Empfehlenswert ist vor allem für den Einstieg [https://git-scm.com/downloads | Es gibt unzählige Git Clients. Empfehlenswert ist vor allem für den Einstieg [https://git-scm.com/downloads der offizielle Git Client], dessen grafisches Interface jedoch sehr rudimentär ist. Es empfiehlt sich daher zusätzlich einen zweiten Client wie z.B. [https://tortoisegit.org/ TortoiseGit] oder eine der [https://git-scm.com/downloads/guis zahlreichen Alternativen] zu verwenden. | ||
== Git für das | == Git für das Softwarepraktikum vorbereiten == | ||
Nachdem Sie sich für einen Git-Client entschieden haben, müssen Sie sicherstellen: | Nachdem Sie sich für einen Git-Client entschieden haben, müssen Sie sicherstellen: | ||
* Dass ihr [[Gitea|Zugang zu Gitea]] funktioniert. | * Dass ihr [[Gitea|Zugang zu Gitea]] funktioniert. | ||
| Zeile 274: | Zeile 277: | ||
* Ihren [[#Name und Email einstellen|Namen und die Email]] Adresse Git mitteilen. | * Ihren [[#Name und Email einstellen|Namen und die Email]] Adresse Git mitteilen. | ||
* Stellen Sie sicher, dass eine <code>.gitignore</code> Datei mit den Regeln in der unter [[#Dateien Ignorieren|Dateien Ignorieren]] gegebenen Tabelle in ihrem Gruppenrepository im master Branch existiert. | * Stellen Sie sicher, dass eine <code>.gitignore</code> Datei mit den Regeln in der unter [[#Dateien Ignorieren|Dateien Ignorieren]] gegebenen Tabelle in ihrem Gruppenrepository im master Branch existiert. | ||
== Git und Gitea == | == Git und Gitea == | ||
Gitea kann nicht nur die Commitmessages aus dem Repository anzeigen. In der Commitmessage kann auf ein Ticket verwiesen werden, indem man einfach die Nummer des Tickets (links neben dem | Gitea kann nicht nur die Commitmessages aus dem Repository anzeigen. In der Commitmessage kann auf ein Ticket verwiesen werden, indem man einfach die Nummer des Tickets (links neben dem Tickettitel in Gitea) mit ''#'' davor, angibt. Das sorgt auch dafür, dass der Commit in den Kommentaren des Tickets aufgelistet wird. Tickets können per Commitmessage geschlossen werden, indem davor noch ''closes'' (oder ''close, fix, fixes'') geschrieben wird. | ||
=== Beispiele === | === Beispiele === | ||
| Zeile 287: | Zeile 289: | ||
<source> | <source> | ||
Dieser Commit schließt das Ticket mit | Dieser Commit schließt das Ticket mit Nummer 33, closes #33. | ||
</source> | </source> | ||
| Zeile 294: | Zeile 296: | ||
</source> [[Kategorie:Code-Beispiele]] | </source> [[Kategorie:Code-Beispiele]] | ||
Anmerkung: eine Referenz auf einen Issue darf nicht am Anfang einer Zeile stehen (dort leitet <code>#</code> eine | Anmerkung: eine Referenz auf einen Issue darf nicht am Anfang einer Zeile stehen (dort leitet <code>#</code> eine Überschrift ein) | ||
<source> | <source> | ||
#Dies ist eine Überschrift! | #Dies ist eine Überschrift! | ||
