如何用 jenkins 构建部署项目

关注

原创最新推荐文章于 2026-06-20 11:41:36 发布 408 阅读 AI 写同款· GEO 优化 ›

Jenkins+vue项目自动化构建部署 Jenkins 更新地址：https://sunseekerx.yoouu.cn/common/jenkins.html 更新时间：2020-05-05 20:39:33 Vue项目自动化构建 Jenkins安装查看Docker章节。 Jenkins第一次安装完成最好重启一下，因为如果安装了语言包有些地方还是英文的。应该是个bug。前提 Vue项目+Git 有Jenkins环境有部署项目... 阅读详情

Jenkins（Build great things at any scale）

what is Jenkins

Jenkins是开源 CI（Continuous Integration：持续集成）&CD（Continuous Delivery：持续交付）软件领导者，提供超过 1000 个插件来支持构建、部署、自动化，满足任何项目的需要，支持各种运行方式，可通过系统包, Docker 或者通过一个独立的 Java 程序。

原理： 看图（画图工具）

why use Jenkins

持续集成和持续交付：作为一个可扩展的自动化服务器，Jenkins 可以用作简单的 CI 服务器，或者变成任何项目的连续交付中心。
简易安装：Jenkins 是一个独立的基于 Java 的程序，可以立即运行，包含 Windows，Mac OS X 和其他类 Unix 操作系统。
配置简单：Jenkins 可以通过其网页界面轻松设置和配置，其中包括即时错误检查和内置帮助。
插件：通过更新中心中的 1000 多个插件，Jenkins 集成了持续集成和持续交付工具链中几乎所有的工具。
扩展：Jenkins 可以通过其插件架构进行扩展，从而为 Jenkins 可以做的事提供几乎无限的可能性。
分布式：Jenkins 可以轻松地在多台机器上分配工作，帮助更快速地跨多个平台推动构建，测试和部署。

Install

环境：ubuntu、docker、git

$ cat /etc/issue
Ubuntu 16.04.6 LTS \n \l

拉去镜像
- $ docker pull jenkinsci/blueocean
根据拉取的 Jenkins 镜像启动一个容器
```
  $ docker run \
  -d \
  --name jenkins \
  -u root \
  -p 49001:8080 \
  -v /var/jenkins_home:/var/jenkins_home \
  -v /var/jenkins_ssh:/root/.ssh \
  -v /var/run/docker.sock:/var/run/docker.sock \
  jenkinsci/blueocean
```
解释：
- -d：守护模式，在后台运行。
- -p：端口映射，49001 是服务器端口（可根据自己情况更改，别忘记安全组开放端口），8080 是容器端口（jenkins 程序默认端口）。
- -v：挂载数据卷，/var/jenkins_home:/var/jenkins_home：将 Jenkins 目录挂载到宿主机；/var/jenkins_ssh:/root/.ssh：将 Jenkins 的 ssh 挂载到宿主机，备份用，防止重启后丢失找不到。

查看容器运行情况：

  $ docker ps
  CONTAINER ID      IMAGE                COMMAND                  CREATED        STATUS           PORTS                                NAMES
  08a54d4a804a      jenkinsci/blueocean  "/sbin/tini -- /usr/…"   7 days ago     Up 7 days        50000/tcp, 0.0.0.0:49001->8080/tcp   jenkins

附图：

以上说明已成功，若容器意外退出，去掉-d 参数执行，查看 log 来排错。

现在开始设置 Jenkins，在浏览器访问 你的服务器ip:49001，会出现以下界面：
- 想进入要先解锁，密码就在 /var/jenkins_home/secrets/initialAdminPassword 文件里，怎么查看呢？两种方案：
  1. 首先要进入刚刚启动的 jenkins 容器里面，执行 $ docker exec -it jenkins bash，然后 $ cat /var/jenkins_home/secrets/initialAdminPassword。
  2. 由于运行容器时，已经将 Jenkins 目录挂载到了宿主机，所以可以不用进入容器，直接在宿主机执行 $ sudo cat /var/jenkins_home/secrets/initialAdminPassword。
- 将上一步的密码复制到浏览器，点击 continue 按钮进行下一步。
  附图：
- 安装插件，选择推荐安装即可。

=================================================

上面是基本的安装，我用的是时候官方文档还是英文的，目前支持中文，想了解更详细内容，请去官网，下面开始教大家新建一个 自由构建的任务（鉴于目前网上大都是多机教程，即项目和 jenkins 不在一台服务器上，又考虑到小伙伴们手中可能只有一台自己的机器，所以我下面要讲的是 单机运行项目和 Jenkins）

=================================================

打开 ip:49001进入首页，点击系统管理：
首先点击插件管理，搜索并安装一下插件（若已安装列表已存在可忽略）：
- Build Name Setter
- Dingding[钉钉] Plugin
- Build Timestamp Plugin
- Git Parameter Plug-In
- Publish Over SSH
- SSH Slaves plugin
- Timestamper
然后点击系统设置：
- 找到 Build Timestamp (上面的插件提供的)，进行如下设置：
  - Asia/Shanghai
  - yyyy-MM-dd-HH-mm-ss-SSS
- 找到 Publish over SSH，这个相对麻烦些，进行如下设置：
  
  说明：
  - Passphrase：SSH 的 password。有两种情况：1. 使用 username/password 登录时为 username 的 password；2. 使用私钥登录时为私钥的 password。
  - Path to key：SSH 私钥的文件路径。可以是绝对路径，也可以是相对$JENKINS_HOME 的相对路径。
  - Key：私钥，私钥导出后的文本内容，假设“Key”和“Path to key”都设置，则“Key”的优先级较高，此时“Passphrase”中设置的内容应该是私钥的 password。
  - Disable exec：禁止在目标机上运行命令，勾选后将会忽略在 Job 配置中“Exec command”选项中设置的命令。
  补充：由于 Jenkins 是在 docker 容器中运行的，所以上面的配置应该是容器的 ssh 配置，而不是宿主机的。如上图，我是通过 ssh 私钥进行的登陆。
  
  步骤：
  - $ docker exec -it jenkins sh，进入容器。
  - $ ssh-keygen -m PEM -t rsa -b 4096，生成 ssh 私钥及公钥（默认在 ～/.ssh 即 /root/.ssh 目录中），可以一路回车，若设密码的话，需在“Passphrase”中填写。
  - $ cat ~/.ssh/id_rsa，查看私钥，把私钥 copy 到上图的“key”设置中。
  - $ cat ~/.ssh/id_rsa.pub，查看公钥，把公钥 copy 到宿主机的 ~/.ssh/authorized_keys 中。
  至此，Jenkins 的 ssh 配置就完成了，接下来要配置远程机（咱们是单机，所以宿主机就当成远程机来配置）的 SSH Servers 了：
  
  说明：
  - Name：SSH 节点配置的名称，可随意设置，他将在 job 配置的“SSH Server”的下拉列表中，如图：
  - Hostname：通过 SSH 连接到的机器的主机名或 IP。
  - Username：SSH 服务使用的 username，使用 key 进行连接时为 key 指定的 username。
  - Remote Derictory：运程机器上真实存在的文件夹，而且“Username”指定的用户要有訪问此文件夹的权限。插件将把文件传送到此文件夹下。一般是存放项目的目录。
测试，点击“Test Configuration”按钮，如 success，这配置成功，进行下一步，新建任务。

下面开始新建任务：

在首页点击“新建任务”，输入名称（建议和 github 的项目名称保持一致），选择第一个“构建一个自由风格的软件项目”，然后点击确定：
返回首页，可以列表中看到刚刚新建的任务，点击名称，进入任务详情：

在任务详情页，点击配置，进行项目配置：

配置：

补充：（shell 脚本都在项目的 deploy 目录下）

Exec command：

#!/usr/bin/env bash
echo '************************************** 发送至服务器成功 **********************************************'

# 项目名，取自环境变量
projectName="${JOB_NAME}"
dockerImageName=${projectName}-${BUILD_TIMESTAMP}

# step1 解压源代码
echo " ************************************* 解压源代码${dockerImageName}.tar.gz start *************************************"

projectPath='/var/nodejs/' # 需要单独给用户赋目录/var/nodejs/的权限 sudo chown ubuntu /var/nodejs/
sudo mkdir -p ${projectPath}${projectName} || true \
&& cd ${projectPath}${projectName} \
&& sudo rm -rf *  # 删除里面的数据

sudo tar -zxf ../${dockerImageName}.tar.gz -C ./ \
&& sudo rm  ../${dockerImageName}.tar.gz   # 删除发布过来的包

echo " ************************************* 解压源代码${dockerImageName}.tar.gz finish *************************************"

# step2 构建docker镜像
echo " ************************************* 构建docker镜像${dockerImageName} start *************************************"
sudo docker build -t ${dockerImageName} --force-rm .
echo ' ************************************* 构建docker镜像 finish *************************************'

# step3 重启容器
echo "************************************* 使用镜像${dockerImageName}启动容器${projectName}  start *************************************"
# 错误日志统一存放在/var/nodejs/logs/${projectName}
sudo mkdir -p /var/nodejs/logs/${projectName} || true \
&& sudo docker stop ${projectName} || true \
&& sudo docker rm ${projectName} || true \
&& sudo docker run -d --net=host --name ${projectName} -v /var/nodejs/logs/${projectName}:/var/nodejs/${projectName}/logs ${dockerImageName}

echo "************************************* 使用镜像${dockerImageName}启动容器${projectName}  finish *************************************"

echo '************************************************ 查看docker容器情况: ************************************************ '
sudo docker ps -a
echo '************************************************ 查看docker容器情况: ************************************************ '

如果项目需要在容器里构建，通常初次构建时间相对较长，所以可以把高级设置中的“Exec timeout”设的稍微大一些。

构建-执行 shell-命令：

#!/usr/bin/env sh
projectName="${JOB_NAME}"
dockerImageName=${projectName}-${BUILD_TIMESTAMP}

echo '*********************************** 准备打包从Github仓库拉取的代码...*********************************************'
echo "**********${WORKSPACE}**********"
tar --exclude=node_modules --exclude=.git --exclude='*.tar.gz'  -vzcf /tmp/${dockerImageName}.tar.gz -C  ${WORKSPACE} .  \
&& mv /tmp/${dockerImageName}.tar.gz  ${WORKSPACE} \
&& echo '*********************************** 打包成功 *********************************************' \
&& echo '************************************** 准备发送至服务器... **********************************************'

构建后操作，钉钉通知配置教程

完成项目的任务配置，点击保存。
返回任务详情也，点击“Build with Parameters”，选择分支，点击“开始构建”：
在构建历史列表中，点击最新的一条构建记录，再点“击控制台输出”，可查看构建的 log：

最终 log 输出：Finished: SUCCESS，则成功。v
构建后，钉钉会收到通知。

如果有问题，需要版本回滚怎么办呢？

我们可以新建一个任务用于版本回滚：

回到首页，点击新建，起个名字如：newblog-rollback。

在列表点击 newblog-rollback，进入任务详情，点击配置，进入配置页：

补充：（shell 脚本都在项目的 deploy 目录下）

Exec command：

#!/usr/bin/env sh

trim()
{
    trimmed=$1
    trimmed=${trimmed%% }
    trimmed=${trimmed## }
    echo "$trimmed"
}

# projectName=$(trim "${container_name}")
projectName="newblog"

dockerImageName=$(trim "${image_name}")

echo "******************************************* 回退到镜像${image_name} ，并启动容器${container_name} **************** *******************************"
sudo mkdir -p /var/nodejs/logs/${projectName} || true \
&& sudo docker stop ${projectName} || true \
&& sudo docker rm ${projectName} || true \
&& sudo docker run -d --net=host --name ${projectName} -v /var/nodejs/logs/${projectName}:/var/nodejs/${projectName}/logs ${dockerImageName}
echo "************************************* 使用镜像${dockerImageName}启动容器${projectName}  finish *************************************"