Hello CI-使用Jenkins自动构建Hexo博客

Author Avatar
j3rry 4月 11, 2021

前言

折腾了下 Jenkins 做了一个 Hello World 项目，可以实现 Hexo 博客的自动构建、部署，顺带做了图片自动上传图床的功能（使用Rclone，此篇不展开讲解）

需求

本地提交并 push 更改到码云仓库之后，服务器自动 pull 并执行构建，然后部署到生产环境中

安装 Jenkins

我的服务器环境是 CentOS 8，参考Jenkins 官方文档安装 Jenkins，如果你正在使用其他 Linux 发行版也可以在这个页面中找到安装方式

安装完成后执行以下命令启动 Jenkins

systemctl start jenkins

用以下命令查看 Jenkins 运行状态

systemctl status jenkins

配置反向代理

这里使用宝塔面板+Nginx 实现反代，在宝塔中创建站点jenkins.edgeless.top，部署 SSL 证书，然后添加反向代理

不过使用宝塔默认配置的反向代理是不正确的，如果这个时候你打开站点然后进入 Jenkins 全局配置就会看到 Jenkins 提示反向代理配置错误，详情可以参考Jenkins 官方文档

点击宝塔站点修改面板中反向代理选项卡中第一个反向代理配置的配置文件按钮修改刚刚的反向代理配置

将location /的配置修改为

    proxy_pass http://127.0.0.1:8080;
    proxy_redirect     default;
    proxy_set_header   Host             $host:$server_port;
    proxy_set_header   X-Real-IP        $remote_addr;
    proxy_set_header X-Forwarded-Host $host:$server_port;
    proxy_set_header X-Forwarded-Server $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;

参考Jenkins 官方文档

配置 Jenkins

访问配置的域名，参考Jenkins 官方文档完成初始化配置后进入 Jenkins 控制台

由于我的仓库托管在 Gitee，这里先安装一个 Gitee 插件以便使用码云的 WebHook 功能触发构建操作

如果你正在使用 Github，系统已经安装了 Github 插件；如果正在使用 Gitlab 等其他托管平台也可以搜索对应的插件使用

点击左侧的系统管理按钮，然后点击插件管理按钮

切换到可选插件选项卡，在搜索框中输入gitee，勾选 Gitee 插件然后点击Download now and install after restart

勾选安装完成后重启Jenkins(空闲时)，等待下载完成后 Jenkins 自动重启安装插件

当 Jenkins 重启完成之后再次进入系统管理，然后进入系统配置

找到Gitee配置，参考Gitee Jenkins 插件文档完成码云接入

由于 Jenkins 默认使用密码为admin的jenkins账户执行命令，如果担心部分命令权限不够可以参考这里或此篇问答的中文翻译将 Jenkins 默认执行用户更改为 root

配置 CI 任务

重新进入首页控制台，点击左上角的新建任务

输入自定义的任务名称，并选中构建一个自由风格的软件项目，点击确定创建任务

第一栏为任务描述，可以自由发挥

第二栏为源码管理，我的源码仓库是公开的所以直接用了 https 协议，如果为私有仓库请自行添加证书

第三栏构建触发器中勾选Gitee webhook 触发构建，可选 WebHook 密码

复制这里出现的 WebHook 链接备用，例如图中的https://jenkins.edgeless.top/gitee-project/Kanuo%20blog

如果需要配置密码，点击右侧生成按钮可以生成随机密码，同样将其复制备用

跳过第四栏，在第五栏中点击增加构建步骤 - 执行shell，填入以下命令

需要提前安装 yarn 和 hexo-cli

# 安装依赖
/usr/local/bin/yarn

# 构建Hexo
/usr/local/bin/hexo g

# 清空生产环境文件夹
rm -rf /www/wwwroot/www.edgeless.top

# 将新版构建移动至生产环境文件夹
mv ./public/ /www/wwwroot/www.edgeless.top/

点击最下方的保存按钮保存配置，点击左侧的立即构建尝试执行构建任务，观察是否存在报错

配置 Gitee WebHook

进入你的源码仓库，点击管理 - WebHook，点击添加 WebHook

URL 填入之前复制的请求地址，如果有密码也填入，然后点击添加

此时码云会发送一条测试请求，可以在项目面板中查看是否出现了这一请求

正常情况下这一请求是无法正确被构建的，因为测试请求缺少了一些必要信息会导致插件在运行 git 命令时出错，详情请参考issue，因此只要看到触发即可认为配置完成

尝试在本地更改源码并推送，观察 Gitee 和 Jenkins 是否正常工作

此页面内容由Kanuo原创，转载请申明出处
本文链接：https://www.edgeless.top/Hello-CI-%E4%BD%BF%E7%94%A8Jenkins%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BAHexo%E5%8D%9A%E5%AE%A2/