March 8, 2022: This project has been moved to Sage-Bionetworks/challenge-registry.

This GitHub repository includes the code of the REST API service of the Registry of Open Community Challenges (ROCC). This service implements the ROCC OpenAPI specification (schemas).

• ROCC service version: 0.8.0
• ROCC schemas version: 0.6.0
• Docker image: sagebionetworks/rocc-service

Create the configuration file.

cp .env.example .env

The command below starts the ROCC service locally.

docker compose up --build

You can stop the container run with Ctrl+C, followed by docker compose down.

We recommend using a Conda environment to install and run the ROCC service.

conda create --name rocc-service python=3.9.5
conda activate rocc-service

Create the configuration file and export its parameters to environment variables.

cp .env.example .env
export $(grep -v '^#' .env | xargs)

Start the MongoDB instance.

docker compose up -d db

Install and start the ROCC service.

cd server/
pip install -r requirements.txt
python -m openapi_server

This API service provides a web interface (Swagger User Interface) that you can use to interact with the service. The address of this interface depends on the value of SERVER_PORT specified in .env.

• Swagger UI: http://localhost:{SERVER_PORT}/ui
• Swagger UI (default): http://localhost:8080/ui

This repository uses semantic versioning to track the releases of this tool. This repository uses "non-moving" GitHub tags, that is, a tag will always point to the same git commit once it has been created.

The artifact published by the CI/CD workflow of this GitHub repository is a Docker image pushed to the Docker Hub Registry. This table lists the image tags pushed to the registry.

You should avoid using a moving tag like latest when deploying containers in production, because this makes it hard to track which version of the image is running and hard to roll back.

Thinking about contributing to this project? Get started by reading our contribution guide.

Apache License 2.0