jenkins怎样写流水线

下面给你一个从入门到常用写法的 Jenkins 流水线（Pipeline）教程，基于 Jenkinsfile（最推荐方式）。

一、Jenkins 流水线是什么？

Jenkins 流水线是一段定义构建、测试、部署流程的代码，通常写在 Jenkinsfile 里，放在代码仓库中。

两种类型：

1. Declarative Pipeline（声明式，推荐）
2. Scripted Pipeline（脚本式，灵活但复杂）

二、最简示例（声明式 Pipeline）

pipeline {
    agent any

    stages {
        stage('Build') {
            steps {
                echo 'Building...'
            }
        }
        stage('Test') {
            steps {
                echo 'Testing...'
            }
        }
        stage('Deploy') {
            steps {
                echo 'Deploying...'
            }
        }
    }
}

✅ 保存为 Jenkinsfile，在 Jenkins 中新建 Pipeline 任务 即可运行。

三、常用结构详解

1️⃣ agent（指定运行节点）

agent any

或指定节点：

agent { label 'linux' }

2️⃣ stages / stage（阶段）

stages {
    stage('Clone') {
        steps {
            git 'https://github.com/your/repo.git'
        }
    }
}

3️⃣ steps（具体步骤）

常见命令：

steps {
    sh 'mvn clean package'
    bat 'gradlew build'   // Windows
    echo 'Hello'
}

4️⃣ 环境变量

environment {
    VERSION = '1.0.0'
}

steps {
    echo "Version: ${VERSION}"
}

5️⃣ 拉取代码

stage('Checkout') {
    steps {
        git branch: 'main', url: 'https://github.com/xxx/xxx.git'
    }
}

四、真实示例（Java + Maven）

pipeline {
    agent any

    environment {
        JAVA_HOME = '/usr/lib/jvm/java-11'
    }

    stages {
        stage('Checkout') {
            steps {
                git 'https://github.com/your/repo.git'
            }
        }

        stage('Build') {
            steps {
                sh 'mvn clean package'
            }
        }

        stage('Test') {
            steps {
                sh 'mvn test'
            }
        }

        stage('Deploy') {
            steps {
                sh 'scp target/app.jar server:/app/'
            }
        }
    }
}

五、条件执行

stage('Deploy') {
    when {
        branch 'main'
    }
    steps {
        echo 'Deploy only on main'
    }
}

六、Post（构建后操作）

post {
    success {
        echo 'Build success'
    }
    failure {
        echo 'Build failed'
    }
}

七、使用凭据（Credentials）

environment {
    TOKEN = credentials('my-token-id')
}

steps {
    sh 'curl -H "Token: $TOKEN" ...'
}

八、Jenkins 图形界面怎么用？

1. 新建任务 → Pipeline
2. 选择：
   • Pipeline script（直接写）
   • Pipeline script from SCM（推荐，用 Jenkinsfile）

九、学习建议

✅ 从 声明式 Pipeline 开始
✅ 把 Jenkinsfile 放进 Git
✅ 逐步加：测试 → 构建 → 部署 → 通知

如果你愿意，可以告诉我：

• 用的什么语言（Java / Node / Python / Go）
• 是否 Docker / K8s
• 是否多环境（dev / test / prod）

我可以直接帮你写一份可用的 Jenkinsfile。