You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: book/02-git-basics/sections/getting-a-repository.asc
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,7 +38,7 @@ $ git init
38
38
39
39
Der Befehl erzeugt ein Unterverzeichnis `.git`, in dem alle relevanten Git Repository Daten enthalten sind, also ein Git Repository Grundgerüst.
40
40
Zu diesem Zeitpunkt werden noch keine Dateien in Git versioniert.
41
-
(In Kapitel 10, <<ch10-git-internals#ch10-git-internals,Git Internas>>, finden Sie weitere Informationen, welche Dateien im `.git` Verzeichnis enthalten sind und was ihre Aufgabe ist.)(((Git Befehle, init)))
41
+
(In Kapitel 10, <<ch10-git-internals#ch10-git-internals,Git Interna>>, finden Sie weitere Informationen, welche Dateien im `.git` Verzeichnis enthalten sind und was ihre Aufgabe ist.)(((Git Befehle, init)))
42
42
43
43
Wenn Sie bereits existierende Dateien versionieren möchten (und es sich nicht nur um ein leeres Verzeichnis handelt), dann sollten Sie den aktuellen Stand in einem initialen Commit starten.
44
44
Mit dem Befehl `git add` legen Sie fest, welche Dateien versioniert werden sollen und mit dem Befehl `git commit` erzeugen Sie einen neuen Commit:
Git funktioniert etwas anders, wenn Sie `file://` explizit am Anfang der URL angeben.
30
30
Wenn Sie nur den Pfad angeben, versucht Git, Hardlinks zu verwenden oder die benötigten Dateien direkt zu kopieren.
31
31
Wenn Sie `file://` angeben, löst Git Prozesse aus, die normalerweise zum Übertragen von Daten über ein Netzwerk verwendet werden, was im Allgemeinen viel weniger effizient ist.
32
-
Der Hauptgrund für die Angabe des Präfix `file://` ist, wenn Sie eine saubere Kopie des Repositorys mit fremden Referenzen oder weggelassenen Objekten wünschen – in der Regel nach einem Import aus einem anderen VCS oder ähnlichem (siehe <<ch10-git-internals#ch10-git-internals,Git Internas>> für Wartungsaufgaben.
32
+
Der Hauptgrund für die Angabe des Präfix `file://` ist, wenn Sie eine saubere Kopie des Repositorys mit fremden Referenzen oder weggelassenen Objekten wünschen – in der Regel nach einem Import aus einem anderen VCS oder ähnlichem (siehe <<ch10-git-internals#ch10-git-internals,Git Interna>> für Wartungsaufgaben.
33
33
Wir werden hier den normalen Pfad verwenden, denn das ist fast immer schneller.
34
34
35
35
Um ein lokales Repository zu einem bestehenden Git-Projekt hinzuzufügen, kann so vorgegangen werden:
In diesem speziellen Fall verwenden wir den Pfad `/var/www/htdocs`, der für Apache-Installationen üblich ist, Sie können aber jeden statischen Webserver verwenden – legen Sie einfach das leere Repository in seinen Pfad.
116
-
Die Git-Daten werden als einfache statische Dateien bereitgestellt (siehe Kapitel <<ch10-git-internals#ch10-git-internals,Git Internas>> für Bedienungsdetails).
116
+
Die Git-Daten werden als einfache statische Dateien bereitgestellt (siehe Kapitel <<ch10-git-internals#ch10-git-internals,Git Interna>> für Bedienungsdetails).
117
117
118
118
Im Allgemeinen würden Sie sich entweder einen Smart HTTP-Server zum Lesen und Schreiben betreiben oder die Dateien einfach als schreibgeschützt im Dumb-Modus zur Verfügung stellen.
119
119
Seltener wird ein Mix aus beiden Diensten angeboten.
Im Gegensatz zu CVCSs (Centralized Version Control Systems - Zentrale Versionsverwaltungs Systeme) können Sie dank der verteilten Struktur von Git die Zusammenarbeit von Entwicklern in Projekten wesentlich flexibler gestalten.
4
+
Im Gegensatz zu CVCSs (Centralized Version Control Systems - Zentrale Versionsverwaltungs Systeme) können Sie dank der verteilten Struktur von Git die Zusammenarbeit von Entwicklern in Projekten wesentlich flexibler gestalten.
5
5
In zentralisierten Systemen ist jeder Entwickler ein gleichwertiger Netzknoten, der mehr oder weniger gleichermaßen mit einem zentralen System arbeitet.
6
-
In Git ist jedoch jeder Entwickler potentiell beides - sowohl Netzknoten als auch zentrales System. Das heißt, jeder Entwickler kann sowohl Code für andere Repositorys bereitstellen als auch ein öffentliches Repository verwalten, auf dem andere ihre Arbeit aufbauen und zu dem sie beitragen können.
7
-
Dies bietet eine Fülle von möglichen Arbeitsabläufen (engl. Workflows) für Ihr Projekt und/oder Ihrem Team, sodass wir einige gängige Paradigmen behandeln, welche die Vorteile dieser Flexibilität nutzen.
6
+
In Git ist jedoch jeder Entwickler potentiell beides - sowohl Netzknoten als auch zentrales System. Das heißt, jeder Entwickler kann sowohl Code für andere Repositorys bereitstellen als auch ein öffentliches Repository verwalten, auf dem andere ihre Arbeit aufbauen und zu dem sie beitragen können.
7
+
Dies bietet eine Fülle von möglichen Arbeitsabläufen (engl. Workflows) für Ihr Projekt und/oder Ihrem Team, sodass wir einige gängige Paradigmen behandeln, welche die Vorteile dieser Flexibilität nutzen.
8
8
Wir werden die Stärken und möglichen Schwächen der einzelnen Entwürfe eingehen. Sie können einen einzelnen davon auswählen, um ihn zu nutzen, oder Sie können die Funktionalitäten von allen miteinander kombinieren.
9
9
10
10
==== Zentralisierter Arbeitsablauf
11
11
12
12
(((workflows, centralized)))
13
-
In zentralisierten Systemen gibt es im Allgemeinen ein einziges Modell für die Zusammenarbeit - den zentralisierten Arbeitsablauf.
13
+
In zentralisierten Systemen gibt es im Allgemeinen ein einziges Modell für die Zusammenarbeit - den zentralisierten Arbeitsablauf.
14
14
Ein zentraler Hub oder _Repository_ kann Quelltext akzeptieren und alle Beteiligten synchronisieren ihre Arbeit damit.
15
15
Eine Reihe von Entwicklern sind Netznoten - Nutzer dieses Hubs - und synchronisieren ihre Arbeit mit diesem einen, zentralen Punkt.
Dies bedeutet, wenn zwei Entwickler ein Repository vom Hub klonen und beide Änderungen vornehmen, der erste Entwickler, der die Änderungen zurückgespielt hat, dies problemlos tun kann.
21
-
Der zweite Entwickler muss jedoch die Arbeit des ersten Entwicklers bei sich einfließen lassen (mergen), bevor seine Änderungen aufgenommen werden können, damit die Änderungen des ersten Entwicklers nicht überschrieben werden.
20
+
Dies bedeutet, wenn zwei Entwickler ein Repository vom Hub klonen und beide Änderungen vornehmen, der erste Entwickler, der die Änderungen zurückgespielt hat, dies problemlos tun kann.
21
+
Der zweite Entwickler muss jedoch die Arbeit des ersten Entwicklers bei sich einfließen lassen (mergen), bevor seine Änderungen aufgenommen werden können, damit die Änderungen des ersten Entwicklers nicht überschrieben werden.
22
22
Dieses Konzept ist in Git genauso wahr wie in Subversion(((Subversion))) (oder ein anderes beliebiges CVCS), und dieses Konzept funktioniert in Git wunderbar.
23
23
24
-
Wenn Sie bereits mit einem zentralisierten Arbeitsablauf in Ihrem Unternehmen oder Team vertraut sind, können Sie diesen Ablauf problemlos mit Git weiterverwenden.
24
+
Wenn Sie bereits mit einem zentralisierten Arbeitsablauf in Ihrem Unternehmen oder Team vertraut sind, können Sie diesen Ablauf problemlos mit Git weiterverwenden.
25
25
Richten Sie einfach ein einziges Repository ein und gewähren Sie allen Mitgliedern Ihres Teams Schreib-Zugriff (push). Git lässt nicht zu, dass Benutzer sich gegenseitig überschreiben.
26
26
27
-
Sagen wir, John und Jessica fangen beide zur gleichen Zeit mit ihrer Arbeit an.
28
-
John beendet seine Änderung und lädt diese zum Server hoch.
29
-
Dann versucht Jessica, ihre Änderungen hochzuladen, aber der Server lehnt sie ab.
30
-
Ihr wird gesagt, dass sie versucht, Änderungen „non-fast-forward“ zu pushen, und dass sie dies erst tun kann, wenn sie sie bestehende Änderungen abgeholt und mit ihrer lokalen Kopie zusammengeführt hat.
27
+
Sagen wir, John und Jessica fangen beide zur gleichen Zeit mit ihrer Arbeit an.
28
+
John beendet seine Änderung und lädt diese zum Server hoch.
29
+
Dann versucht Jessica, ihre Änderungen hochzuladen, aber der Server lehnt sie ab.
30
+
Ihr wird gesagt, dass sie versucht, Änderungen „non-fast-forward“ zu pushen, und dass sie dies erst tun kann, wenn sie sie bestehende Änderungen abgeholt und mit ihrer lokalen Kopie zusammengeführt hat.
31
31
Dieser Workflow ist für viele Menschen sehr ansprechend, weil er ein bewährtes Modell ist, mit dem viele bereits bekannt und vertraut sind.
32
32
33
-
Diese Vorgehensweise ist nicht auf kleine Teams beschränkt.
33
+
Diese Vorgehensweise ist nicht auf kleine Teams beschränkt.
34
34
Mit dem Verzweigungs-Modell (Branching-Modell) von Git ist es Hunderten von Entwicklern möglich, ein einzelnes Projekt über Dutzende von Branches gleichzeitig erfolgreich zu bearbeiten.
35
35
36
36
[[_integration_manager]]
37
37
==== Arbeitsablauf mit Integrationsmanager
38
38
39
39
(((workflows, integration manager)))
40
40
41
-
Da Sie in Git über mehrere Remote-Repositorys verfügen können, ist ein Workflow möglich, bei dem jeder Entwickler Schreibzugriff auf sein eigenes, öffentliches Repository und Lesezugriff auf die Repositorys aller anderen Entwickler hat.
42
-
Dieses Szenario enthält häufig ein zentrales Repository, das das „offizielle“ Projekt darstellt.
43
-
Um zu diesem Projekt beizutragen, erstellen Sie Ihren eigenen öffentlichen Klon des Projekts und laden Ihre Änderungen dort hoch.
44
-
Anschließend können Sie eine Anforderung an den Betreuer des Hauptprojekts senden, um Ihre Änderungen zu übernehmen (Pull Request).
41
+
Da Sie in Git über mehrere Remote-Repositorys verfügen können, ist ein Workflow möglich, bei dem jeder Entwickler Schreibzugriff auf sein eigenes, öffentliches Repository und Lesezugriff auf die Repositorys aller anderen Entwickler hat.
42
+
Dieses Szenario enthält häufig ein zentrales Repository, das das „offizielle“ Projekt darstellt.
43
+
Um zu diesem Projekt beizutragen, erstellen Sie Ihren eigenen öffentlichen Klon des Projekts und laden Ihre Änderungen dort hoch.
44
+
Anschließend können Sie eine Anforderung an den Betreuer des Hauptprojekts senden, um Ihre Änderungen zu übernehmen (Pull Request).
45
45
Der Betreuer kann dann Ihr Repository als Remote hinzufügen, Ihre Änderungen lokal testen, diese in seinem Branch einfließen und in sein öffentliches Repository hochladen.
46
46
Der Prozess funktioniert wie folgt (siehe <<wfdiag_b>>):
47
47
@@ -57,35 +57,35 @@ Der Prozess funktioniert wie folgt (siehe <<wfdiag_b>>):
57
57
image::images/integration-manager.png[Arbeitsablauf mit Integrationsmanager.]
58
58
59
59
(((forking)))
60
-
Dies ist ein sehr häufiger Workflow mit Hub-basierten Tools wie GitHub oder GitLab, bei dem es einfach ist, ein Projekt zu „forken“ und Ihre Änderungen in Ihren Fork hochzuladen, damit jeder sie sehen kann.
61
-
Einer der Hauptvorteile dieses Ansatzes besteht darin, dass Sie weiterarbeiten können und der Verwalter des Haupt-Repositorys Ihre Änderungen jederzeit übernehmen kann.
60
+
Dies ist ein sehr häufiger Workflow mit Hub-basierten Tools wie GitHub oder GitLab, bei dem es einfach ist, ein Projekt zu „forken“ und Ihre Änderungen in Ihren Fork hochzuladen, damit jeder sie sehen kann.
61
+
Einer der Hauptvorteile dieses Ansatzes besteht darin, dass Sie weiterarbeiten können und der Verwalter des Haupt-Repositorys Ihre Änderungen jederzeit übernehmen kann.
62
62
Die Mitwirkenden müssen nicht warten, bis das Projekt ihre Änderungen übernommen hat - jede Partei kann in ihrem eigenen Tempo arbeiten.
63
63
64
-
==== Arbeitsablauf mit Diktator und Leutnante
64
+
==== Arbeitsablauf mit Diktator und Leutnants
65
65
66
66
(((workflows, dictator and lieutenants)))
67
-
Dies ist eine Variante eines Workflows mit vielen Repositorys.
68
-
Sie wird im Allgemeinen von großen Projekten mit Hunderten von Mitarbeitern verwendet. Ein berühmtes Beispiel ist der Linux-Kernel.
69
-
Verschiedene Integrationsmanager sind für bestimmte Teile des Repositorys verantwortlich. Sie heißen _Leutnante_.
70
-
Alle Leutnante haben einen Integrationsmanager, der als der wohlwollende Diktator (benevolent dictator) bezeichnet wird.
67
+
Dies ist eine Variante eines Workflows mit vielen Repositorys.
68
+
Sie wird im Allgemeinen von großen Projekten mit Hunderten von Mitarbeitern verwendet. Ein berühmtes Beispiel ist der Linux-Kernel.
69
+
Verschiedene Integrationsmanager sind für bestimmte Teile des Repositorys verantwortlich. Sie heißen _Leutnants_.
70
+
Alle Leutnants haben einen Integrationsmanager, der als der wohlwollende Diktator (benevolent dictator) bezeichnet wird.
71
71
Der wohlwollende Diktator pusht von seinem Verzeichnis in ein Referenz-Repository, aus dem alle Beteiligten ihre eigenen Repositorys aktualisieren müssen.
72
72
Dieser Prozess funktioniert wie folgt (siehe <<wfdiag_c>>):
73
73
74
-
1. Entwickler arbeiten regelmäßig an ihrem Themen Branch und reorganisieren (rebasen) ihre Arbeit auf `master`.
74
+
1. Entwickler arbeiten regelmäßig an ihrem Themen Branch und reorganisieren (rebasen) ihre Arbeit auf `master`.
75
75
Der `master`-Branch ist der des Referenz-Repositorys, in das der Diktator pusht.
76
-
2. Die Leutnante fassen die Themen Branches der Entwickler mit ihrem `master`-Branch zusammen.
77
-
3. Der Diktator führt die `master`-Branches der Leutnante in den `master`-Branch des Diktators zusammen.
76
+
2. Die Leutnants fassen die Themen Branches der Entwickler mit ihrem `master`-Branch zusammen.
77
+
3. Der Diktator führt die `master`-Branches der Leutnants in den `master`-Branch des Diktators zusammen.
78
78
4. Schließlich pusht der Diktator diesen `master` -Branch in das Referenz-Repository, damit die anderen Entwickler darauf einen Rebase durchführen können.
79
79
80
80
[[wfdiag_c]]
81
81
.Arbeitsablauf mit wohlwollendem Diktator.
82
82
image::images/benevolent-dictator.png[Arbeitsablauf mit wohlwollendem Diktator.]
83
83
84
-
Diese Art von Arbeitsablauf ist nicht weit verbreitet, kann jedoch in sehr großen Projekten oder in sehr hierarchischen Umgebungen hilfreich sein.
84
+
Diese Art von Arbeitsablauf ist nicht weit verbreitet, kann jedoch in sehr großen Projekten oder in sehr hierarchischen Umgebungen hilfreich sein.
85
85
Dies ermöglicht dem Projektleiter (dem Diktator), einen Großteil der Arbeit zu delegieren und große Teilbereiche von Quelltext an mehreren Stellen zu sammeln, bevor diese integriert werden.
86
86
87
87
==== Zusammenfassung
88
88
89
-
Dies sind einige häufig verwendete Workflows, die mit einem verteilten System wie Git möglich sind. Allerdings sind auch viele Variationen möglich, um Ihren eigenen Arbeitsabläufen gerecht zu werden.
90
-
Jetzt, da Sie (hoffentlich) bestimmen können, welche Kombination von Arbeitsabläufen bei Ihnen funktionieren würde, werden wir einige spezifischere Beispiele davon betrachten, wie man die Hauptaufgaben durchführen kann, welche die unterschiedliche Abläufe ausmachen.
89
+
Dies sind einige häufig verwendete Workflows, die mit einem verteilten System wie Git möglich sind. Allerdings sind auch viele Variationen möglich, um Ihren eigenen Arbeitsabläufen gerecht zu werden.
90
+
Jetzt, da Sie (hoffentlich) bestimmen können, welche Kombination von Arbeitsabläufen bei Ihnen funktionieren würde, werden wir einige spezifischere Beispiele davon betrachten, wie man die Hauptaufgaben durchführen kann, welche die unterschiedliche Abläufe ausmachen.
91
91
Im nächsten Abschnitt erfahren Sie etwas über gängige Formen der Mitarbeit an einem Projekt.
Copy file name to clipboardExpand all lines: book/08-customizing-git/sections/policy.asc
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
[[_an_example_git_enforced_policy]]
2
-
=== An Example Git-Enforced Policy
2
+
=== Beispiel für Git-forcierte Regeln
3
3
4
4
(((policy example)))
5
5
In this section, you'll use what you've learned to establish a Git workflow that checks for a custom commit message format, and allows only certain users to modify certain subdirectories in a project.
0 commit comments