71 lines
2.2 KiB
Plaintext
71 lines
2.2 KiB
Plaintext
:sourcedir: ../../
|
|
= General Information
|
|
|
|
== Templates und Pipelines
|
|
|
|
In dieser Repository sind Templates und Pipeline-Templates zu finden.
|
|
Templates sind vorgefertigte Jobs die jeweils einen Use-Case abbilden sollen und direkt importiert werde können.
|
|
|
|
Da eine CI jedoch aus Pipelines besteht und Gitlab die Möglichkeit Multiprojekt- und child-Pipelines zu benutzen werden hier auch vorgefertigte bereit gestellt. Diese Pipeline-Templates bilden komplexere Use-Cases ab.
|
|
Pipelines sind in dem dafür vorgesehenen Pipeline Ordner zu finden.
|
|
|
|
== Wie können Templates benutzt werden
|
|
|
|
Um die Templates in deinem Projekt zu benutzten musst du folgendes machen:
|
|
|
|
1. `Include` das Template file in deinem `.gitlab-ci.yaml` File.
|
|
2. Jetzt kannst du `extend` benutzen, um das Template zu integrieren.
|
|
Es ist möglich weitere Veränderungen vorzunehmen.
|
|
|
|
[source,yaml]
|
|
----
|
|
stages:
|
|
- test-image
|
|
|
|
include:
|
|
- project: 'gilden/ci/gitlab-ci-templates'
|
|
ref: 'master'
|
|
file:
|
|
- 'maven-build-template.gitlab-ci.yml'
|
|
- 'maven-dependencies-template.gitlab-ci.yml'
|
|
- 'maven-verify-template.gitlab-ci.yml'
|
|
- 'npm-build-template.gitlab-ci.yml'
|
|
- 'npm-dependencies-template.gitlab-ci.yml'
|
|
- 'npm-lint-template.gitlab-ci.yml'
|
|
- 'npm-test-template.gitlab-ci.yml'
|
|
- 'container-publish.gitlab-ci.yml'
|
|
- 'container-scan.gitlab-ci.yml'
|
|
- 'set-version-template.gitlab-ci.yml'
|
|
- 'push-tag-and-version-template.gitlab-ci.yml'
|
|
|
|
|
|
test-image:
|
|
stage: test-image
|
|
extends: .build-image
|
|
when: manual
|
|
except:
|
|
- master
|
|
- tags
|
|
before_script:
|
|
- cd ImportantPath
|
|
----
|
|
|
|
[[Generel-Variablen]]
|
|
== Generelle Variablen
|
|
|
|
Bitte folgende Variablen in `.gitlab-ci.yaml` setzen
|
|
|
|
|===
|
|
|Name |Description
|
|
|CI_REGISTRY| Registry der CI
|
|
|MAVE_IMAGE| Das Image das benutzt werden soll für Jobs die Maven benötigen.
|
|
|NODE_IMAGE| Das Image das benutzt werden soll für Jobs die NPM benötigen
|
|
|MAVEN_OPTS| Generelle optionen um Maven zu verändern
|
|
|MAVEN_CLI_OPTS| Optionen um Maven beim Bauen zu verbessern.
|
|
|FRONTEND_DIR| Wenn das Projekt ein Frontend besitzt, muss der Pfad definiert werden, wo die note module gespeichert werden.
|
|
|===
|
|
|
|
----
|
|
include::{sourcedir}/STD-variablen-Template.gitlab-ci.yml[]
|
|
----
|