This repository contains microservices developed and maintained by the Legume Information System to support the Legumeinfo website as well as the various apps developed and maintained by the group.
Each subdirectory contains a different microservice, with the exception of the proto/ directory, which contains Protocol Buffers that define common data types used by one or more of the microservices.
See the proto/ directory for more information about using these Protocol Buffers.
Each microservice is distributed as a Docker image via the GitHub container registry. Unless you are a developer, we recommend using these prebuilt images rather trying to compile and run microservices yourself. Additionally, if you are using microservices that depend on other microservices, we especially recommend using a tool for deploying multi-container applications, such as Docker Compose or Kubernetes.
Some containers support gRPC. If you wish to communicate with these containers from a Web client using gRPC Web, then you must use a proxy that supports gRPC Web request, such as Envoy Proxy.
See the Genome Context Viewer Docker Compose repository for an example of deploying Legumeinfo microservices using Docker Compose, Envoy Proxy, and Traefik. The example configures microservices to communicate and supports gRPC Web requests.
Please so our contribution guidelines before contributing to this repository.
See the directories of microservices you wish to compile manually for instructions on doing so. Generally, we recommend still using a solution like Docker Compose to orchestrate container building and cross-talk, even during development.