Development • Documentation • Support • Contribute • Contributors • Licensing
The goal of this project is to develop the official European solution for the interoperability between national backend servers of decentralised contact tracing applications to combat COVID-19.
This repository contains the federation gateway service.
SonarCloud supports the EU Federation Gateway Service project! SonarCloud (www.sonarcloud.io) catches Bugs and Vulnerabilities in your repositories, and provides clear resolution guidance for any Code Quality or Security issue it detects. SonarCloud makes applications maintainable, reliable and safe!
Whether you cloned or downloaded the 'zipped' sources you will either find the sources in the chosen checkout-directory or get a zip file with the source code, which you can expand to a folder of your choice.
In either case open a terminal pointing to the directory you put the sources in. The local build process is described afterwards depending on the way you choose.
This is the recommended way for taking part in the development.
Please check, whether following prerequisites are installed on your machine:
- Open JDK 11 or a similar JDK 11 compatible VM
- Maven
This project also supports building a Docker image for local testing (Docker image should not be used for productive environments).
To build the Docker image enable the maven profile docker
and build the project:
mvn clean install -P docker
A directory docker
will be created in target
directory.
Now open a shell with working directory within the created directory and execute
docker-compose up --build
The EFGS Docker image will be built. Also a MySQL database will be created. After that both start up and EFGS service is available on localhost port 8080.
Along with the application there comes a swagger2 API documentation, which you can access in your web browser when the efgs-gateway-service applications runs:
<base-url>/swagger
Which results in the following URL on your local machine: http://localhost:8080/swagger
Additional documentation can be found in the folder docs.
The following channels are available for discussions, feedback, and support requests:
Type | Channel |
---|---|
Federation gateway issues | |
Other requests |
Contribution and feedback is encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our Contribution Guidelines. By participating in this project, you agree to abide by its Code of Conduct at all times.
Our commitment to open source means that we are enabling -in fact encouraging- all interested parties to contribute and become part of its developer community.
Copyright (C) 2020 T-Systems International GmbH and all other contributors
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the LICENSE for the specific language governing permissions and limitations under the License.