specify7-service 镜像文档

1. 镜像概述

specify7-service 镜像仅提供 Specify 7 Web 应用程序本身。它必须与 Specify 6、Web 服务器以及 MariaDB 中的 Specify 数据库组合使用才能正常运行。具体组合示例可参考 GitHub 仓库。

2. 核心功能与特性

提供 Specify 7 Web 应用服务：作为 Specify 7 系统的前端 Web 组件，处理用户交互与数据展示。
组件集成支持：设计用于与 Specify 6（后端服务）、Web 服务器（如 Nginx）及 MariaDB 数据库协同工作，依赖外部组件完成完整功能。

3. 使用场景与适用范围

适用于需要部署 Specify 7 标本管理系统的场景，需与 Specify 6、Web 服务器及 MariaDB 数据库配合使用。典型用户包括科研机构、博物馆、自然历史标本馆等需管理生物标本或藏品数据的单位。

4. 使用方法与配置说明

4.1 前置条件

已部署 Specify 6 镜像（提供后端服务）。
已配置 Web 服务器（如 Nginx，用于处理 HTTP 请求转发）。
已部署 MariaDB 数据库，并初始化 Specify 数据库 schema。

4.2 核心配置要点

该镜像本身不包含独立运行所需的完整依赖，需通过外部配置与其他组件通信，关键配置包括：

网络连接：确保与 Specify 6、Web 服务器及 MariaDB 在同一网络环境，可通过容器名称或 IP 地址访问。
环境变量：需通过环境变量（如数据库连接地址、Specify 6 服务地址等）指定外部组件参数，具体变量需参考 GitHub 示例。

4.3 参考资源

完整配置示例（含 docker-compose 模板、环境变量说明）请参见 Specify Docker Compositions 仓库。

5. 部署方案示例

推荐使用 docker-compose 进行多组件编排，以下为简化示例结构（具体配置需根据实际环境调整，完整模板见 GitHub 仓库）：

yaml
# docker-compose.yml 示例（片段）
version: '3.8'

services:
  # Specify 7 Web 应用服务
  specify7:
    image: specify7-service
    depends_on:
      - specify6  # 依赖 Specify 6 后端
      - db        # 依赖 MariaDB 数据库
    environment:
      - DB_HOST=db              # MariaDB 容器名称或 IP
      - DB_NAME=specify_db      # Specify 数据库名称
      - DB_USER=specify_user    # 数据库访问用户
      - DB_PASSWORD=xxx         # 数据库密码（建议通过 secrets 管理）
      - SPECIFY6_URL=[***]  # Specify 6 服务地址
    networks:
      - specify-network  # 与其他组件共享网络

  # Specify 6 后端服务（需单独部署对应镜像）
  specify6:
    image: specify6:latest
    # ...（省略 Specify 6 配置）

  # MariaDB 数据库
  db:
    image: mariadb:10.6
    volumes:
      - specify-db-data:/var/lib/mysql  # 持久化数据库数据
    # ...（省略数据库配置）

  # Web 服务器（如 Nginx）
  webserver:
    image: nginx:alpine
    ports:
      - "80:80"  # 暴露 HTTP 端口
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf  # 配置请求转发规则
    depends_on:
      - specify7
    # ...（省略 Nginx 配置）

networks:
  specify-network:

volumes:
  specify-db-data: