Skip to Content

Changes for page GitLab Erklärungen

Last modified by pmeyer on 2025/09/12 04:41
From version arrow_back 116.4 arrow_forward
edited by pmeyer
on 2025/09/11 23:24
Change comment: There is no comment for this version
To version arrow_back 84.24 arrow_forward
edited by sbeyer1
on 2025/08/25 12:12
Change comment: There is no comment for this version

Summary

Details

insert_drive_file Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.pmeyer
1 +XWiki.sbeyer1
Content
... ... @@ -58,34 +58,21 @@
58 58  
59 59  == Meilensteine und Epics ==
60 60  
61 -Im Laufe des Softwareprojektes werden eine Menge an Issues erstellt. Damit der Überblick über die Vielzahl an Issues nicht verloren geht und somit der Projektfortschritt nicht potenziell gefährdet wird, werden im Softwareprojekt mit Meilensteinen (siehe [[Meilensteine>>doc:Main.Anforderungen Software.WebHome||anchor="HAnforderungen:DievordefiniertenMeilensteine"]]) und Epics gearbeitet. In GitLab werden die Meilensteine mit der Funktion "**Milestones**" und die Labels mit der Funktion **"Labels"** umgesetzt. Diese Option ist im Reiter "Manage" und anschließend unter "Labels" vorzufinden.
61 +Im Laufe des Softwareprojektes werden eine Menge an Issues erstellt. Damit der Überblick, über die Vielzahl an Issues, nicht verloren geht wird im Softwareprojekt mit Meilensteinen (siehe [[Meilensteine>>doc:Main.Anforderungen Software.WebHome||anchor="HAnforderungen:DievordefiniertenMeilensteine"]]) und Epics gearbeitet. In GitLab werden beide Funktionen mit **"Labels"** umgesetzt. Diese Option ist im Reiter "Manage" und anschließend unter "Labels" vorzufinden.
62 62  
63 -=== Meilensteine ===
64 -
65 -Um einen neuen Meilenstein zu erstellen, wird in der Projektnavigationsleiste der Reiter** "Milestones" **angeklickt und nachfolgend die Option **"New milestone"** ausgewählt.
66 -
67 -[[image:Meilenstein1.1.png||data-xwiki-image-style-border="true"]]
68 -
69 -Nach der Erstellung wird der Meilenstein mit einem Titel, einem Start- sowie Enddatum und einer Beschreibung versehen. In der Beschreibung müssen die umzusetzenden Funktionen aufgelistet werden (Ziel des Meilensteins). Bestätigt wird die Erstellung mit der "**Create milestone**"-Funktion.
70 -
71 -[[image:Meilenstein2.png||data-xwiki-image-style-border="true"]]
72 -
73 -[[image:Meilenstein3.png||data-xwiki-image-style-border="true"]]
74 -
75 -=== Epics ===
76 -
77 -Um ein neues Epic zu erstellen, wird in der Projektnavigationsleiste der Reiter** "Labels" **angeklickt und nachfolgend die Option **"New Label"** ausgewählt.
78 -
79 79  [[image:Label 1.png||data-xwiki-image-style-border="true"]]
80 80  
81 -Das neue Epic wird mit einem Titel, einer Beschreibung und einer D
65 +[[image:Label 2.png||data-xwiki-image-style-border="true"]]
82 82  
67 +[[image:Label 3.png||data-xwiki-image-style-border="true"]]
83 83  
69 +Die Erstellung von Epics sind kongruent zur Erstellung der Meilensteine-Label**. **Zur Veranschaulichung wird das Epic-Label **"Lobby" **erstellt.
84 84  
71 +[[image:Epic1.png||data-xwiki-image-style-border="true"]]
85 85  
86 86  [[image:Epic2.png||data-xwiki-image-style-border="true"]]
87 87  
88 -[[image:Label1.png||data-xwiki-image-style-border="true"]]
75 +[[image:Epic3.png||data-xwiki-image-style-border="true"]]
89 89  
90 90  Bei der Issue-Erstellung/Bearbeitung können die erstellten Labels jetzt mit den neuen/bestehenden Issues verknüpft werden. Dies erfolgt trivial zur Status-Option.
91 91  
... ... @@ -95,8 +95,6 @@
95 95  
96 96  [[image:Issue Label 3.png||data-xwiki-image-style-border="true"]]
97 97  
98 -----
99 -
100 100  = Product-Backlog =
101 101  
102 102  Die erstellten Issues werden automatisch nach der Erstellung dem Product-Backlog (siehe [[Product-Backlog>>doc:Main.Scrum.WebHome||anchor="HProductBacklog"]]) hinzugefügt. Der Product-Backlog ist eine Liste mit allen erstellten und unbearbeiteten Issues. Dieser ist im GitLab unter dem Reiter **"Issue boards" **vorzufinden.
... ... @@ -131,22 +131,18 @@
131 131  
132 132  [[image:Liste6.png||data-xwiki-image-style-border="true"]]
133 133  
134 -----
135 -
136 136  = Erstellung eines Sprints =
137 137  
138 -In GitLab erfolgt die Erstellung eines Sprints in sogenannten **"Iterationen"** (Wiederholungen). Diese Option ist in der Gruppennavigationsleiste unter dem Reiter **"Iteration" **vorzufinden. Um einen neuen Sprint zu erstellen wird die **"New iteration cadence"**-Option ausgewählt.
121 +In GitLab erfolgt die Erstellung eines Sprints in sogenannten **"Milestones"** (Meilensteine). Diese Option ist in der Projektnavigationsleiste unter dem Reiter **"Milestones" **vorzufinden. Um einen neuen Sprint zu erstellen wird die **"New Milestone"**-Option ausgewählt.
139 139  
140 -[[image:Iteration1.png||data-xwiki-image-style-border="true"]]
123 +[[image:Sprint1.png||data-xwiki-image-style-border="true"]]
141 141  
142 -Damit ein neuer Sprint erstellt werden kann, wird der Sprint mit einem Titel und einer optionalen Beschreibung versehen. Das Start- sowie Enddatum wird einmalig festgelegt. Anschließend wird die Dauer des Sprints in Wochen angegeben. Dieser Zeitraum ist für jeden weiteren Sprint fest. Desweiteren kann eingestellt werden, wie viele kommende Iterationen geplant werden können.  Die **"Roll over"** Funktion überträgt nicht fertiggestellte User Stories/Aufgaben automatisch in den nächsten Sprint. Mit der "**Create cadence"**-Funktion wird die Iteration und somit der Sprint erstellt.
125 +Damit ein neuer Sprint erstellt werden kann, wird der Sprint mit einem Titel, einem Start- sowie Enddatum und einer Beschreibung versehen. Das Sprintziel sollte in der Beschreibung festgehalten werden. Im unten aufgeführten Beispiel ist die Registrierung und die Anmeldung das angestrebte Sprintziel. Gespeichert wird der Sprint durch die "**Create milestone"**-Funktion
143 143  
144 -[[image:Iteration2.1.png||data-xwiki-image-style-border="true"]]
127 +[[image:Sprint2.png||data-xwiki-image-style-border="true"]]
145 145  
146 -[[image:Iteration3.1.png||data-xwiki-image-style-border="true"]]
129 +[[image:Sprint3.png||data-xwiki-image-style-border="true"]]
147 147  
148 -
149 -
150 150  == Sprint-Backlog ==
151 151  
152 152  Jetzt wurde erfolgreich ein Sprint erstellt. Jedoch fehlen bisher noch die Issues die benötigt werden um das Sprintziel zu erreichen. Dafür wird erneut der Reiter **"Issue boards" **(der Product-Backlog) angesteuert. Anschließend wird die Funktion **"New list"** ausgewählt.
... ... @@ -175,8 +175,6 @@
175 175  
176 176  [[image:SprintF.png||data-xwiki-image-style-border="true"]]
177 177  
178 -----
179 -
180 180  = Erstellung eines Wikis =
181 181  
182 182  Im Softwareprojekt müssen viele Daten dokumentiert (siehe [[Anforderungsanalyse>>doc:Main.Aufgabenstellung.WebHome||anchor="Teilaufgabe2:Anforderungsanalyse28Dokumentation29"]] und [[Entwurf>>doc:Main.Aufgabenstellung.WebHome||anchor="HTeilaufgabe3:Entwurf28Dokumentation29"]] sowie [[Dokumentation>>doc:Main.Anforderungen Software.WebHome||anchor="HAnforderungen:Dokumentation"]]) werden und unter anderem auch ein Projekttagebuch (siehe [[Projekttagebuch>>doc:Main.Anforderungen Gruppen.WebHome||anchor="HProjekttagebuch"]] geführt werden. Dies wird in der Wiki-Funktion von GitLab umgesetzt. Diese Option ist in der Projektnavigationsleiste unter dem Reiter **"Wiki" **vorzufinden.
... ... @@ -196,8 +196,6 @@
196 196  (% class="wikigeneratedid" id="H" %)
197 197  [[image:Wiki5.png||data-xwiki-image-style-border="true"]]
198 198  
199 -----
200 -
201 201  = Zeiterfassung in GitLab =
202 202  
203 203  Im Rahmen des Softwareprojekts sollt ihr eure Arbeitszeit präzise festhalten. Dazu könnt ihr direkt auf angelegten Issues/Tasks/User Stories in dem Bereich **Time tracking** eure Arbeitszeit Aufgabenspezifisch eintragen. In dem Fenster könnt ihr eintragen wie viel Zeit ihr gearbeitet habt, an welchem Tag ihr gearbeitet habt, um nachträgliches verbuchen von Arbeitszeit zu ermöglichen, und eine kleine Zusammenfassung angeben. Sollte bereits Zeit erfasst worden sein, muss über das Plus (siehe Bild oben rechts im roten Rahmen) Zeit gebucht werden.[[image:1754139824426-497.png]]
... ... @@ -241,7 +241,7 @@
241 241  
242 242  (((
243 243   Der //deploy_stats_pages// Job ist der erste Job, der in der //deploy//-Stage ausgeführt wird. Der Job erfasst eure Projektarbeitsdaten (bspw. eure Stundenbuchungen) und veröffentlicht diese, nur für euch in GitLab sichtbar, in eurem Projekt.
244 -Die Variablen sind Umgebungsvariablen, die zum Erfassen der Daten benötigt werden. **Die //TIME_FRAMES// Variable ist auskommentiert und sollte durch euren projektverantwortlichen Betreuer:in (Tutor:in) angepasst werden.** Durch die //TIME_FRAMES// Variable können die [[Einschätzungszeiträume>>https://xwiki.swl.informatik.uni-oldenburg.de/xwiki/bin/view/Main/Bewertung/#HBewertungszeitrE4ume]] sowie die "Soll-Zeit" pro Zeitraum gesetzt und für die Visualisierung verwendet werden.
221 +Die Variablen sind Umgebungsvariablen, die zum Erfassen der Daten benötigt werden. **Die //TIME_FRAMES// Variable ist auskommentiert und sollte durch euren projektverantwortlichen Betreuer:in (Tutor) angepasst werden.** Durch die //TIME_FRAMES// Variable können die [[Einschätzungszeiträume>>https://xwiki.swl.informatik.uni-oldenburg.de/xwiki/bin/view/Main/Bewertung/#HBewertungszeitrE4ume]] sowie die "Soll-Zeit" pro Zeitraum gesetzt und für die Visualisierung verwendet werden.
245 245  Im Script-Bereich wird erst git installiert und dann die Projekete zur Erfassung und Visualisierung der Daten installiert.
246 246  Der Artifakt-Bereich definiert welche Dateien nach Ausführung des Jobs behalten werden. Der Public Ordner wird verwendet, um statische Websiten zu veröffentlichen. In diesem Fall die Visualisierung der erfassten Daten.
247 247  Im Gegensatz zum //verify-job// wird der //deploy_stats_pages//-Job **nur** ausgeführt, wenn die Pipeline zeitgesteuert gestartet wird.
... ... @@ -278,44 +278,4 @@
278 278   when: always
279 279   - when: never
280 280  {{/code}}
281 -
282 -----
283 -
284 -= GitLab Pages (Einsehen der erfassten Projektdaten) =
285 285  )))
286 -
287 - Wie im vorherigen Abschnitt beschrieben, werden im Softwareprojekt mit Hilfe der Pipeline Daten erfasst. Diese Daten können dann aus GitLab eingesehen werden, dazu kann man im Projekt über Deploy -> Pages und das Parallele Deployment "stats" die Daten einsehen.
288 -[[image:Deploy->Pages.png||alt="Pages können im Projekt über Deploy -> Pages eingesehen werden"]][[image:ParallelDeploymentsStats.png||height="174" width="1226"]]
289 -
290 -== User Overview ==
291 -
292 -Auf der Seite User overview wird eine kompakte Übersicht aller Projektmitglieder dargstellt. Nutzer:innen werden nicht dargestellt, solange keine Zeitbuchung getätigt wurde.
293 -[[image:Useroverview.png]]
294 -
295 -== Timelogs ==
296 -
297 -Unter Timelogs können einzelne Zeiteintragungen eingesehen werden. Dazu gibt es einige Filtermöglichkeiten, sowie die Möglichkeit nach Zeiträumen zu filtern. In Tabellenform lassen sich die Einträge einzelner Tage anklicken, um eine detailliertere Beschreibung einsehen zu können.
298 -
299 -[[image:TimeLogs.png]]
300 -
301 -== Request (und Review) Overview ==
302 -
303 -Auf der Seite Request Overview können alle im Projekt erstellten Merge Requests eingesehen werden. Unter dem Diagramm ist zusätzlich eine Tabelle zu sehen, die neben der Anzahl im Diagramm noch weitere Informationen wie bspw. Titel und Status beinhaltet. Die Daten lassen sich nach Zielbranch (interessant ist hier Development) und Nutzer:in (durch einen Klick im Tortendiagramm) filtern. Die Seite Review Overview ist vom Verhalten analog gestaltet.
304 -
305 -[[image:RequestOverview.png]]
306 -
307 -== Code Contribution ==
308 -
309 -Die Code Contribution Seite zeigt grafisch aufbereitete Informationen über die Menge an geschriebenem Code und die Zahl der Commits. Der Nutzer kann zwischen verschiedenen Diagrammtypen wählen (tägliche, monatliche oder Gesamtsummen für Code-nderungen bzw. Commits) und über Filter den dargestellten Zeitraum einschränken. Auch die Skalierung der Y-Achse kann angepasst werden.
310 -
311 -[[image:Codecontribution.png]]
312 -
313 -== Target Time ==
314 -
315 -Die Target Time Seite ermöglicht die Auswertung der Arbeitszeit im Vergleich zur erwarteten Mindestarbeitszeit über definierte Zeiträume hinweg. Die Zeiträume müssen für eine Verwendung der Seite vom **Betreuer der Gruppe** (Tutor) in der GitLab Pipeline als Variable gesetzt sein (siehe Abschnitt zur Pipeline im Basisprojekt2). Wenn alles gesetzt ist, dann kann über die Seite eingesehen werden, wie viel Zeit im Verhältnis der erwarteten Zeit, ins Projekt investiert wurde. **Unter der roten Linie sollte keiner auf Dauer sein.**
316 -
317 -[[image:TargetTime.png]]
318 -
319 -----
320 -
321 -
attach_file 1756157360066-681.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.sbeyer1
Size
... ... @@ -1,1 +1,0 @@
1 -125.1 KB
Content info
attach_file Codecontribution.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.sbeyer1
Size
... ... @@ -1,1 +1,0 @@
1 -117.3 KB
Content info
attach_file Deploy->Pages.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.sbeyer1
Size
... ... @@ -1,1 +1,0 @@
1 -26.3 KB
Content info
attach_file Iteration1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.pmeyer
Size
... ... @@ -1,1 +1,0 @@
1 -75.4 KB
Content info
attach_file Iteration2.1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.pmeyer
Size
... ... @@ -1,1 +1,0 @@
1 -129.5 KB
Content info
attach_file Iteration2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.pmeyer
Size
... ... @@ -1,1 +1,0 @@
1 -129.5 KB
Content info
attach_file Iteration3.1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.pmeyer
Size
... ... @@ -1,1 +1,0 @@
1 -102.6 KB
Content info
attach_file Label1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.pmeyer
Size
... ... @@ -1,1 +1,0 @@
1 -99.6 KB
Content info
attach_file Meilenstein1.1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.pmeyer
Size
... ... @@ -1,1 +1,0 @@
1 -73.0 KB
Content info
attach_file Meilenstein1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.pmeyer
Size
... ... @@ -1,1 +1,0 @@
1 -86.9 KB
Content info
attach_file Meilenstein2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.pmeyer
Size
... ... @@ -1,1 +1,0 @@
1 -94.0 KB
Content info
attach_file Meilenstein3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.pmeyer
Size
... ... @@ -1,1 +1,0 @@
1 -122.7 KB
Content info
attach_file ParallelDeploymentsStats.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.sbeyer1
Size
... ... @@ -1,1 +1,0 @@
1 -30.7 KB
Content info
attach_file RequestOverview.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.sbeyer1
Size
... ... @@ -1,1 +1,0 @@
1 -109.5 KB
Content info
attach_file TargetTime.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.sbeyer1
Size
... ... @@ -1,1 +1,0 @@
1 -148.9 KB
Content info
attach_file TimeLogs.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.sbeyer1
Size
... ... @@ -1,1 +1,0 @@
1 -125.1 KB
Content info
attach_file Useroverview.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.sbeyer1
Size
... ... @@ -1,1 +1,0 @@
1 -102.6 KB
Content info