/immuni-backend-app-configuration

Repository for the backend app configuration

Primary LanguagePythonGNU Affero General Public License v3.0AGPL-3.0

Immuni Backend App Configuration Service


Python Code style: black Checked with mypy security: bandit

Table of contents

Context

This repository contains the source code of Immuni's App Configuration Service. More detailed information about Immuni can be found in the following documents:

Please take the time to read and consider the other repositories in full before digging into the source code or opening an Issue. They contain a lot of details that are fundamental to understanding the source code and this repository's documentation.

Installation

This backend service comes with an out-of-the-box installation, leveraging Docker containers. Please ensure that Docker is installed on your computer (docker-compose version >= 1.25.5).

git clone git@github.com:immuni-app/immuni-backend-app-configuration.git
cd immuni-backend-app-configuration
git submodule update --init
cd docker
docker-compose build \
    --build-arg GIT_BRANCH=$(git rev-parse --abbrev-ref HEAD) \
    --build-arg GIT_SHA=$(git rev-parse --verify HEAD) \
    --build-arg GIT_TAG=$(git tag --points-at HEAD | cat) \
    --build-arg BUILD_DATE=$(date -u +"%Y-%m-%dT%H:%M:%SZ")

The backend service can then be launched.

docker-compose up

At this point, the service is available at http://0.0.0.0:5000/swagger.

For more information about how the project is generated and structured, please refer to the Contributing section below.

Contributing

Contributions are most welcome. Before proceeding, please read the Code of Conduct for guidance on how to approach the community and create a positive environment. Additionally, please read our CONTRIBUTING file, which contains guidance on ensuring a smooth contribution process.

The Immuni project is composed of different repositories—one for each component or service. Please use this repository for contributions strictly relevant to Immuni's backend services. To propose a feature request, please open an issue in the Documentation repository. This lets everyone involved see it, consider it, and participate in the discussion. Opening an issue or pull request in this repository may slow down the overall process.

Contributors

Here is a list of Immuni's contributors. Thank you to everyone involved for improving Immuni, day by day.

Licence

Authors / Copyright

Copyright 2020 (c) Presidenza del Consiglio dei Ministri.

Please check the AUTHORS file for extended reference.

Third-party component licences

Please see the Technology Description’s Backend Services Technologies section, which also lists the corresponding licences.

Licence details

The licence for this repository is a GNU Affero General Public Licence version 3 (SPDX: AGPL-3.0). Please see the LICENSE file for full reference.