Jenkins+Ansible实现LNMP环境自动化部署实践

1. 项目背景与核心价值

最近在帮一个社区论坛做自动化部署方案时，我设计了一套基于Jenkins+Ansible的LNMP环境自动化部署流程。这个方案特别适合需要频繁部署Discuz论坛的场景，比如：

• 开发测试环境快速搭建
• 生产环境的多节点部署
• 版本更新时的批量升级

传统手动部署LNMP环境至少需要2小时，而通过这套方案，从代码提交到完成部署只需要15分钟。更重要的是，它解决了环境不一致这个老大难问题 - 所有服务器上的软件版本、配置参数都能保持完全一致。

2. 技术架构解析

2.1 整体工作流程

1. 开发人员提交代码到Git仓库
2. Jenkins检测到代码变更触发构建
3. 调用Ansible Playbook执行部署
4. 自动完成LNMP环境搭建和Discuz安装
5. 邮件通知部署结果

2.2 关键技术选型

• Jenkins：选用2.346.3 LTS版本，稳定性有保障
• Ansible：使用2.13.4版本，兼容性好
• LNMP：
  • Nginx 1.22.0（性能优化版）
  • MySQL 8.0.30（默认启用密码强度校验）
  • PHP 7.4.30（完美兼容Discuz）

提示：PHP版本选择很关键，Discuz X3.5官方推荐7.3-7.4，不推荐8.0+版本

3. 详细实现步骤

3.1 Jenkins环境准备

先安装必要的插件：

• Ansible插件（版本1.1）
• Git插件（版本4.11.3）
• Email Extension插件（版本2.89）

配置系统全局工具：

bash复制# Ansible安装路径
/usr/local/bin/ansible

# Git路径
/usr/bin/git

3.2 Ansible Playbook设计

创建lnmp-discuz.yml文件，包含以下核心任务：

yaml复制- name: 安装Nginx
  yum:
    name: nginx
    state: latest
  notify: restart nginx

- name: 配置PHP-FPM
  template:
    src: templates/php-fpm.conf.j2
    dest: /etc/php-fpm.d/www.conf

3.3 Discuz部署自动化

通过Ansible的unarchive模块实现：

yaml复制- name: 解压Discuz安装包
  unarchive:
    src: "/tmp/Discuz_X3.5_SC_UTF8.zip"
    dest: "/var/www/html/"
    remote_src: yes

4. 关键配置详解

4.1 Nginx虚拟主机配置

nginx复制server {
    listen 80;
    server_name forum.example.com;
    root /var/www/html/upload;
    
    location ~ .*\.(php|php5)?$ {
        fastcgi_pass 127.0.0.1:9000;
        include fastcgi.conf;
    }
}

4.2 MySQL安全配置

yaml复制- name: 设置MySQL root密码
  mysql_user:
    name: root
    password: "{{ mysql_root_password }}"
    host: localhost
    login_unix_socket: /var/lib/mysql/mysql.sock

5. 常见问题解决方案

5.1 文件权限问题

Discuz需要写权限的目录：

bash复制chmod -R 777 /var/www/html/upload/config
chmod -R 777 /var/www/html/upload/data

5.2 PHP扩展缺失

必须安装的PHP扩展：

• gd
• pdo_mysql
• mbstring

安装命令：

yaml复制- name: 安装PHP扩展
  yum:
    name: "php-{{ item }}"
    state: present
  loop:
    - gd
    - pdo_mysql 
    - mbstring

6. 进阶优化建议

6.1 部署速度优化

• 使用Ansible的async和poll参数实现并行部署
• 在Playbook中设置gather_facts: no减少采集时间

6.2 安全加固

• 配置Jenkins的RBAC权限控制
• Ansible使用vault加密敏感变量
• 定期轮换SSH密钥

我在实际部署中发现，通过合理设置Ansible的forks参数（建议设为目标服务器的1.5倍），可以将20台服务器的部署时间从30分钟缩短到8分钟。另外，建议在Playbook中添加健康检查任务，自动验证各服务是否正常启动。