Phase 0: Global Trusted Shared Library Setup

Duration: 2025-03-21 (4 commits)

Goal: Establish folder structure for Jenkins Shared Library introduction

Problem Solving Process

Code Changes

Before (bfab15f):

// sharedLibraries/resource/StageResults.groovy
package resource

class StageResults {
    static def stageResults = [
        'SUCCESS': 'SUCCESS',
        'FAILURE': 'FAILURE',
        'ABORTED': 'ABORTED',
        'SKIPPED': 'SKIPPED'
    ]
}

After (3be0817):

// sharedLibraries/src/resource/ResultStatus.groovy
package resource

class ResultStatus {
    static final Map<String, String> STAGE_STATUS = [
        'SUCCESS': 'SUCCESS',
        'FAILURE': 'FAILURE',
        'ABORTED': 'ABORTED',
        'SKIPPED': 'SKIPPED'
    ]

    static final Map<String, String> BUILD_STATUS = [
        'SUCCESS': 'SUCCESS',
        'UNSTABLE': 'UNSTABLE',
        'FAILURE': 'FAILURE',
        'ABORTED': 'ABORTED',
        'NOT_BUILT': 'NOT_BUILT'
    ]
}

Duration: 2025-03-27 (6 commits)

Goal: Test how to call Shared Library classes from Jenkinsfile

Test Content

Added/modified various call() methods to ResultStatus.groovy:

// Attempt 1: void method
void Call() {
    each "Here"
}

// Attempt 2: parameter + return
void call(String param) {
    return param
}

// Attempt 3: constructor + instance variable
private String test

ResultStatus(String test) {
    this.test = test
}

void call() {
    return this.test
}

Learning Points: - Scripts in vars/ folder can be called directly via call() method - Classes in src/ folder are used via new ClassName() or import

Duration: 2025-03-31 ~ 2025-04-01 (8 commits)

Goal: Build Service class for Git LFS problem resolution

Problem Situation

1. Git LFS File Missing: LFS-managed files (images, audio) not checked out during pipeline execution
2. Unity Lighting File Missing: WebGL build lighting breaks without LightingData.asset, ReflectionProbe-0.exr files

Solution Process

Code Changes

GitLFSHelper Core Logic (e9d184b):

void checkAndPullUntrackedLFSFiles() {
    try {
        // Check files managed by LFS but not yet downloaded
        String missingFiles = script.sh(
            script: "git lfs ls-files | awk '\$2 == \"-\" {print \$3}'",
            returnStdout: true
        ).trim()

        if (missingFiles) {
            script.echo "Untracked large files detected: ${missingFiles}"
            script.sh 'git lfs pull'
        }
    } catch (Exception e) {
        script.echo "Failed to check for untracked LFS files: ${e.message}"
    }
}

Folder Structure Evolution:

Attempt 1: service/general/GitLFSHelper.groovy
Attempt 2: service/general/prepareWorkspace/GitLFSHelper.groovy
Attempt 3: service/unity/buildProject/LightAndReflectionFileChecker.groovy
Final:     service/general/PrepareWorkspaceService.groovy
           service/unity/BuildProjectService.groovy

Learning Points: - Integrated Helper classes into Service classes for domain-based responsibility separation - Inject script object via constructor to access Jenkins Pipeline context

Duration: 2025-04-13 (3 commits)

Goal: Test Jenkins Global Library Configuration settings

Test Content

Learning Points: - Configuration needed in Jenkins > Manage Jenkins > Configure System > Global Pipeline Libraries - Specify Library name, Git Repository URL, Default Version (branch) - Learned that Library type and Version Control is possible through Library settings

Duration: 2025-04-21 ~ 2025-04-24 (22 commits)

Goal: Apply Global Trusted Shared Library to 5 pipelines

Implementation Steps

Step 1: vars/ Test (d0ed2e2)

// sharedLibraries/vars/sayHello.groovy
def call(String name = 'World') {
    echo "Hello, ${name}! This message came from the global library."
}

Verified @Library('my-simple-lib@main') _ works in Jenkins Global Configuration.

Step 2: Delete Load Shared Library Stage (c47b663)

Before (-63 lines):

def sharedLib
def resultStatus

stage('Load Shared Library') {
    steps {
        script {
            def LIBRARY_PATH = 'sharedLibraries'
            sh """
                cd ${WORKSPACE}/${LIBRARY_PATH} && \
                (rm -rf .git || true) && \
                git init && \
                git add --all && \
                git commit -m 'init'
            """
            def repoPath = sh(returnStdout: true, script: 'pwd').trim() + "/${LIBRARY_PATH}"
            sharedLib = library identifier: 'local-lib@master',
                    retriever: modernSCM([$class: 'GitSCMSource', remote: "${repoPath}"]),
                    changelog: false
        }
    }
}

// Usage
resultStatus = sharedLib.resource.ResultStatus
currentBuild.result = resultStatus.BUILD_STATUS.ABORTED

After (+6 lines):

@Library('my-simple-lib@main') _

import resource.ResultStatus

// Usage
currentBuild.result = ResultStatus.BUILD_STATUS.ABORTED

Step 3: new Operator Syntax Fix (323823c)

Before (Local Library approach):

prepareWorkspaceService = sharedLib.service.general.PrepareWorkspaceService
prepareWorkspaceServiceClass = prepareWorkspaceService.new(this)

After (Global Library approach):

import service.general.PrepareWorkspaceService

PrepareWorkspaceService prepareWorkspaceService = new PrepareWorkspaceService(this)

Problem: With Local Library, sharedLib.xxx.ClassName returns a wrapped form rather than a Class object, requiring .new() syntax. With Global Library, direct import allows standard Groovy syntax.

Step 4: Applied to 5 Pipelines