farmasiavr/farmasiavr-backend-prod

FarmasiaVR后端应用生产镜像

概述

该镜像为FarmasiaVR后端应用的官方生产环境镜像，用于在生产环境中部署和运行后端服务。镜像包含应用运行所需的全部依赖组件和配置，经过性能与稳定性优化，确保在生产环境中提供可靠的服务支持。

核心功能与特性

• 生产环境优化：默认配置针对生产环境的性能和稳定性进行调优，适配高并发业务场景
• 完整依赖集成：内置应用运行所需的全部依赖库及运行时环境，无需额外安装组件
• 安全加固：启用基础安全配置，包括最小权限原则、依赖安全扫描等，降低安全风险
• 版本一致性：确保部署环境与开发测试环境的依赖版本统一，减少"开发环境正常，生产环境异常"问题
• 轻量级设计：基于精简基础镜像构建，在保证功能完整性的前提下控制镜像体积，减少资源占用

使用场景

• FarmasiaVR应用生产环境的后端服务部署
• 生产环境中后端服务的水平扩展与集群部署
• 基于容器编排平台（如Kubernetes、Docker Swarm）的生产环境自动化部署

使用方法

基本部署（docker run）

bash
docker run -d \
  --name farmasiavr-backend \
  -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=prod \
  -e DB_HOST=mysql-prod \
  -e DB_PORT=3306 \
  -e DB_NAME=farmasiavr_prod \
  -e DB_USER=prod_service \
  -e DB_PASSWORD=your_secure_password \
  docker.xuanyuan.run/farmasiavr/backend:latest

环境变量配置

镜像支持通过环境变量自定义应用配置，常用配置项如下：

数据持久化

如需持久化应用日志或配置文件，可通过挂载卷实现：

bash
docker run -d \
  --name farmasiavr-backend \
  -p 8080:8080 \
  -v /data/farmasiavr/logs:/app/logs \
  -v /data/farmasiavr/config:/app/config \
  -e SPRING_PROFILES_ACTIVE=prod \
  -e DB_HOST=mysql-prod \
  docker.xuanyuan.run/farmasiavr/backend:latest

docker-compose部署示例

yaml
version: '3.8'
services:
  backend:
    image: docker.xuanyuan.run/farmasiavr/backend:v1.2.0  # 生产环境建议使用固定版本标签
    container_name: farmasiavr-backend
    restart: always  # 服务异常时自动重启
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_NAME=farmasiavr_prod
      - DB_USER=${DB_USER}  # 建议通过环境变量注入敏感信息
      - DB_PASSWORD=${DB_PASSWORD}
      - LOG_LEVEL=INFO
    volumes:
      - backend-logs:/app/logs
    depends_on:
      - mysql

  mysql:
    image: docker.xuanyuan.run/mysql:8.0
    container_name: farmasiavr-mysql
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=${DB_ROOT_PASSWORD}
      - MYSQL_DATABASE=farmasiavr_prod
      - MYSQL_USER=${DB_USER}
      - MYSQL_PASSWORD=${DB_PASSWORD}
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  backend-logs:
  mysql-data:

注意事项

• 生产环境部署时，建议使用具体版本标签（如v1.2.0）而非latest，确保部署版本可控
• 敏感信息（如数据库密码）应通过环境变量或容器平台的secrets管理功能注入，避免硬编码
• 定期更新镜像版本以获取安全补丁和功能更新，更新前建议在测试环境验证兼容性
• 部署前需确保宿主机已配置适当的资源限制（CPU/内存），避免资源竞争影响服务稳定性