Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/drogue-iot/drogue-event-source
A Knative event source for Drogue IoT
https://github.com/drogue-iot/drogue-event-source
cloud iot knative serverless
Last synced: 1 day ago
JSON representation
A Knative event source for Drogue IoT
- Host: GitHub
- URL: https://github.com/drogue-iot/drogue-event-source
- Owner: drogue-iot
- License: apache-2.0
- Created: 2021-11-05T17:02:04.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2022-07-08T10:52:41.000Z (over 2 years ago)
- Last Synced: 2023-03-03T20:39:09.158Z (over 1 year ago)
- Topics: cloud, iot, knative, serverless
- Language: Rust
- Homepage:
- Size: 117 KB
- Stars: 1
- Watchers: 5
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Drogue Cloud Event Source
Connects to [Drogue Cloud](https://github.com/drogue-iot/drogue-cloud) integration endpoint, consumes cloud events sent by devices and forwards them to the next service.
Currently, it only connects to the Websocket Endpoint.
It can be used in combination with https://github.com/drogue-iot/drogue-postgresql-pusher
## Configuration
| Name | Description | Example |
|---------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------|
| MODE | The source mode | `kafka` of `ws` |
| K_SINK | The URL of the service to forward events to | http://timescaledb-pusher |
| ENDPOINT__METHOD | The HTTP method to use, defaults to `POST` | `POST` |
| ENDPOINT__USERNAME | Enables basic auth support using the provided username | `foo` |
| ENDPOINT__PASSWORD | Use as password when basic auth is enabled | `bar` |
| ENDPOINT__TOKEN | Enables bearer auth using the provided token | `e234c376f48e` |
| ENDPOINT__HEADERS__* | Additional HTTP headers, prefixed with `ENDPOINT__HEADERS__` | `ENDPOINT_HEADERS_AUTHORIZATION` |
| ENDPOINT__TLS_INSECURE | Disable TLS validations | `false` |
| ENDPOINT__TLS_CERTIFICATE | The certificate of the (only) trust anchor to use for TLS. By default it will use the system's trust anchors. The certificate must in the PEM PKCS#1 format. | |
| ENDPOINT__TIMEOUT | The timeout of the send operation | `15s` |
| ENDPOINT__ERROR_DELAY | The delay before re-trying a failed operation | `1s` |
| ENDPOINT__RETRIES | The number of re-tries before giving up | 5 |
### Kafka
The following options are available for the `kafka` mode.
| Name | Description | Example |
|-------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------|
| TOPIC | The Kafka topic to consume from | `events-foo-bar` |
| BOOTSTRAP_SERVERS | The list of Kafka bootstrap servers | `kafka-bootstrap:9091` |
| PROPERTIES__* | Additional properties for the Kafka consumer, prefixed with `PROPERTIES__`. The prefix will be removed from the name, the remaining name will be transformed to lowercase and `_` will be transated to `.` | `PROPERTIES__SASL_USERNAME` will become `sasl.username` |
You can find the available properties here: https://github.com/edenhill/librdkafka/blob/master/CONFIGURATION.md
### Websocket
The following options are available for the `ws` mode.
| Name | Description | Example |
|-----------------|---------------------------------------|---------------------------------------------|
| DROGUE_ENDPOINT | The URL of the endpoint to connect to | `wss://ws-integration.sandbox.drogue.cloud` |
| DROGUE_APP | Drogue application to use | `drogue-public-temperature` |
| DROGUE_USER | Drogue cloud user | |
| DROGUE_TOKEN | Access token for Drogue cloud | Use `drg admin tokens create` to create one |
## Building locally
You can build the image locally using:
```shell
podman build . -t drogue-event-source
```