Jenkinsfile 实现前端项目自动化构建及部署

在当今软件开发领域，持续集成已成为团队协作和高效开发的基石。Jenkins，作为一款广受欢迎的持续集成工具，为开发团队提供了强大的自动化构建、测试和部署功能。本文将通过一个示例，解析Jenkins中的核心概念——Jenkinsfile，并展示其如何定义整个构建过程的流程和规则。

Jenkinsfile在Jenkins中扮演着至关重要的角色。它是一个定义构建流程的文本文件，通常被放置在项目的源代码库中。Jenkinsfile使用Jenkins Pipeline DSL（领域特定语言）编写，允许开发团队以声明式或脚本化的方式描述整个构建流程。

下面，我们将通过一个简单的示例来展示Jenkinsfile的用法

pipeline {
    //可以在任何可用的agent上执行Pipeline或stage
    agent any
    //参数化pipeline可以通过传参来决定pipeline的行为
    parameters {
        string defaultValue: 'test', 
        description: '请输入需要发布的分支', 
        name: 'branch', 
        trim: false
    }
     //使用环境变量当前为全局的，也可以是阶段（stage）级别的
    environment {
        //  定义代码拉取url http://gitlab.XXX.com/abc
	    Code_Url='http://gitlab.XXX.com/abc/'
        //  定义code环境
        Module='BBA'        
        // 定义项目名
        Projectpage='BBA' 
        // 定义用户登录秘钥位置
        Keyfile='/a.key'
       // 定义用户登录主机
        sshroot="root@192.168.1.10"
 }
    //Start Pipeline
    //清理工作目录但排除node_modules目录
    stages {
        stage('Clear Dir'){
            steps{
                script {
                    sh "rm -rf  `ls  | egrep -v node_modules`"
                }
            }
        }        
        
        //从Git仓库检出代码
        stage ('Checkout Code') {
            steps {
                script {
                    //GitSCM表示这是一个Git源代码管理
                    checkout([$class: 'GitSCM', 
                    branches: [[name: '*/$branch']], 
                    extensions: [], 
                    //下面两个定义了远程仓库的凭据和URL
                    userRemoteConfigs: [[credentialsId: '12345678', 
                    url: "${Code_Url}"]]])
                }
            }  

        }
        
        
        stage('nginx_clean') {
            steps {
            //使用sh命令执行shell脚本，通过SSH连接到远程服务器，并删除/home/nginx/BBA目录
             sh  "ssh -i $Keyfile  $sshroot 'rm -rf /home/nginx/BBA'"
        }
        }
        
        
        
         stage('Build Code') {
            steps {
                sh "pwd"
                //设置Yarn的配置，使其忽略引擎要求。
                sh "sudo yarn config set ignore-engines true"
                //安装项目的依赖。
                sh "sudo yarn install"
                //构建项目，可能是为测试环境构建，并指定模块为BBA
                sh "sudo yarn build:test --module=BBA"
                //用SCP命令将构建好的文件（位于$WORKSPACE/dist/$Projectpage）复制到远程服务器的nginx目录下。
                sh "scp -i $Keyfile  -r $WORKSPACE/dist/$Projectpage   $sshroot:/home/nginx/"
                //重新加载nginx服务，使更改生效
                sh  "ssh -i $Keyfile  $sshroot '/home/nginx/sbin/nginx -s reload'"

            } 
        }

        
    }  
    }

上述Jenkinsfile定义了一个简单的构建流程，包括拉取、构建和部署三个阶段。在每个阶段中，我们使用steps块来定义要执行的具体任务。在这个例子中，我们使用了sh步骤来执行Shell命令，如使用yarn进行构建，以及使用scp命令将构建产物部署到远程服务器。

通过Jenkinsfile，我们可以轻松地定义复杂的构建流程，并在Jenkins中自动化执行。Jenkins会解析Jenkinsfile，并根据定义的流程执行相应的任务。这使得开发团队能够更加高效地进行协作开发，快速构建、测试和部署代码。

此外，Jenkinsfile的灵活性还使得开发者能够轻松应对各种复杂的构建需求。无论是多环境部署、条件构建，还是与其他工具的集成，Jenkins都能够通过Jenkinsfile进行灵活的配置，满足项目的特定需求。

综上所述，Jenkins作为一款强大的持续集成工具，通过Jenkinsfile为开发团队提供了便捷的自动化构建和部署方案。它不仅能够提高开发效率和团队协作水平，还能够适应各种复杂的构建需求，成为软件开发过程中不可或缺的一部分。