使用Jenkins部署React项目的方法步骤


Posted in Javascript onMarch 11, 2019

背景

公司的前端项目部署方式比较简单,整个过程基本上是手动的;

目标

通过工具实现以下几个任务:

  • 编译、部署自动化;
  • 选择指定版本进行回滚;
  • 区分不同的分支(环境);

技术方案

  • 选用 jenkins 作为部署工具;也便于后续 CI 的接入;
  • 使用 docker 进行编译,确保每次编译的环境的稳定;

步骤

步骤一:搭建 Jenkins

搭建 Jenkins 有很多方案,这里选择使用 docker 搭建。

docker-compose.yml 的内容如下:

version: '3'
services:
 fejenkins:
  user: root
  image: jenkinsci/blueocean
  ports:
   - "8080:8080"
   - "50000:50000"
  volumes:
   - /data/jenkins_home:/var/jenkins_home
   - /data/nm_cache:/var/nm_cache
   - /var/run/docker.sock:/var/run/docker.sock

通过 docker-compose up 命令启动;启动后通过初始密码进行第一个用户的创建和 Jenkins 初始化的一些列操作,初始密码会打印在 jenkins docker 启动命令行的输出中,注意查看。

当然也可以不使用 docker-compose:

docker run --rm -u root -v /data/jenkins_home:/var/jenkins_home -v /data/nm_cache:/var/nm_cache -v /var/run/docker.sock:/var/run/docker.sock -p 8080:8080 -p 50000:50000 jenkinsci/blueocean

稍做解释:

  • /data/jenkins_home:/var/jenkins_home /var/jenkins_home 是 jenkinsci image 的默认数据存放路径,这里将路径映射到宿主机的指定文件夹;
  • /data/nm_cache:/var/nm_cache nm_cache 涵义是 node_modules cache,顾名思义,这里是想对编译所需的 node_modules 做缓存,将缓存文件夹也映射到宿主机;
  • /var/run/docker.sock:/var/run/docker.sock 这里是将宿主机运行 docker 后产生的 sock 文件映射到了 jenkins container 中。这样,jenkins 中使用 docker 进行编译时,其实是使用宿主机的 docker 来运行的,而不是在 docker container 中又启动了 docker。这里稍微有点绕,若是暂时看不明白,需要找一些深入介绍 docker 的文章阅读;

步骤二:配置 Jenkins

添加 Credentials

通过 Jenkins 进行 git 操作需要对应 git repo 的权限,这里需要用到有 git repo 权限的密钥文件。同样,通过 Jenkins 将编译产物 scp 到服务器上的时候,也需要服务器的密钥文件。

这两类密钥文件需要配置在 Jenkins 中,在:Jenkins > Credentials > System > Global credentials (unrestricted) 里进行 Add Credentials 的操作。

添加 Jenkins Item

Jenkins > New Item,然后选择 Pipeline,在下面的 Pipeline 配置区域的 Definition 中选择 Pipeline script,Script 如下:

pipeline {
  environment {
    SERVER_IP_1 = "11.22.33.44"
    SERVER_CREDENTIALSID = "abcd1234-abcd-abcd-abcd-abcd1234abcd"
    SERVER_DEPLOY_DIR = "/your/www/path/"

    CACHE_DIR = "/var/nm_cache/your_project_name/"

    GIT_URL = "git@github.com:example/example.git"
    GIT_BRANCH = "master"
    GIT_CREDENTIALSID = "abcd1234-abcd-abcd-abcd-abcd1234abcd"
  }
  agent none
  stages {
    stage('Checkout code') {
      agent any
      steps {
        git (
          branch: "${GIT_BRANCH}",
          credentialsId: "${GIT_CREDENTIALSID}",
          url: "${GIT_URL}",
          changelog: true
        )
        sh '''
          ls -al
          cache_dir="${CACHE_DIR}"
          cache_nm="${CACHE_DIR}node_modules"
          cache_lock="${CACHE_DIR}yarn.lock"

          if [ ! -d "$cache_dir" ]; then mkdir ${cache_dir}; fi
          if [ ! -d "$cache_nm" ]; then mkdir ${cache_nm}; fi
          if [ -d "$cache_nm" ]; then ln -sf ${cache_nm} ./; fi
          if [ -f "$cache_lock" ]; then mv -n ${cache_lock} .; fi

          ls -al
        '''
      }
    }
    stage('Build') {
      agent {
        docker {
          image 'node:8-alpine'
          args ''
        }
      }
      steps {
        sh '''
          npm config set registry https://registry.npm.taobao.org
          yarn install
          yarn build
          tar -cvf build.tar build

          ls -al
          mv ./yarn.lock ${CACHE_DIR}
          rm -rf ./node_modules
          ls -al
        '''
        archiveArtifacts artifacts: 'build.tar', fingerprint: true
      }
    }
    stage('Deploy') {
      agent any
      steps {
        unarchive mapping: ['build.tar': 'build.tar']
        echo '--- Deploy ---'

        sshagent(["${SERVER_CREDENTIALSID}"]) {
         sh "scp -o StrictHostKeyChecking=no build.tar root@${SERVER_IP_1}:${SERVER_DEPLOY_DIR}"
         sh "ssh -o StrictHostKeyChecking=no root@${SERVER_IP_1} \"rm -rf ${SERVER_DEPLOY_DIR}build; tar -xvf ${SERVER_DEPLOY_DIR}build.tar -C ${SERVER_DEPLOY_DIR}\""
        }

      }
    }
  }
}

稍做解释:

这个部署脚本分为三个步骤:

  • Checkout code(在指定 git 仓库通过指定证书文件获取代码)
  • Build(通过指定命令进行编译,将编译后的产物存档)
  • Deploy(通过指定命令部署)

在 Build 阶段前后,我们各做了一些工作,以求每次部署可以复用 node_modules,因为下载 node_modules 的时间可能很长,而并不是每次都会修改 package.json,所以其实 node_modules 大概率可以复用;

编译前:

  • 看指定 node_modules 缓存文件夹是否存在,不存在则新建该文件夹;
  • 看缓存文件夹中是否有 node_modules 文件夹,如果没有则新建该文件夹;并且将该文件夹软连接到当前目录;
  • 看缓存文件夹中是否有 yarn.lock 文件,如果有则移动到当前文件夹;

编译后:

  • 移除 node_modules 文件夹的软连接;
  • 将 yarn.lock 文件移动到缓存文件夹中;

这里使用了 yarn install 的某些特性:

  • 没有 node_modules 或者 yarn.lock 时会安装全量依赖;
  • 有 node_modules 和 yarn.lock 但是 yarn.lock 和 package.json 不匹配时,会安装所需依赖;
  • 有 node_modules 和 yarn.lock,且 yarn.lock 和 packge.json 配置时,跳过安装依赖;

使用

编译和部署

编译和部署直接点击 Build Now 即可;

回滚

回滚的本质其实是:重新部署某个历史版本。在 Build History 找到想要重新部署的版本,点击 Restart from Stage,在新页面中选择 Stage Name 为 Deploy。

其他

若是想要进入 docker container 交互,可以通过以下命令

docker exec -i -t [dockername] /bin/bash

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Javascript 相关文章推荐
可以把编码转换成 gb2312编码lib.UTF8toGB2312.js
Aug 21 Javascript
javascript 冒泡排序 正序和倒序实现代码
Dec 14 Javascript
jQuery 动态云标签插件
Nov 11 Javascript
js创建对象的方法汇总
Jan 07 Javascript
JS中的eval 为什么加括号
Apr 13 Javascript
AngularJS实现Input格式化的方法
Nov 07 Javascript
canvas实现刮刮卡效果
Mar 14 Javascript
详解Angular4 路由设置相关
Aug 26 Javascript
使用Karma做vue组件单元测试的实现
Jan 16 Javascript
jQuery 动画与停止动画效果实例详解
May 19 jQuery
浅谈element中InfiniteScroll按需引入的一点注意事项
Jun 05 Javascript
vue 动态添加的路由页面刷新时失效的原因及解决方案
Feb 26 Vue.js
vue基础之v-bind属性、class和style用法分析
Mar 11 #Javascript
配置eslint规范项目代码风格
Mar 11 #Javascript
vue基础之事件简写、事件对象、冒泡、默认行为、键盘事件实例分析
Mar 11 #Javascript
vue基础之事件v-onclick="函数"用法示例
Mar 11 #Javascript
每天学点Vue源码之vm.$mount挂载函数
Mar 11 #Javascript
JavaScript中常用的简洁高级技巧总结
Mar 10 #Javascript
angular 实现下拉列表组件的示例代码
Mar 09 #Javascript
You might like
使用PHP uniqid函数生成唯一ID
2015/11/18 PHP
PHP基于递归算法解决兔子生兔子问题
2018/05/11 PHP
JXTree对象,读取外部xml文件数据,生成树的函数
2007/04/02 Javascript
学习ExtJS form布局
2009/10/08 Javascript
Jquery 实现Tab效果 思路是js思路
2010/03/02 Javascript
js bind 函数 使用闭包保存执行上下文
2011/12/26 Javascript
js 中的switch表达式使用示例
2020/06/03 Javascript
解决Extjs4中form表单提交后无法进入success函数问题
2013/11/26 Javascript
javascript中的nextSibling使用陷(da)阱(keng)
2014/05/05 Javascript
jquery访问ashx文件示例代码
2014/08/11 Javascript
Node.js中使用Buffer编码、解码二进制数据详解
2014/08/16 Javascript
多个js毫秒倒计时同时进行效果
2016/01/05 Javascript
微信小程序 Video API实例详解
2016/10/02 Javascript
Ext JS 实现建议词模糊动态搜索功能
2017/05/13 Javascript
JS实现前端动态分页码代码实例
2020/06/02 Javascript
原生js实现自定义难度的扫雷游戏
2021/01/22 Javascript
[45:16]完美世界DOTA2联赛循环赛 IO vs FTD BO2第二场 11.05
2020/11/06 DOTA
python 获取本机ip地址的两个方法
2013/02/25 Python
Python中优化NumPy包使用性能的教程
2015/04/23 Python
梯度下降法介绍及利用Python实现的方法示例
2017/07/12 Python
Python While循环语句实例演示及原理解析
2020/01/03 Python
在pytorch中对非叶节点的变量计算梯度实例
2020/01/10 Python
Tensorflow与Keras自适应使用显存方式
2020/06/22 Python
python能做哪些生活有趣的事情
2020/09/09 Python
英国领先的高级美容和在线皮肤诊所:Face the Future
2020/06/17 全球购物
联想C++笔试题
2012/06/13 面试题
军训考核自我鉴定
2014/02/13 职场文书
生活部的活动方案
2014/08/19 职场文书
软件测试专业推荐信
2014/09/18 职场文书
2016自主招生教师推荐信范文
2015/03/23 职场文书
教师思想工作总结2015
2015/05/13 职场文书
Java实现简易的分词器功能
2021/06/15 Java/Android
常用的文件对应的MIME类型汇总
2022/04/26 HTML / CSS
python解析json数据
2022/04/29 Python
设置IIS Express并发数
2022/07/07 Servers
win10双系统怎么删除一个系统?win10电脑有两个系统删除一个的操作方法
2022/07/15 数码科技