201wita20/htlle-da-vorlage
1
0
Fork 0
forked from Hg/htlle-da-vorlage
Code Pull Requests Activity

add branch option to build job

Browse Source
This commit is contained in:
Clemens Lauermann 2020-04-19 18:50:53 +02:00
parent 3c7c3774bf
commit 1f7907f0d2
2 changed files with 14 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
Jenkinsfile vendored
View File

@ -11,12 +11,17 @@ pipeline {
name: 'REPOSITORY', name: 'REPOSITORY',
defaultValue: 'itsp.htl-leoben.at/git/Hg/HTLLE-DA-Vorlage.git', defaultValue: 'itsp.htl-leoben.at/git/Hg/HTLLE-DA-Vorlage.git',
description: 'URL git-Repository DA//' description: 'URL git-Repository DA//'
) )
string( string(
name: 'GIT_PATH', name: 'GIT_PATH',
defaultValue: './', defaultValue: './',
description: "Pfad zur DA in git (z.B.: dipl/)" description: "Pfad zur DA in git (z.B.: dipl/)"
) )
string(
name: 'GIT_BRANCH',
defaultValue: '*/master',
description: "Expert: Wenn Sie einen anderen als den 'master' Branch bauen möchten"
)
} }
stages { stages {
@ -40,12 +45,14 @@ pipeline {
if(env.GIT_PATH.startsWith("~/")) { if(env.GIT_PATH.startsWith("~/")) {
env.GIT_PATH = env.GIT_PATH.substring(2, (env.GIT_PATH.length() - 1)) env.GIT_PATH = env.GIT_PATH.substring(2, (env.GIT_PATH.length() - 1))
} }
// be sure branch is set
env.GIT_BRANCH = params.GIT_BRANCH ?: '*/master'
} }
// checkout out the repository including submodules // checkout out the repository including submodules
// builduser acc used in git // builduser acc used in git
checkout([ checkout([
$class: 'GitSCM', $class: 'GitSCM',
branches: [[name: '*/master']], branches: [[name: "${env.GIT_BRANCH}"]],
doGenerateSubmoduleConfigurations: false, doGenerateSubmoduleConfigurations: false,
extensions: [[ extensions: [[
$class: 'SubmoduleOption', $class: 'SubmoduleOption',

6
README.md
View File

@ -62,7 +62,7 @@ Wenn Sie mit einer neuen Diplomarbeit beginnen, dann gehen Sie am besten wie fol
### Erstellen eines leeren GIT Repositories in dem Sie Ihre DA Daten verwalten werden. ### Erstellen eines leeren GIT Repositories in dem Sie Ihre DA Daten verwalten werden.
Es ist prinzipiell egal auf welchem GIT Server sie Ihr Repository hosten. Wir empfehlen dies aber auf dem HTL eigenen `https://itsp.htl-leoben.at/git` Server zu machen. **Sollten Sie Ihre Arbeit auf einem anderen Server hosten, dann achten Sie darauf dass sie ein privates Repository verwenden** denn sonst wäre der Inhalt der Arbeit bereits (unabsichtlich) veröffentlicht und beim Plagiatscheck würde Ihre gesamte Arbeit als Plagiat aufscheinen - und in weiterer Folge dann abgelehnt werden. Es ist prinzipiell egal auf welchem GIT Server sie Ihr Repository hosten. Wir empfehlen dies aber auf dem HTL eigenen `https://itsp.htl-leoben.at/git` Server zu machen. **Sollten Sie Ihre Arbeit auf einem anderen Server hosten, dann achten Sie darauf dass sie ein privates Repository verwenden** denn sonst wäre der Inhalt der Arbeit bereits (unabsichtlich) veröffentlicht und beim Plagiatscheck würde Ihre gesamte Arbeit als Plagiat aufscheinen - und in weiterer Folge dann abgelehnt werden. Auch am HTL eigenen GIT-Server kann es aus Plagiats-Gründen ratsam sein, für die Diplomarbeit ein privates Repository zu verwenden.
#### Fall 1: Sie beginnen mit einem komplett neuen Repository #### Fall 1: Sie beginnen mit einem komplett neuen Repository
@ -265,7 +265,7 @@ Sollten Sie die notwendigen Tools (pandoc, LaTeX, etc.) nicht lokal installieren
Öffnen Sie dazu den [Jenkins-Job](https://itsp.htl-leoben.at/ci/job/HTLLE-Diplomarbeit/build?delay=0sec) und melden Sie sich ggf. mit Ihren Benutzerdaten (z.B.: `1911wit00`) an. Öffnen Sie dazu den [Jenkins-Job](https://itsp.htl-leoben.at/ci/job/HTLLE-Diplomarbeit/build?delay=0sec) und melden Sie sich ggf. mit Ihren Benutzerdaten (z.B.: `1911wit00`) an.
Für `REPOSITORY` tragen Sie bitte Ihre Repository-URL (z.B: `https://itsp.htl-leoben.at/git/1911wit00/Diplomarbeit.git`) und für `GIT_PATH` ggf. den Unterordner, in dem sich Ihre Diplomarbeit auf GIT befindet (z.B.: `diplomarbeit/`), ein. Für `REPOSITORY` tragen Sie bitte Ihre Repository-URL (z.B: `https://itsp.htl-leoben.at/git/1911wit00/Diplomarbeit.git`) und für `GIT_PATH` ggf. den Unterordner, in dem sich Ihre Diplomarbeit auf GIT befindet (z.B.: `diplomarbeit/`), ein. Wenn Sie nicht wissen was in GIT `branches` sind, brauchen Sie den Parameter `GIT_BRANCH` nicht anpassen.
Beispiel: `GIT_PATH` ist `"text"` Beispiel: `GIT_PATH` ist `"text"`
``` ```
@ -321,6 +321,8 @@ $ tree ~/Diplomarbeit
**Wichtig:** Das fertige PDF wird an die E-Mail Adressen aus `metadata.yaml` verschickt! Die E-Mail Adressen müssen mit `"- build-notification"` gekennzeichnet sein ([siehe oben](#befüllen-der-speziellen-dateien)). **Wichtig:** Das fertige PDF wird an die E-Mail Adressen aus `metadata.yaml` verschickt! Die E-Mail Adressen müssen mit `"- build-notification"` gekennzeichnet sein ([siehe oben](#befüllen-der-speziellen-dateien)).
Das Submodule der Vorlage muss mit dem Namen `HTLLE-DA-Vorlage` hinzugefügt sein (siehe `tree` Ansicht von oben).
### Übertragen des aktuellen Standes nach GIT ### Übertragen des aktuellen Standes nach GIT
Es mach Sinn, die Diplomarbeit (auch nach kleinen Änderungen) immer wieder nach GIT zu übertragen. Damit ist sie optimal gesichert und falls Ihre Teammitglieder auch an der DA Arbeiten bekommen sie auch Zugang zum aktuellsten Stand. Falls Sie noch nicht mit GIT gearbeitet haben, stellen die folgenden Absätze eine (ultra-) [Kurzeinführung](https://rogerdudler.github.io/git-guide/) dar. Es mach Sinn, die Diplomarbeit (auch nach kleinen Änderungen) immer wieder nach GIT zu übertragen. Damit ist sie optimal gesichert und falls Ihre Teammitglieder auch an der DA Arbeiten bekommen sie auch Zugang zum aktuellsten Stand. Falls Sie noch nicht mit GIT gearbeitet haben, stellen die folgenden Absätze eine (ultra-) [Kurzeinführung](https://rogerdudler.github.io/git-guide/) dar.