Jembi Platform

Tech Used

• Docker
• Golang (cli dev)
• Terraform (remote cluster setup)
• Ansible (remote cluster setup)

Quick Start for devs (local single node)

1. If running into an error invalid mount config for type "bind": bind source path does not exist: /tmp/logs on running the CLI binary, run the following command: sudo mkdir -p /tmp/logs/.

2. ./build-image.sh - builds the platform image

3. Initialise Docker Swarm mode: docker swarm init

4. Run go cli binary to launch the project:

   • Linux. From terminal run: ./platform-linux
   • Mac. From terminal run: ./platform-macos

     Warning: Mac has an issue with the binary as it views the file as a security risk. See this article to bypass warning

   • Windows. Double click: platform.exe

5. Choose your options and deploy!

Quick Start for devs (remote cluster)

To set up a remote cluster environment, see readme in the cloud repo.

1. Ensure that you have the latest instant repository checked out in the same folder that this repo is in.

2. ./build-image.sh - builds the platform image

3. Add .env.prod file with your remote env vars option set.

   Each Package contains a metadata.json file which lists the configurable Env vars and their default values

4. Run go cli binary to launch the project (Make sure to add the DOCKER_HOST variable indicating your lead Swarm manager, i.e. DOCKER_HOST=ssh://{lead_ip} ./platform-linux):

5. Check the current cli version in ./get-cli.sh and run to download binaries

   • Linux. From terminal run: ./platform-linux
   • Mac. From terminal run: ./platform-macos

     Warning: Mac has an issue with the binary as it views the file as a security risk

   • Windows. Double click: platform.exe

6. Choose the Custom Setup option

7. Specify your environment variable file (or type them all out :| )

8. Add your package IDs, etc. and deploy!

Go Cli Dev

The Go Cli scripts are kept in the OpenHIE Package Start Kit Repo. To make changes to the Cli clone the repo and make your changes in the cli directory.

To create new binaries, create a new tag and release and then change the cli version in ./get-cli.sh in the platform repo and run the script to download the latest.

Platform Package Dev

The Go Cli runs all services from the jembi/platform docker image. When developing packages you will need to build your dev image locally with the following command:

./build-image.sh

As you add new packages to the platform remember to list them in config.yml file. This config file controls what packages the Go Cli can launch from the UI.

For logging all output to a file, ensure that you have created the file and it has the required permissions to be written to. The default log file with it's path is set in .env.local in BASHLOG_FILE_PATH. The logPath property in the config.yml is used to create a bind mount for the logs to be stored on the host.

Resource Allocations

The resource allocations for each service can be found in each service's respective docker-compose.yml file under deploy.resources. The field reservations specifies reserved resources for that service, per container. The field limits specifies that maximum amount of resources that can be used by that service, per container.

Each service's resource allocations can be piped into their .yml file through environment variables. Look at the .yml files for environment variable names per service.

Notes on Resource Allocations

• CPU allocations are specified as a portion of the total number of cores on the host system, i.e., a CPU limit of 2 in a 6-core system is an effective limit of 33.33% of the CPU, and a CPU limit of 6 in a 6-core system is an effective limit of 100% of the CPU.
• Memory (RAM) allocations are specified as a number followed by their multiplier, i.e., 500M, 1G, 10G, etc.
• Be wary of allocating CPU limits to ELK Stack services. These seem to fail with CPU limits and their already implemented health checks.
• Take note to not allocate less memory to ELK Stack services than their JVM heap sizes.
• Exit code 137 indicates an out-of-memory failure. When running into this, it means that the service has been allocated too little memory.

Tests

Tests are located in /test

Cucumber

Tests that execute platform-linux with parameters and observe docker to assert expected outcomes

View /test/cucumber/README.md for more information