Yearning项目Docker-Compose部署指南

概述

Yearning是一款开源的MySQL数据库SQL审核平台，本文主要讲解如何使用Docker-Compose快速部署Yearning系统。通过容器化部署方式，可以大大简化环境配置过程，实现一键启动服务。

环境准备

在开始部署前，请确保系统已安装以下组件：

• Docker引擎（版本17.05或更高）
• Docker-Compose（版本1.17.0或更高）

配置文件详解

服务架构

该docker-compose.yml文件定义了两个服务：

1. yearning：Yearning应用服务
2. mysql：MySQL数据库服务

Yearning服务配置

yearning:
    image: yeelabs/yearning:latest
    environment:
       MYSQL_USER: yearning
       MYSQL_PASSWORD: ukC2ZkcG_ZTeb
       MYSQL_ADDR: mysql
       MYSQL_DB: yearning
       SECRET_KEY: dbcjqheupqjsuwsm
       IS_DOCKER: is_docker
    ports:
       - 8000:8000
    command: /bin/bash -c "./Yearning install && ./Yearning run"
    depends_on:
       - mysql
    restart: always

关键参数说明：

• image：指定使用的Yearning镜像版本
• environment：配置数据库连接参数和密钥
  • MYSQL_*系列参数用于连接MySQL服务
  • SECRET_KEY用于加密敏感数据
  • IS_DOCKER标志表明运行在容器环境中
• ports：将容器8000端口映射到主机8000端口
• command：启动命令，包含初始化和运行两个步骤
• restart：设置容器异常退出时自动重启

MySQL服务配置

mysql:
    image: mysql:5.7
    environment:
       MYSQL_ROOT_PASSWORD: ukC2ZkcG_ZTeb
       MYSQL_DATABASE: yearning
       MYSQL_USER: yearning
       MYSQL_PASSWORD: ukC2ZkcG_ZTeb
    command:
       - --character-set-server=utf8mb4
       - --collation-server=utf8mb4_general_ci
    volumes:
       - ./data/mysql:/var/lib/mysql

关键参数说明：

• 使用MySQL 5.7官方镜像
• 环境变量配置root密码、数据库名和普通用户
• 字符集设置为utf8mb4以支持完整Unicode字符
• 数据卷挂载确保数据持久化

部署步骤

1. 创建项目目录并进入：

   mkdir yearning-docker && cd yearning-docker
   

2. 创建docker-compose.yml文件，内容如上

3. 启动服务：

   docker-compose up -d
   

4. 等待服务初始化完成（首次启动需要较长时间）

5. 访问Yearning：

   http://服务器IP:8000
   

初始登录信息

系统部署完成后，可使用以下默认账号登录：

• 用户名：admin
• 密码：Yearning_admin

安全提示：首次登录后请立即修改默认密码！

常见问题

1. 端口冲突：如果8000端口被占用，可修改docker-compose.yml中的端口映射

2. 初始化失败：检查MySQL服务是否正常启动，网络是否连通

3. 数据持久化：MySQL数据存储在./data/mysql目录，请确保该目录有写入权限

4. 性能优化：对于生产环境，建议调整MySQL的内存参数

升级维护

1. 停止服务：

   docker-compose down
   

2. 更新镜像：

   docker-compose pull
   

3. 重新启动：

   docker-compose up -d
   

通过以上步骤，您可以轻松完成Yearning系统的容器化部署。这种部署方式不仅简化了安装过程，还便于后续的维护和升级。