LandPPT项目Docker容器化部署指南

项目概述

LandPPT是一个基于Docker容器化部署的演示文稿处理系统，通过Docker Compose可以快速搭建完整的运行环境。本文将详细解析其docker-compose.yml配置文件的技术要点，帮助开发者理解项目架构和部署方式。

核心服务配置

基础服务定义

配置文件采用Docker Compose 3.8版本语法定义了一个名为landppt的服务：

services:
  landppt:
    image: bradleylzh/landppt:latest
    container_name: landppt
    ports:
      - "8000:8000"

• 使用bradleylzh/landppt:latest作为基础镜像
• 明确指定容器名称为landppt，便于管理
• 将容器内部的8000端口映射到主机的8000端口，这是常见的Web服务端口

数据持久化策略

LandPPT设计了完善的数据持久化方案，确保重要数据不会因容器重启而丢失：

volumes:
  - ./.env:/app/.env
  - landppt_data:/app/data
  - landppt_uploads:/app/uploads
  - landppt_documents:/app/research_documents
  - landppt_cache:/app/temp

各卷功能解析

1. 环境配置文件：将本地.env文件挂载到容器内的/app/.env，方便配置修改
2. 主数据卷：landppt_data对应/app/data，存储核心业务数据
3. 上传目录：landppt_uploads对应/app/uploads，保存用户上传文件
4. 文档资料：landppt_documents对应/app/research_documents，存储生成的文档资料
5. 缓存目录：landppt_cache对应/app/temp，存放临时文件

环境变量配置

environment:
  - PYTHONPATH=/app/src
  - PYTHONUNBUFFERED=1

• PYTHONPATH设置Python模块搜索路径，指向/app/src
• PYTHONUNBUFFERED=1确保Python输出实时刷新，便于日志查看

健康检查机制

healthcheck:
  test: ["CMD", "./docker-healthcheck.sh"]
  interval: 30s
  timeout: 30s
  retries: 3
  start_period: 40s

LandPPT实现了完善的健康检查机制：

• 使用自定义脚本docker-healthcheck.sh检测服务状态
• 每30秒检查一次
• 超时时间设为30秒
• 失败重试3次
• 容器启动后40秒开始检查，给予足够初始化时间

网络与存储配置

网络配置

networks:
  landppt_network:
    driver: bridge

使用桥接网络模式，为后续可能的服务扩展预留空间。

存储卷定义

volumes:
  landppt_data:
    driver: local
  landppt_uploads:
    driver: local
  landppt_documents:
    driver: local
  landppt_cache:
    driver: local

所有卷均使用本地驱动，确保数据存储在宿主机上，避免容器删除导致数据丢失。

部署实践建议

1. 环境准备：确保宿主机已安装Docker和Docker Compose
2. 配置文件：提前准备好.env配置文件放在项目根目录
3. 权限设置：确保挂载目录有适当读写权限
4. 启动命令：使用docker-compose up -d后台启动服务
5. 日志查看：可通过docker logs landppt查看服务日志

高可用配置

如需增强服务可靠性，可考虑以下扩展：

1. 资源限制：添加CPU和内存限制
2. 日志驱动：配置日志轮转策略
3. 备份策略：定期备份重要卷数据

通过以上配置，LandPPT实现了开箱即用的容器化部署方案，既保证了开发环境的一致性，又确保了生产环境的稳定性。