Getting started
A Quick start.
Hardware Requirements
A machine that has 24 RAM is advised, less than that may cause performance issues.
Software Requirements
The following tools are needed to run/deploy the stack:
WSL2 (for windows users)
You will need first to clone the project on your machine.
If you're a Windows user, you should limit the amount of RAM/CPU that will be used by WSL, for more details please check the following link: Limiting memory usage in WSL2.
You should run the following command to initialize docker swarm on your machine:
docker swarm init.
Prerequisites
What is Cares on Platform?
Cares on Platform aims to provide a set of services working together to consume raw COVID data in FHIR format in order to produce reports and visualizations.
This service will use, transform, and flatten the data to get the expected output and produce reports.
It is aimed to be working in Single mode as well as Cluster mode with the ability to handle big data.
It is an implementation of the general project Platform and it is developed to act as a custom package alongside some of the base packages in the Platform.
What should I know before starting to develop?
Quick Start for Devs
The following steps provide a quick start to Cares on platform:
Clone the GitHub repository for the project.
According to your arguments provided in the first command, it downloads one or three executable files
platform-linux | platform-macos | platform.exe
. Now you should edit the command in thedeploy-local.sh
file. It should make use of the executable suitable for your operating system (the default:platform-linux
).Ensure docker is installed on your machine, and run the command
docker swarm init
to initialize a docker swarm.To start up the project run the command
./deploy-local-combo.sh init
.
The following options can be passed to the ./deploy-local-combo.sh
command:
init
for initializing the servicesdown
for stopping the servicesup
for bringing the services updestroy
for removing the services
What I expect to see ?
Running the deploy-local.sh script will spin up the services.
You can run: docker service ls
to view the current running services.
You can check the sub-section Local deployment to check the expected running services.
Need more info ?
You can check the Overview section for more understanding.
For more info on components and services, view Design & Architecture.
The section Launching & Local Testing will detail which services should be up and running and how to test all the flow.
The section Troubleshooting & Monitoringwill explain the steps to locate and issue if you're facing one.
The section Deployment will mention more options for starting the stack.
Last updated