:sourcedir: ../../
= General Information

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.yml'
      - 'push-tag-and-version-template.yml'
      - 'sonar-template.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[]
----