mirror of
https://github.com/mainflux/mainflux.git
synced 2025-05-04 22:17:59 +08:00
8be2516321
* Use Normalizer as a lib To normalize messages on the consumer side, Normalizer is moved to the internal pkgs. Writers being message consumers are modified to do message normalization instead of subscribing to normalized messages subject. Signed-off-by: Dušan Borovčanin <dusan.borovcanin@mainflux.com> * Fix logging middleware for readers and writers Signed-off-by: Dušan Borovčanin <dusan.borovcanin@mainflux.com> * Remove normalizer interface Signed-off-by: Dušan Borovčanin <dusan.borovcanin@mainflux.com> * Use Normalizer in writers As we agreed on #919, we'll use normalizer as an interface and provide the default SenML implementation. Because of that, Normalizer is removed from `internal` and we'll use the project structure proposed in the aforementioned issue. Signed-off-by: Dušan Borovčanin <dusan.borovcanin@mainflux.com> * Fix tests Signed-off-by: Dušan Borovčanin <dusan.borovcanin@mainflux.com> * Remove unused batch settings from influxDB reader Signed-off-by: Dušan Borovčanin <dusan.borovcanin@mainflux.com> * Update docs Move Normalizer service to `addons`. Signed-off-by: Dušan Borovčanin <dusan.borovcanin@mainflux.com> * Rename channels input topic Signed-off-by: Dušan Borovčanin <dusan.borovcanin@mainflux.com> * Update Noramlizer docs Signed-off-by: Dušan Borovčanin <dusan.borovcanin@mainflux.com> * Remove commented code Signed-off-by: Dušan Borovčanin <dusan.borovcanin@mainflux.com> * Update readers logging Signed-off-by: Dušan Borovčanin <dusan.borovcanin@mainflux.com> * Update addons docker-compose files Signed-off-by: Dušan Borovčanin <dusan.borovcanin@mainflux.com> * Update topcis explanations Signed-off-by: Dušan Borovčanin <dusan.borovcanin@mainflux.com>
70 lines
2.7 KiB
Markdown
70 lines
2.7 KiB
Markdown
# MongoDB writer
|
|
|
|
MongoDB writer provides message repository implementation for MongoDB.
|
|
|
|
## Configuration
|
|
|
|
The service is configured using the environment variables presented in the
|
|
following table. Note that any unset variables will be replaced with their
|
|
default values.
|
|
|
|
| Variable | Description | Default |
|
|
|---------------------------------|--------------------------------------------|-----------------------|
|
|
| MF_NATS_URL | NATS instance URL | nats://localhost:4222 |
|
|
| MF_MONGO_WRITER_LOG_LEVEL | Log level for MongoDB writer | error |
|
|
| MF_MONGO_WRITER_PORT | Service HTTP port | 8180 |
|
|
| MF_MONGO_WRITER_DB_NAME | Default MongoDB database name | mainflux |
|
|
| MF_MONGO_WRITER_DB_HOST | Default MongoDB database host | localhost |
|
|
| MF_MONGO_WRITER_DB_PORT | Default MongoDB database port | 27017 |
|
|
| MF_MONGO_WRITER_CHANNELS_CONFIG | Configuration file path with channels list | /config/channels.toml |
|
|
|
|
## Deployment
|
|
|
|
```yaml
|
|
version: "3.7"
|
|
mongodb-writer:
|
|
image: mainflux/mongodb-writer:[version]
|
|
container_name: [instance name]
|
|
depends_on:
|
|
- mongodb
|
|
- nats
|
|
expose:
|
|
- [Service HTTP port]
|
|
restart: on-failure
|
|
environment:
|
|
MF_NATS_URL: [NATS instance URL]
|
|
MF_MONGO_WRITER_LOG_LEVEL: [MongoDB writer log level]
|
|
MF_MONGO_WRITER_PORT: [Service HTTP port]
|
|
MF_MONGO_WRITER_DB_NAME: [MongoDB name]
|
|
MF_MONGO_WRITER_DB_HOST: [MongoDB host]
|
|
MF_MONGO_WRITER_DB_PORT: [MongoDB port]
|
|
MF_MONGO_WRITER_CHANNELS_CONFIG: [Configuration file path with channels list]
|
|
ports:
|
|
- [host machine port]:[configured HTTP port]
|
|
volume:
|
|
- ./channels.yaml:/config/channels.yaml
|
|
```
|
|
|
|
To start the service, execute the following shell script:
|
|
|
|
```bash
|
|
# download the latest version of the service
|
|
go get github.com/mainflux/mainflux
|
|
|
|
|
|
cd $GOPATH/src/github.com/mainflux/mainflux
|
|
|
|
# compile the mongodb writer
|
|
make mongodb-writer
|
|
|
|
# copy binary to bin
|
|
make install
|
|
|
|
# Set the environment variables and run the service
|
|
MF_NATS_URL=[NATS instance URL] MF_MONGO_WRITER_LOG_LEVEL=[MongoDB writer log level] MF_MONGO_WRITER_PORT=[Service HTTP port] MF_MONGO_WRITER_DB_NAME=[MongoDB database name] MF_MONGO_WRITER_DB_HOST=[MongoDB database host] MF_MONGO_WRITER_DB_PORT=[MongoDB database port] MF_MONGO_WRITER_CHANNELS_CONFIG=[Configuration file path with channels list] $GOBIN/mainflux-mongodb-writer
|
|
```
|
|
|
|
## Usage
|
|
|
|
Starting service will start consuming normalized messages in SenML format.
|