Jenkins如何在Linux上实现自动化部署 - 问答

1. 准备Linux服务器环境

在开始配置前，需确保Linux服务器（如Ubuntu 22.04/CentOS 7）满足基础要求：

安装Java环境：Jenkins依赖Java运行，推荐安装OpenJDK 11及以上版本（如sudo apt install openjdk-11-jdk -y）。
安装Git：用于从代码仓库（如GitHub、GitLab）拉取最新代码（sudo yum install git -y或sudo apt install git -y）。
生成SSH密钥：将服务器公钥添加到代码仓库（如GitHub），实现Jenkins无密码访问。执行ssh-keygen -t rsa -C "your_email@example.com"，将生成的~/.ssh/id_rsa.pub内容复制到仓库的SSH Keys设置中。

2. 安装与配置Jenkins

安装Jenkins：
- Ubuntu/Debian：添加Jenkins官方仓库并安装（wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -；sudo sh -c 'echo deb http://pkg.jenkins.io/debian stable binary/ > /etc/apt/sources.list.d/jenkins.list'；sudo apt update && sudo apt install jenkins -y）。
- CentOS/RHEL：使用YUM仓库安装（sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat/jenkins.repo；sudo rpm --import https://pkg.jenkins.io/redhat/jenkins.io.key；sudo yum install jenkins -y）。
启动服务：sudo systemctl start jenkins；sudo systemctl enable jenkins（设置开机自启）。
访问Web界面：浏览器输入http://<服务器IP>:8080，使用/var/lib/jenkins/secrets/initialAdminPassword中的初始密码登录，完成初始设置（如安装推荐插件）。

3. 配置Jenkins必要插件

进入“Manage Jenkins”→“Manage Plugins”，安装以下核心插件：

Git Plugin：用于拉取代码仓库中的代码。
Pipeline Plugin：支持定义自动化部署流水线（如声明式/脚本式Pipeline）。
Publish Over SSH：通过SSH将构建产物传输到目标服务器。
Maven Integration Plugin（可选）：若项目使用Maven构建，需安装此插件以调用Maven命令。

4. 关联Linux服务器与Jenkins

开启SSH服务：确保Linux服务器SSH服务运行（sudo systemctl status ssh），若未开启则执行sudo systemctl start ssh。
添加SSH节点：
1. 进入Jenkins“Manage Jenkins”→“Manage Nodes and Clouds”→“New Node”。
2. 输入节点名称（如linux-server），选择“Permanent Agent”，点击“OK”。
3. 配置节点信息：
  - Remote root directory：设置为Linux上的Jenkins工作目录（如/home/jenkins，需提前创建）。
  - Credentials：添加SSH凭据（选择“SSH Username with private key”，输入Linux服务器用户名及私钥内容）。
4. 点击“Test Connection”，确认连接成功后保存。

5. 创建自动化部署Pipeline

新建Pipeline任务：进入Jenkins主页，点击“New Item”，输入任务名称（如auto-deploy-maven），选择“Pipeline”，点击“OK”。

配置Pipeline脚本：

Pipeline script from SCM（推荐）：从代码仓库拉取Pipeline脚本（如Jenkinsfile），需指定SCM类型（如Git）、仓库URL（如https://github.com/your-repo/project.git）及分支（如main）。

Pipeline script（直接编写）：适用于简单流程，示例如下：

pipeline {
    agent any
    tools {
        maven 'Maven 3.8.6'  // 需在“Manage Jenkins”→“Global Tool Configuration”中配置Maven
        jdk 'OpenJDK 11'    // 配置JDK
    }
    stages {
        stage('Checkout') {
            steps {
                git branch: 'main', url: 'https://github.com/your-repo/project.git'
            }
        }
        stage('Build') {
            steps {
                sh 'mvn clean package'  // Maven项目构建
                // sh './gradlew build'  // Gradle项目构建
            }
        }
        stage('Test') {
            steps {
                sh 'mvn test'  // 运行单元测试
            }
        }
        stage('Deploy') {
            steps {
                sshPublisher(
                    publishers: [
                        sshPublisherDesc(
                            configName: 'linux-server',  // 关联的SSH节点名称
                            verbose: true,
                            transfers: [
                                sshTransfer(
                                    sourceFile: 'target/*.jar',  // 构建产物路径（Maven）
                                    // sourceFile: 'build/libs/*.jar',  // Gradle
                                    removePrefix: 'target',      // 移除前缀
                                    remoteDirectory: '/opt/app'  // 目标服务器部署路径
                                )
                            ]
                        )
                    ]
                )
                // 若需重启服务（如Spring Boot），可添加以下命令：
                // sshPublisher(
                //     publishers: [
                //         sshPublisherDesc(
                //             configName: 'linux-server',
                //             verbose: true,
                //             command: 'systemctl restart app.service'
                //         )
                //     ]
                // )
            }
        }
    }
    post {
        always {
            junit 'target/surefire-reports/*.xml'  // 发布测试报告
        }
        success {
            echo 'Deployment succeeded!'
        }
        failure {
            echo 'Deployment failed!'
        }
    }
}

6. 触发自动化部署

轮询SCM：在Pipeline配置的“Build Triggers”中勾选“Poll SCM”，设置轮询间隔（如H/5 * * * *表示每5分钟检查一次代码仓库是否有更新）。
Webhook触发（推荐）：在代码仓库（如GitHub）设置Webhook，指向Jenkins服务器的http://<服务器IP>:8080/github-webhook/，当代码推送时自动触发构建。
手动触发：在Jenkins任务页面点击“Build Now”，手动启动部署流程。

7. 验证与调试

查看构建日志：在Pipeline任务页面点击“Build History”，选择具体构建记录，查看“Console Output”中的详细日志，定位错误（如代码编译失败、SSH连接问题）。
检查目标服务器：登录Linux服务器，查看/opt/app目录下是否有最新构建的产物（如.jar文件），确认服务是否重启（如systemctl status app.service）。

通过以上步骤，可实现Jenkins在Linux环境下的自动化部署流程，覆盖代码拉取、构建、测试、传输及部署全链路。根据项目需求（如Docker容器化、前端项目），可扩展Pipeline脚本（如添加Docker构建步骤、Vue项目npm run build命令）。

0 赞

0 踩