用Ansible从零开始部署Spring Boot Web应用:全栈自动化部署指南

在现代Web开发中,构建一个可靠的、可扩展的Web应用程序需要综合利用多种技术栈。本文将通过实际案例,详细讲解如何从零开始部署一个以Spring Boot为核心的Web应用程序,包括后端、数据库、缓存、中间件和前端的全栈配置。我们将利用Ansible来实现自动化部署,以简化繁琐的配置流程。

场景概述

该应用由以下组件组成:

  • Spring Boot:核心后端服务,打包为一个可运行的JAR文件。
  • MySQL:提供关系型数据库支持。
  • Redis:作为缓存服务,加速数据访问。
  • Vue.js:构建用户交互的前端界面。
  • Nginx:反向代理和静态文件服务。

我们将假设目标服务器运行CentOS7,Ubuntu 20.04或类似的Linux发行版,并通过Ansible进行远程配置。

部署步骤

1. 准备服务器环境

首先,确保目标服务器已经安装了以下基本工具:

  • OpenSSH:用于Ansible的远程连接。
  • Python:Ansible需要Python支持。

在控制节点安装Ansible:

# CentOS 7 系统
yum install ansible -y

# Ubuntu 系统
sudo apt update && sudo apt install -y ansible

验证Ansible安装是否成功:

ansible --version

2. 规划目录结构

为了让项目部署更加清晰,我们规划以下目录结构:

├── ansible
│   ├── playbooks
│   │   ├── deploy.yml  # 主Playbook文件
│   ├── inventory      # 主机清单
│   ├── files          # 上传的静态文件和配置
│   │   ├── springboot-app.jar
│   │   ├── nginx.conf
│   │   └── vue-dist/

将必要的文件上传到files目录中,包括Spring Boot的JAR包、Nginx配置文件,以及Vue的打包结果(通常是dist目录)。

3. 编写Playbook

接下来,我们将逐步编写Playbook,分步完成部署。

3.1 安装必需的服务

安装Java环境、MySQL、Redis和Nginx:

- name: Install Required Services
  hosts: all
  become: true
  tasks:
    - name:  Install Java, MySQL, Redis, and Nginx (Ubuntu)
      apt:
        name:
          - openjdk-11-jdk
          - mysql-server
          - redis-server
          - nginx
        state: present
        update_cache: yes
      when: ansible_os_family == 'Debian'  # Ubuntu系统
    - name: Install Java, MySQL, Redis, and Nginx (CentOS)
        yum:
        name:
          - openjdk-11-jdk
          - mysql-server
          - redis-server
          - nginx
        state: present
      when: ansible_os_family == 'RedHat'  # CentOS系统

3.2 配置MySQL数据库

配置数据库和用户:

- name: Configure MySQL Database
      mysql_db:
        name: springboot_db
        state: present
        login_user: root
        login_password: "your_mysql_root_password"

    - name: Create MySQL User
      mysql_user:
        name: springboot_user
        password: springboot_password
        priv: 'springboot_db.*:ALL'
        state: present
        login_user: root
        login_password: "your_mysql_root_password"

3.3 配置Redis

确保Redis服务正在运行:

- name: Ensure Redis is Running (Ubuntu)
  service:
    name: redis-server
    state: started
    enabled: true
  when: ansible_os_family == 'Debian'  # Ubuntu系统

- name: Ensure Redis is Running (CentOS)
  service:
    name: redis
    state: started
    enabled: true
  when: ansible_os_family == 'RedHat'  # CentOS系统

3.4 部署Spring Boot应用

现在我们可以上传Spring Boot应用的JAR包并配置systemd服务,使其能够自动启动。

- name: Upload Spring Boot Application
  copy:
    src: files/springboot-app.jar
    dest: /opt/springboot-app/springboot-app.jar
    owner: root
    group: root
    mode: '0755'

- name: Configure Spring Boot SystemD Service
  copy:
    dest: /etc/systemd/system/springboot-app.service
    content: |
      [Unit]
      Description=Spring Boot Application
      After=network.target

      [Service]
      User=root
      ExecStart=/usr/bin/java -jar /opt/springboot-app/springboot-app.jar
      Restart=always

      [Install]
      WantedBy=multi-user.target

- name: Reload SystemD and Start Spring Boot Service
  command: systemctl daemon-reload

- name: Ensure Spring Boot Service is Running
  service:
    name: springboot-app
    state: started
    enabled: true

3.5 配置Nginx

我们将配置Nginx作为反向代理,并将前端Vue应用的静态文件服务到指定目录。

- name: Upload Vue Static Files
      copy:
        src: files/vue-dist/
        dest: /var/www/html/vue-app/
        owner: www-data
        group: www-data
        mode: '0755'

    - name: Configure Nginx
      copy:
        src: files/nginx.conf
        dest: /etc/nginx/sites-available/springboot-app

    - name: Enable Nginx Configuration
      file:
        src: /etc/nginx/sites-available/springboot-app
        dest: /etc/nginx/sites-enabled/springboot-app
        state: link

    - name: Remove Default Nginx Configuration
      file:
        path: /etc/nginx/sites-enabled/default
        state: absent

    - name: Restart Nginx
      service:
        name: nginx
        state: restarted

3.6 完整Playbook

将所有任务整合到一个完整的Playbook中,最终形成deploy.yml,代码如下:

---
- name: Deploy Spring Boot Web Application
  hosts: all
  become: true
  vars:
    mysql_root_password: "{{ mysql_root_password }}"  # MySQL root 密码
    mysql_database: springboot_db                      # 数据库名称
    mysql_user: springboot_user                        # 数据库用户
    mysql_password: "{{ mysql_password }}"            # 数据库用户密码
  tasks:
    # 安装服务(Java, MySQL, Redis, Nginx)
    - name: Install Java, MySQL, Redis, and Nginx (Ubuntu)
      apt:
        name:
          - openjdk-11-jdk
          - mysql-server
          - redis-server
          - nginx
        state: present
        update_cache: yes
      when: ansible_os_family == 'Debian'  # Ubuntu系统

    - name: Install Java, MySQL, Redis, and Nginx (CentOS)
      yum:
        name:
          - java-11-openjdk
          - mysql-server
          - redis
          - nginx
        state: present
      when: ansible_os_family == 'RedHat'  # CentOS系统

    # 配置MySQL数据库
    - name: Configure MySQL Database
      mysql_db:
        name: "{{ mysql_database }}"
        state: present
        login_user: root
        login_password: "{{ mysql_root_password }}"

    - name: Create MySQL User
      mysql_user:
        name: "{{ mysql_user }}"
        password: "{{ mysql_password }}"
        priv: "{{ mysql_database }}.*:ALL"
        state: present
        login_user: root
        login_password: "{{ mysql_root_password }}"

    # 确保Redis服务正在运行
    - name: Ensure Redis is Running (Ubuntu)
      service:
        name: redis-server
        state: started
        enabled: true
      when: ansible_os_family == 'Debian'  # Ubuntu系统

    - name: Ensure Redis is Running (CentOS)
      service:
        name: redis
        state: started
        enabled: true
      when: ansible_os_family == 'RedHat'  # CentOS系统

    # 上传Spring Boot应用JAR文件
    - name: Upload Spring Boot Application
      copy:
        src: files/springboot-app.jar
        dest: /opt/springboot-app/springboot-app.jar
        owner: root
        group: root
        mode: '0755'

    # 配置Spring Boot SystemD服务
    - name: Configure Spring Boot SystemD Service
      copy:
        dest: /etc/systemd/system/springboot-app.service
        content: |
          [Unit]
          Description=Spring Boot Application
          After=network.target

          [Service]
          User=root
          ExecStart=/usr/bin/java -jar /opt/springboot-app/springboot-app.jar
          Restart=always

          [Install]
          WantedBy=multi-user.target

    - name: Reload SystemD and Start Spring Boot Service
      command: systemctl daemon-reload

    - name: Ensure Spring Boot Service is Running
      service:
        name: springboot-app
        state: started
        enabled: true

    # 上传Vue前端静态文件
    - name: Upload Vue Static Files
      copy:
        src: files/vue-dist/
        dest: /var/www/html/vue-app/
        owner: www-data
        group: www-data
        mode: '0755'

    # 配置Nginx
    - name: Configure Nginx
      copy:
        src: files/nginx.conf
        dest: /etc/nginx/sites-available/springboot-app

    - name: Enable Nginx Configuration
      file:
        src: /etc/nginx/sites-available/springboot-app
        dest: /etc/nginx/sites-enabled/springboot-app
        state: link

    - name: Remove Default Nginx Configuration
      file:
        path: /etc/nginx/sites-enabled/default
        state: absent

    - name: Restart Nginx
      service:
        name: nginx
        state: restarted

通过以上步骤,您可以在CentOS和Ubuntu系统上自动化部署一个完整的Spring Boot Web应用,包括后端(Spring Boot)、数据库(MySQL)、缓存(Redis)、前端(Vue.js)以及反向代理(Nginx)。通过Ansible的自动化部署,不仅提高了部署效率,还使得运维工作更加便捷、可重复。如果您有任何问题或改进建议,欢迎留言讨论。

原文链接:,转发请注明来源!