Microservice to consume event updates from Payment Hub and persist in event store.
This service is part of the Payment Hub.
flowchart LR
ffc-pay-event-hub(Kubernetes - ffc-pay-event-hub)
topic-events[Azure Service Bus Topic - ffc-pay-events]
topic-alert[Azure Service Bus Topic - ffc-pay-alert]
storage-payments[Azure Table Storage - payments]
storage-batches[Azure Table Storage - batches]
storage-holds[Azure Table Storage - holds]
storage-warnings[Azure Table Storage - warnings]
topic-events ==> ffc-pay-event-hub
ffc-pay-event-hub ==> storage-payments
ffc-pay-event-hub ==> storage-batches
ffc-pay-event-hub ==> storage-holds
ffc-pay-event-hub ==> storage-warnings
ffc-pay-event-hub ==> topic-alert
Optional:
This service publishes responses as messages to Azure Service Bus topics.
| Name | Description |
|---|---|
MESSAGE_QUEUE_HOST |
Azure Service Bus hostname, e.g. myservicebus.servicebus.windows.net |
MESSAGE_QUEUE_USER |
Azure Service Bus SAS policy name, e.g. RootManageSharedAccessKey |
MESSAGE_QUEUE_PASSWORD |
Azure Service Bus SAS policy key |
MESSAGE_QUEUE_SUFFIX |
Developer initials, optional, will be automatically added to topic names, e.g. -jw |
EVENT_TOPIC_ADDRESS |
Azure Service Bus topic name for events, e.g. ffc-pay-events |
EVENT_SUBSCRIPTION_ADDRESS |
Azure Service Bus subscription name for events, e.g. ffc-pay-event-hub |
ALERT_TOPIC_ADDRESS |
Azure Service Bus topic name for events, e.g. ffc-pay-alert |
All message schemas are fully documented in an AsyncAPI specification.
These configuration values should be set in the docker-compose.yaml file or Helm values file if running Kubernetes.
| Name | Description |
|---|---|
APPINSIGHTS_CLOUDROLE |
Azure App Insights cloud role |
APPINSIGHTS_CONNECTIONSTRING |
Azure App Insights connection string |
Docker Compose can be used to build the container image.
docker compose build
The service will file watch application and test files so no need to rebuild the container unless a change to an npm package is made.
The service can be run using the start script.
./scripts/start
This script accepts any Docker Compose Up argument.
A debugger can be attached to the running application using port 9980.
The output of this service is an entry or entries added to the Azure Table Storage tables following receipt of a valid event received from the Azure Service Bus subscription.
Use the AsyncAPI specification to obtain a test input and submit to the Azure Service Bus topic, ffc-pay-events.
You can use the Azure Storage Explorer to view the contents of the Azure Table Storage tables.
The service can be stopped using the stop script.
./scripts/stop
The script accepts any Docker Compose Down argument.
For example, to stop the service and clear all data volumes.
./scripts/stop -v
The service can be tested using the test script.
./scripts/test
The script accepts the following arguments:
--watch/-w- run tests with file watching to support Test Driven Development scenarios (TDD)--debug/-d- run tests in debug mode. Same as watch mode but will wait for a debugger to be attached before running tests.
This service uses the FFC CI pipeline.
THIS INFORMATION IS LICENSED UNDER THE CONDITIONS OF THE OPEN GOVERNMENT LICENCE found at:
http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3
The following attribution statement MUST be cited in your products and applications when using this information.
Contains public sector information licensed under the Open Government license v3
The Open Government Licence (OGL) was developed by the Controller of Her Majesty's Stationery Office (HMSO) to enable information providers in the public sector to license the use and re-use of their information under a common open licence.
It is designed to encourage use and re-use of information freely and flexibly, with only a few conditions.