clarin-eric / component-registry-rest

Component Registry back end
GNU General Public License v3.0
2 stars 1 forks source link
clarin-component-registry cmdi

CLARIN Component Registry - REST service

This project implements the back end for the CLARIN Component Registry. The Component Registry stores CMDI metadata components and profiles, and offers a service to list and retrieve them. There is a separate project for the Component Registry front end.

The build output of this project is used to build a Docker image. The project for this Docker image can be found in a GitLab repository: docker-component-registry-rest.

Detailed information about the architecture, usage and deployment can be found on the page on this service in the CLARIN Trac Wiki (CLARIN developer account required).

Building

Build the Maven project using mvn clean install. This requires Java 11 and Maven 3.6 or higher. You can also use the build.sh script without having Java or Maven installed but this does require Docker.

Notice that there are several build profiles. The default settings or the development profiles can be used for local testing. Use the docker profile to build for the Docker image (see below).

Pushing to this repository will trigger a build in Travis CI. For tags, this build will automatically deploy a deployment package (.tar.gz) to the GitHub release.

The docker-component-registry-rest can be used to build a Docker image based on a build of this project. For this, the docker profile has to be used, which creates a component-registry-rest-<version>-docker.tar.gz package in the target directory. The Docker build process unpacks this and embeds it into a Tomcat servlet container.

The Docker image can be deployed separately, in which case it has to be configured to connect to a PostgreSQL database. An easy way to deploy the complete Component Registry (back end, front end, database) is to use the compose_compreg Docker Compose project.

Changes and upgrading

See CHANGES.md for release history and UPGRADE.md for version specific upgrade instructions.

Links

Licence

Copyright (C) 2019 CLARIN ERIC

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.