logistimo/approvals-service repository overview

⁠What is approvals-service ?

Approval Service is a micro-service for the creation and maintaince of approvals. It exposes APIs for creating approvals, retrieving approvals and approval status history, updating approval status and fetching a list of approvals based on a variety of filters. It contains a scheduled task for expiring an approval in a specific queue and for expiring approval as a whole. It generates events for approval creation, approval status update and approver status update for the purpose of consumption by dependent services.

⁠How to use the approvals-service docker image

⁠Start a approvals-service using docker run:

docker run --net=host -e SERVER_PORT="6400" -e MYSQL_HOST="jdbc:mariadb://<mariadb_host>:3306/approval_service?useUnicode=true&amp;characterEncoding=UTF-8" -e MYSQL_USER="<mysql_user>" -e MYSQL_PASSWORD="<mysql_password>" \
-e CONVERSATION_SERVICE_URL="http://<logistimo_app_host>:8082" -e ACTIVEMQ_BROKER_URL="tcp://<activemq_host>:61616" -e ACTIVEMQ_USER="<activemq_user>" -e ACTIVEMQ_PASSWORD="<activemq_password>" -e TASK_MACHINE="true" --name approvals-service -d logistimo/approvals-service:latest

⁠Container shell access and viewing approvals logs

The docker exec command allows you to run commands inside a Docker container. The following command line will give you a bash shell inside your approvals container:

$ docker exec -it approvals-service /bin/bash

The approvals logs can be seen using the following command

$ docker logs -f approvals-service