Git + Jenkins 自动化 NGINX 发布简易实现

本文最后更新于:2024年7月24日 晚上

概述

之前基于 GitLab + Jenkins 实现了简单的 NGINX 的自动化发布。
具体包含如下的组件:

  1. GitLab
    1. 包括 GItLab 的 WebHook;
  2. Jenkins 及其插件:
    1. Generic Webhook Trigger
    2. Publish Over SSH

🧠疑问:

为什么不用 Ansible?
答:这里说明下,之所以不用 Ansible,是因为这个环境默认没有安装 Ansible,而且 Publish Over SSH 也足够用了,就没再用 Ansible 了。

详细说明

这里有 3 个几个自动化 job,如下:

  1. Generic Webhook Trigger 用于和 GitLab 联动, 自动触发 WebHook
  2. Publish Over SSH 用于通过 SSH 发布 NGINX 配置

说明:

配置 WebHook
test-intranet-nginx 为例进行说明.

  1. 进入该项目 -> 设置 -> 集成. 如下图:
    gitlab webhook
  2. URL 里填入: https://jenkins.example.com/generic-webhook-trigger/invoke?token=Jdy0bTQafyfUUBxJw33k(假设 jenkins.example.com 是 Jenkins 的控制台域名,token 可以在对应的 Jenkins 插件 Generic Webhook Trigger 中找到,这里 token 是用于区别具体是哪个 job。)
  3. Trigger 选择: Push events -> master.
  4. 按需取消勾选 Enable SSL verification. 保存. 如下:
    gitlab webhook 填入 jenkins url 和 token

说明:

URL 地址可以在 Jenkins 的对应插件里找到.
Trigger 可以按需调整.

在 Jenkins 的 系统配置 里 -> Publish over SSH:

如下图:
jenkins 插件 publish over ssh

填入:

  • Key
  • SSH Server 的:
    • name(用于给 jenkins 用户识别的用户名)
    • Hostname(目标机器的 IP 地址)
    • Username(目标机器的 OS 用户)
    • Remote Directory(需要把文件发送到的目标机器的目录地址)

说明:

一般情况下,对于 NGINX, 目录是 2 个, 为: /etc/nginx(放配置 *.conf) 和 /usr/share/nginx/html(放静态 web 文件)

以下图 Job 为例:

首先配置 源码管理, 如下图:

job 源码管理配置

填入:

  1. 仓库 URL
  2. 认证信息(如果是公开的库, 就不需要认证信息)
  3. 分支: master(按需调整)
  4. 源码库的信息:
    1. 本例中,类型是: gitlab
    2. URL
    3. GitLab 的 Version

然后配置 构建触发器, 如下图:

jenkins-webhook-trigger1.png

说明:

详细使用请在浏览器输入图中的 URL 进一步查看.

  1. Variable (使用默认配置)
  2. Expression (使用默认配置)
  3. Token

jenkins-webhook-trigger2.png

  1. Expression(解释如下: 用于进行目录过滤,填入正则后,只有目录匹配正则且发生变化才会触发构建)

  1. Text (默认配置)

最后, 是 构建后操作(实际「构建」过程没做任何事情). 如下图:

配置 publish over ssh

注意:

如果有多台 nginx 要同时发, 就要在这里同时写上多台 SSH Server.

  1. Name: 下拉框选择对应 Name
  2. Transfers
    1. Source files: 源文件, 位于: iaas_web_xxxx/conf/**/*
    2. Remove prefix: 需要移除的前缀, 为: iaas_web_xxxx/. 移除后, 示例为: conf/nginx.conf
    3. Remote directory: 不填写就是之前填写的目录, 一般为 /etc/nginx. 那么示例就发布到: /etc/nginx + conf/nginx.conf, 即: /etc/nginx/conf/nginx.conf
    4. Exec command: 文件传输过去后需要执行的命令. 为: nginx -t && nginx -s reload(或:sudo systemctl reload nginx). 即, 先 -t 验证配置是否有语法错误, 然后再 reload 发布. 如果验证有问题, jenkins pipeline 会异常, 变黄或变红.

发布流程

  1. 用户通过 IDE + Git, 在自己本地修改 NGINX Conf, 并最终 pushmerge(也会触发 push 的动作) 到 master
  2. GitLab 接收到 push event, 触发 webhook 调用: https://example.com/generic-webhook-trigger/invoke?token=Jdy0bTQafyfUUBxJw33k
  3. Jenkins 收到 webhook trigger. 并结合 filter 的 Expression 进行判断,确认匹配,则开始自动启动一次 Job.
  4. 该 Job 过程为:
    1. 将存有 nginx 配置的仓库 pull 到 jenkins.
    2. 通过 Publish over SSH, 将相关目录和文件传输到 SSH Server 的指定目录
    3. 执行 nginx 命令, 进行发布.
  5. 结束.

提示:

如果因为其他异常, 导致未自动发布,那么也可以手动点击 Job 页面的: 立即构建 进行手动触发

可以通过 首图 的 rss 订阅: Atom feed 失败, 这样发布失败你就会及时收到邮件.


Git + Jenkins 自动化 NGINX 发布简易实现
https://ewhisper.cn/posts/6622/
作者
东风微鸣
发布于
2021年9月26日
许可协议