Mobicoop V3 configuration service
Go to file
sbriat 69dbd6daa0 refactor message broker 2023-03-16 09:55:51 +01:00
ci clean compose 2023-02-28 10:56:39 +01:00
prisma add configuration module 2023-01-25 15:16:13 +01:00
src refactor message broker 2023-03-16 09:55:51 +01:00
.editorconfig initial commit 2023-01-25 10:50:05 +01:00
.env.dist refactor message broker 2023-03-16 09:55:51 +01:00
.env.test refactor message broker 2023-03-16 09:55:51 +01:00
.eslintrc.js initial commit 2023-01-25 10:50:05 +01:00
.gitignore add configuration module 2023-01-25 15:16:13 +01:00
.gitlab-ci.yml clean compose 2023-02-28 10:56:39 +01:00
.prettierrc initial commit 2023-01-25 10:50:05 +01:00
Dockerfile fix dockerfile 2023-01-30 16:52:24 +01:00
LICENSE add configuration module 2023-01-25 15:16:13 +01:00
README.md propagation; improve tests 2023-01-27 10:40:14 +01:00
docker-compose.ci.service.yml clean compose 2023-02-28 10:56:39 +01:00
docker-compose.ci.tools.yml clean compose 2023-02-28 10:56:39 +01:00
docker-compose.yml clean compose 2023-02-28 11:43:12 +01:00
jest-e2e.json add configuration module 2023-01-25 15:16:13 +01:00
nest-cli.json add configuration module 2023-01-25 15:16:13 +01:00
package-lock.json plug to broker 2023-01-26 10:41:57 +01:00
package.json add deploy migrate command 2023-03-10 15:13:08 +01:00
tsconfig.build.json initial commit 2023-01-25 10:50:05 +01:00
tsconfig.json initial commit 2023-01-25 10:50:05 +01:00

README.md

Mobicoop V3 - Configuration Service

Configuration items management. Used to configure all services using a broker to disseminate the configuration items.

Each item consists in :

  • a uuid : a unique identifier for the configuration item
  • a domain : each service is associated with one or more domains, represented by an uppercase string (eg. USER)
  • a key : the key of the configuration item (a string)
  • a value : the value of the configuration item (always a string, each service must cast the value if needed)

This service centralizes the configuration items, but theoratically each service should "push" its items toward the configuration service.

Practically, it's the other way round as it's easier to use this configuration service as the single source of truth. This is why configuration items key and domain are immutable : services may use hardcoded domain-key pairs. Therefore, only values can be updated.

Available domains

  • USER : user related configuration item

Requirements

You need Docker and its compose plugin.

You also need NodeJS installed locally : we strongly advise to install Node Version Manager and use the latest LTS version of Node (check that your local version matches with the one used in the Dockerfile).

The API will run inside a docker container, but the install itself is made outside the container, because during development we need tools that need to be available locally (eg. ESLint, Prettier...).

A RabbitMQ instance is also required to send / receive messages when data has been inserted/updated/deleted.

Installation

  • copy .env.dist to .env :

    cp .env.dist .env
    

    Modify it if needed.

  • install the dependencies :

    npm install
    
  • start the containers :

    docker compose up -d
    

    The app runs automatically on port 5003.

Database migration

Before using the app, you need to launch the database migration (it will be launched inside the container) :

npm run migrate

Usage

The app exposes the following gRPC services :

  • FindByUuid : find a configuration item by its uuid

    {
        "uuid": "80126a61-d128-4f96-afdb-92e33c75a3e1"
    }
    
  • FindAll : find all configuration items; you can use pagination with page (default:1) and perPage (default:10)

    {
        "page": 1,
        "perPage": 10
    }
    
  • Create : create a configuration item (note that uuid is optional, a uuid will be automatically attributed if it is not provided)

    {
        "domain": "USER",
        "key": "key1",
        "value": "value1"
    }
    
  • Update : update a configuration item value

    {
        "value": "value2",
        "uuid": "30f49838-3f24-42bb-a489-8ffb480173ae"
    }
    
  • Delete : delete a configuration item by its uuid

    {
        "uuid": "80126a61-d128-4f96-afdb-92e33c75a3e1"
    }
    
  • Propagate : propagate all configuration items using the message broker

    {}
    

Messages

As mentionned earlier, RabbitMQ messages are sent after these events :

  • Create (message : the created configuration item informations)

  • Update (message : the updated configuration item informations)

  • Delete (message : the uuid of the deleted configuration item)

  • Propagate (message : all the configuration items)

Various messages are also sent for logging purpose.

Tests

Tests are run outside the container for ease of use (switching between different environments inside containers using prisma is complicated and error prone). The integration tests use a dedicated database (see db-test section of docker-compose.yml).

# run all tests (unit + integration)
npm run test

# unit tests only
npm run test:unit

# integration tests only
npm run test:integration

# coverage
npm run test:cov

License

Mobicoop V3 - Configuration Service is AGPL licensed.