https://github.com/eea/copernicus_quality_tools
https://github.com/eea/copernicus_quality_tools
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/eea/copernicus_quality_tools
- Owner: eea
- License: eupl-1.2
- Created: 2018-01-04T08:38:28.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2026-04-01T13:10:19.000Z (3 months ago)
- Last Synced: 2026-04-03T02:17:31.796Z (3 months ago)
- Language: Python
- Size: 140 MB
- Stars: 9
- Watchers: 14
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# EEA CLMS QC Tool
The application is composed of:
* Front-end user interface, alias web console;
* Worker Service;
# Documentation
Documentation of the QC tool, and specification of supported QA checks is available at https://github.com/eea/copernicus_quality_tools/wiki
# Reporting Issues
Please report any issues in the QC tool via GitHub:
* Go to https://github.com/eea/copernicus_quality_tools/issues and click *New Issue*.
* Sign-in with your GitHub account (or create a new GitHub account if you don't have one).
* Describe your issue. When describing an issue, please include the QC tool version and steps to reproduce.
* The development team will investigate the issue and get back to you.
# Prerequisities
* docker version 1.13 or higher, see https://docs.docker.com/install/linux/docker-ce/ubuntu/;
* docker-compose 1.21 or higher, see https://docs.docker.com/compose/install/#install-compose;
* Note: docker-compose version 3 file format is used. In case of errors, please upgrade to a newer version.
* For installation on Windows, see [docker/NOTES.windows](docker/NOTES.windows.md).
# Run the application
(1) Go to the [latest release](https://github.com/eea/copernicus_quality_tools/releases)
(2) Download the file `docker-compose.service_provider.yml`
(3) (Optional) Adjust the file `docker-compose.service_provider.yml` in accord with your environment. For example see [docker/docker-compose.igor.yml](docker/docker-compose.igor.yml). The environment variables are described in [docker/NOTES.environ.txt](docker/NOTES.environ.txt). There is also `docker-compose.eea.yml` prepared targeting eea infrastructure with submission feature enabled.
(4) Run the application
```
sudo docker-compose -f ./docker-compose.service_provider.yml -p qc_tool_app up --scale worker=4
```
(5) You can reach the web console at any host address and port 8000. For example, if you run the browser at the same host as docker containers, you can reach the application at http://localhost:8000.
(6) For initial signing in use user name `guest` and password `guest`.
(7) To upgrade to a new release, run:
```
sudo docker-compose -f ./docker-compose.service_provider.yml -p qc_tool_app pull
```
This will instruct docker to re-download the latest QC tool release images from docker hub repository.
# For developers
If you want to propagate your local source code into running containers you may apply docker bind mount.
Such a way you overlay the source code already built in the image at `/usr/local/src/copernicus_quality_tools`.
For advice see the example docker compose configuration [docker-compose.igor.yml](docker/docker-compose.igor.yml).
There are already some automated tests at `src/qc_tool/test`.
See the instructions in [NOTES.txt](src/qc_tool/test/NOTES.txt).
The qc_tool_frontend service uses sqlite database originally located at `/var/lib/qc_tool/frontend.sqlite`.
The initial database structure is made during docker build.
The `service_provider` and `eea` configurations use named volumes for persisting such database.
You are free to copy the database to other persistent location, however you must ensure setting up FRONTEND_DB_PATH properly.
# Demo installation
The service is publicly available at: https://qc-copernicus.eea.europa.eu/ Demo login is user: guest, password: guest.
# Product definitions
QA check configurations for Copernicus products are defined in the [product_definitions](product_definitions) directory. Each product definition .json file contains a list of parametrized checks. For QC tool setup with editable product definitions, see instructions in [docker/NOTES.product_definitions](docker/NOTES.product_definitions.md).