jenkins pipeline replace

### 修改和替换 Jenkins Pipeline

对于希望更改或更新 Jenkins Pipeline 的情况，有几种方法可以实现这一目标。通常建议的做法是在版本控制系统中管理 `Jenkinsfile` 文件[^1]。

当需要修改现有的 Pipeline 或者替换其部分内容时：

- **直接编辑 Jenkinsfile**

如果采用的是将 Pipeline 定义于代码库中的方式，则可以直接在源码控制系统的相应分支上编辑 `Jenkinsfile` 文件来调整 Pipeline 行为。这允许团队成员审查变更并通过标准的拉取请求流程应用这些变化。

pipeline {
    agent any
    
    stages {
        stage('Example') {
            steps {
                script {
                    // 原始逻辑
                    echo 'Original Logic'
                    
                    // 替换成新的逻辑
                    sh '''
                        echo Replaced with new commands here.
                    '''
                }
            }
        }
    }
}

- **利用参数化构建**

为了更灵活地处理不同环境下的需求差异，可以通过定义参数的方式让 Pipeline 更具适应性。这样可以在不改变核心脚本的情况下轻松切换不同的设置值[^2]。

parameters {
    string(name: 'BRANCH_NAME', defaultValue: 'main', description: 'Branch to build')
}

stages {
    stage('Checkout Code') {
        when { expression { params.BRANCH_NAME != null && !params.BRANCH_NAME.isEmpty() }}
        steps {
            git branch: "${params.BRANCH_NAME}", url: 'https://github.com/example/repo.git'
        }
    }
}

- **使用共享库**

对于复杂的项目结构或是多个 Pipelines 间存在重复使用的功能模块时，考虑引入 Jenkins Shared Libraries 来封装公共函数和服务。这种方式不仅有助于减少冗余代码量，还便于集中管理和维护通用组件[^3]。

@Library('my-shared-library') _

import com.example.utils.PipelineHelper

def helper = new PipelineHelper()

pipeline {
    ...
    
    stages {
        stage('Custom Stage Using Helper') {
            steps {
                helper.customStep()
            }
        }
    }
}