Build Lib Wrapper Pipeline

Dieses Repository enthält eine Jenkins Shared Library namens build-lib-wrapper, die zentrale Pipeline-Schritte für Dogu-Anwendungen kapselt. Mithilfe dieser Bibliothek können viele Applikationen mit einer einheitlichen Pipeline bedient werden – Änderungen an der Pipeline-Logik oder Versionsupdates der zugrunde liegenden Libraries müssen dann nur zentral vorgenommen werden.

---

Verwendung in der Jenkinsfile

Verwenden Sie in Ihrer Jenkinsfile folgende Imports, um die globale Bibliothek und die abhängigen Libraries zu laden:

#!groovy
@Library([
  'github.com/cloudogu/build-lib-wrapper@release',
  'ces-build-lib',
  'dogu-build-lib'
]) _

// Now call the sharedBuildPipeline function with your custom configuration.
sharedBuildPipeline([
    // Required parameter
    doguName: "postfix",
    
    // Optional parameters – override defaults here
    preBuildAgent       : 'docker',
    buildAgent          : 'vagrant',
    doguDirectory       : "/dogu",
    namespace           : "official",
    
    // Credentials and git information
    gitUser             : "mmustermann",
    committerEmail      : "[email protected]",
    gcloudCredentials   : "gcloud-mmustermann",
    sshCredentials      : "jenkins-gcloud-mmustermann",
    backendUser         : "mmustermann-setup",
    
    // Additional options
    updateSubmodules    : false,
    shellScripts        : "./resources/logging.sh ./resources/startup.sh ./resources/mask2cidr.sh",
    dependencies        : ["nginx"], // dogusto wait for
    checkMarkdown       : true,
    runIntegrationTests : false,
    cypressImage        : "cypress/included:13.15.2",
    upgradeCypressImage : "cypress/included:13.2.0",

another example:

#!groovy
@Library([
  'github.com/cloudogu/build-lib-wrapper@develop',
  'ces-build-lib', // versioning handled by Global Trusted Pipeline Libraries in Jenkins
  'dogu-build-lib' // versioning handled by Global Trusted Pipeline Libraries in Jenkins
]) _

// Now call the sharedBuildPipeline function with your custom configuration.
sharedBuildPipeline([
    // Required parameter
    doguName: "plantuml",
    
    // Optional parameters – override defaults here
    preBuildAgent       : 'sos',
    buildAgent          : 'sos',
    doguDirectory       : "/dogu",
    namespace           : "official",
    
    // Credentials and git information
    gitUser             : "cesmarvin",
    committerEmail      : "[email protected]",
    gcloudCredentials   : "gcloud-ces-operations-internal-packer",
    sshCredentials      : "jenkins-gcloud-ces-operations-internal",
    backendUser         : "cesmarvin-setup",
    
    // Additional options
    updateSubmodules    : false,
    shellScripts        : "./resources/startup.sh ./resources/opt/apache-tomcat/bin/setenv.sh",
    dependencies        : ["nginx", "mysql", "redis"],
    checkMarkdown       : true,
    runIntegrationTests : true,
    doBatsTests         : true,
    cypressImage        : "cypress/included:13.14.2",
    registryConfig      : """
                            "_global": {
                                "password-policy": {
                                    "must_contain_capital_letter": "false",
                                    "must_contain_lower_case_letter": "false",
                                    "must_contain_digit": "false",
                                    "must_contain_special_character": "false",
                                    "min_length": "1"
                                }
                            }
                          """,
    additionalDependencies: ['official/mysql', 'official/redis'], //dogus that need to be installed
])

Falls Sie eine neue Version testen wollen, können Sie die Version der Library auch direkt überschreiben:

// Standardimport (globale Version)
@Library([
  'github.com/cloudogu/build-lib-wrapper@release',
  'ces-build-lib'  // versioning handled by Global Trusted Pipeline Libraries in Jenkins
  'dogu-build-lib' // versioning handled by Global Trusted Pipeline Libraries in Jenkins
]) _

// Testen einer neuen Version mit Überschreibung
@Library([
  'github.com/cloudogu/build-lib-wrapper@develop',
  '[email protected]' // default Version wird hier überschrieben
]) _