eeacms/copernicus-qctool-worker

EEA CLMS QC Tool Docker镜像文档

镜像概述和主要用途

EEA CLMS QC Tool是一个用于Copernicus产品质量控制的工具，由前端Web控制台和Worker Service组成。该工具提供QA检查功能，支持通过Web界面管理检查任务，并允许用户提交问题反馈，适用于需要对Copernicus数据进行质量验证的场景。

核心功能和特性

• 前端Web控制台：提供用户交互界面，用于配置、监控和管理QA检查任务
• Worker Service：处理后台任务，执行质量检查逻辑
• QA检查规范：支持多种参数化检查，详细规范文档可通过GitHub Wiki获取
• 问题报告机制：通过GitHub提交工具问题，需包含版本信息和复现步骤
• 持久化存储：使用命名卷持久化SQLite数据库，确保数据不丢失
• 灵活配置：支持通过环境变量和产品定义文件自定义检查参数

使用场景和适用范围

适用于需要对Copernicus产品（如卫星数据、环境监测数据等）进行质量控制和QA检查的场景，包括科研机构、环境监测部门、数据服务提供商等。支持服务提供商和EEA基础设施部署，也可用于本地开发和测试。

详细使用方法和配置说明

前提条件

• Docker：版本1.13或更高，安装指南见Docker官方文档
• docker-compose：版本1.21或更高，安装指南见Compose安装文档
• 注意：使用docker-compose 3版本文件格式，如遇兼容性错误请升级docker-compose
• Windows系统安装说明：docker/NOTES.windows

运行应用

1. 访问https://github.com/eea/copernicus_quality_tools/releases
2. 下载配置文件docker-compose.service_provider.yml
3. （可选）根据部署环境调整配置文件，示例配置参考docker/docker-compose.igor.yml，环境变量说明见docker/NOTES.environ.txt。docker-compose.eea.yml适用于EEA基础设施，已启用数据提交功能。
4. 启动应用：

   bash
   sudo docker-compose -f ./docker-compose.service_provider.yml -p qc_tool_app up --scale worker=4
   

5. 访问Web控制台：通过主机IP的8000端口，本地部署可访问http://localhost:8000
6. 初始登录：用户名guest，密码guest
7. 升级版本：

   bash
   sudo docker-compose -f ./docker-compose.service_provider.yml -p qc_tool_app pull
   

   该命令将从Docker Hub拉取最新版本镜像。

开发者说明

• 本地代码挂载：如需将本地源代码实时同步到容器，可使用Docker绑定挂载覆盖镜像中的/usr/local/src/copernicus_quality_tools路径，配置示例见docker-compose.igor.yml
• 自动化测试：测试用例位于src/qc_tool/test，执行说明见NOTES.txt
• 数据库配置：前端服务使用SQLite数据库，默认路径/var/lib/qc_tool/frontend.sqlite，数据库结构在镜像构建时初始化。service_provider和eea配置通过命名卷持久化数据库。如需迁移数据库，需正确设置FRONTEND_DB_PATH环境变量指定新路径。

演示安装

公开演示服务地址：[***]

产品定义

Copernicus产品的QA检查配置存储在product_definitions目录，每个.json文件定义一组参数化检查规则。如需配置可编辑的产品定义，操作说明见docker/NOTES.product_definitions

问题报告

如遇工具问题，请通过GitHub提交：

1. 访问https://github.com/eea/copernicus_quality_tools/issues%E5%B9%B6%E7%82%B9%E5%87%BB%22New Issue"
2. 使用GitHub账号登录（无账号需先注册）
3. 描述问题，需包含QC工具版本和复现步骤
4. 开发团队将调查并反馈处理结果

参考文档

QC工具完整文档及QA检查规范：https://github.com/eea/copernicus_quality_tools/wiki