Changes for page GitLab Erklärungen
Last modified by pmeyer on 2025/09/12 04:41
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -189,8 +189,7 @@ 189 189 190 190 Die Pipeline im Basisprojekt ist auf zwei Stages mit jeweils einem Job aufgeteilt und wird im Folgenden Schritt für Schritt erklärt. Ihr dürft im Rahmen des Softwareprojekts, wenn nötig, die Pipeline um weitere Jobs oder Stages erweitern. **Die bestehenden Jobs sollten allerdings **(von Studierenden) **nicht geändert werden.** 191 191 192 -In der //.gitlab-ci.yml //werden zunächst die Stages definiert. Eine Stage ist eine logische Gruppe von Jobs, die in einem bestimmten Abschnitt der Pipeline ausgeführt werden. Jobs in einer Stage werden parallel ausgeführt, es sei denn es wird eine Abhängigkeit in den Jobs definiert. 193 -Wenn alle Jobs in einer Stage (erfolgreich) abgeschlossen sind, startet die nächste Stage. Schlägt ein Job fehl wird die gesamte Pipeline gestoppt, außer es werden Jobs so markiert, dass sie fehlschlagen dürfen. 192 +In der //.gitlab-ci.yml //werden zunächst die Stages definiert. Eine Stage ist eine logische Gruppe von Jobs, die in einem bestimmten Abschnitt 194 194 195 195 {{code language="yaml"}} 196 196 stages: ... ... @@ -197,58 +197,3 @@ 197 197 - verify 198 198 - deploy 199 199 {{/code}} 200 - 201 -Der //verify-job //ist der erste Job, der in der Pipeline definiert ist. Er wird in der //verify-//Stage ausgeführt. Das Image ist ein Docker-Image, welches schon mit einer Java 21 Umgebung eingerichtet ist. Dadurch wird sichergestellt, dass der Job immer die gleiche Umgebung hat ("//but it works on my machine"//). 202 -Im Script-Abschnitt wird dann mvn clean verify ausgeführt. Maven verify baut das Projekt und führt die Tests im Projekt aus. 203 -Die Rules definieren, wann ein Job ausgeführt wird und ob das Fehlschlagen des Jobs erlaubt ist. Regeln werden von oben nach unten ausgewertet. //$CI_PIPELINE_SOURCE == "schedule" //sagt dass der Job bei automatischen Aufrufen über einen zeitgesteuerten Start der Pipeline mit besonderen Einschränkungen ausgeführt werden soll. //allow_failure// erlaubt in dem Fall, dass bei automatischer Ausführung die Pipeline nicht abgebrochen wird, falls sich euer Projekt nicht bauen lässt, damit darauffolgende Jobs weiterhin ausgeführt werden. 204 - 205 -{{code language="yaml"}} 206 -verify-job: 207 - stage: verify 208 - image: eclipse-temurin:21-jdk-alpine 209 - script: 210 - - "./mvnw clean verify" 211 - rules: 212 - - if: $CI_PIPELINE_SOURCE == "schedule" 213 - when: always 214 - allow_failure: true 215 - - when: always 216 - allow_failure: false 217 -{{/code}} 218 - 219 -((( 220 - Der //deploy_stats_pages// Job ist der erste Job, der in der //deploy//-Stage ausgeführt wird. Hier werden 221 - 222 -{{code language="yaml"}} 223 -deploy_stats_pages: 224 - stage: deploy 225 - image: maven:3.9.9-amazoncorretto-21-al2023 226 - variables: 227 - DEVELOPMENT_BRANCH_NAME: "development" 228 - FETCH_MULTITHREAD: "true" #options are true/false 229 - LOGLEVEL: "SHORT" #options are OFF, SHORT, LONG. Has an effect on the amount of logging when data is being added 230 - #TIME_FRAMES: "01.01.2025,31.03.2025,40,Zeitraum01;01.04.2025,31.05.2025,35" #Format start,end,minHours[,name];anotherTimeframe;anotherTimeframe;... 231 - script: 232 - - yum install -y git rsync 233 - - git clone https://gitlab.swl.informatik.uni-oldenburg.de/GA/gitlab2data.git 234 - - cd gitlab2data 235 - - mvn clean package 236 - - java -jar target/GitLab2Data-1.0-SNAPSHOT-jar-with-dependencies.jar 237 - - cd .. 238 - - mkdir -p public/data 239 - - rm -f public/data/*.json 240 - - cp gitlab2data/*.json public/data/ 241 - - git clone https://gitlab.swl.informatik.uni-oldenburg.de/GA/data4visual.git repo 242 - - rsync -av --exclude='data/' --exclude='.git' --exclude='.gitignore' repo/ public/ 243 - artifacts: 244 - paths: 245 - - public 246 - pages: 247 - path_prefix: "stats" #to allow for parallel deployments of the projects own page don't make the stats site the main deployment 248 - expire_in: never 249 - rules: 250 - - if: $CI_PIPELINE_SOURCE == "schedule" 251 - when: always 252 - - when: never 253 -{{/code}} 254 -)))