55 lines
2.8 KiB
Markdown
55 lines
2.8 KiB
Markdown
# hawkbit-update-server
|
|
|
|
Build: [](https://circleci.com/gh/eclipse/hawkbit)
|
|
|
|
Want to chat with the team behind hawkBit? [](https://gitter.im/eclipse/hawkbit?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
|
|
[hawkBit](https://projects.eclipse.org/projects/iot.hawkbit) is an domain independent back end solution for rolling out software updates to constrained edge devices as well as more powerful controllers and gateways connected to IP based networking infrastructure.
|
|
|
|
|
|
# Compile
|
|
```
|
|
mvn install
|
|
```
|
|
|
|
# Run and use
|
|
|
|
We are not providing an off the shelf production ready hawkBit server. However, we recommend to check out the [Example Application](examples/hawkbit-example-app) for a runtime ready Spring Boot based update server that is empowered by hawkBit.
|
|
|
|
# Releases and Roadmap
|
|
|
|
* We are currently working on the first formal release under the Eclipse banner: 0.1 (see [Release 0.1 branch](https://github.com/eclipse/hawkbit/tree/release-train-0.1)).
|
|
* The master branch contains future development towards 0.2. We are currently focusing on:
|
|
* Rollout Management for large scale rollouts.
|
|
* Clustering capabilities for the update server.
|
|
* Upgrade of Spring Boot and Vaadin depedencies.
|
|
* And of course tons of usability improvements and bug fixes.
|
|
|
|
|
|
## Try out examples
|
|
#### Standalone Test Application Server
|
|
[Example Application](examples/hawkbit-example-app)
|
|
#### Device Simulator using the DMF AMQP API
|
|
[Device Simulator](examples/hawkbit-device-simulator)
|
|
|
|
# Modules
|
|
`hawkbit-core` : core elements.
|
|
`hawkbit-security-core` : core security elements.
|
|
`hawkbit-security-integration` : security integration elements to integrate security into hawkbit.
|
|
`hawkbit-artifact-repository-mongo` : artifact repository implementation to mongoDB.
|
|
`hawkbit-autoconfigure` : spring-boot auto-configuration.
|
|
`hawkbit-dmf-api` : API for the Device Management Integration.
|
|
`hawkbit-dmf-amqp` : AMQP endpoint implementation for the DMF API.
|
|
`hawkbit-repository` : repository implemenation based on SQL for all meta-data.
|
|
`hawkbit-http-security` : implementation for security filters for HTTP.
|
|
`hawkbit-rest-api` : API classes for the REST Management API.
|
|
`hawkbit-rest-resource` : HTTP REST endpoints for the Management and the Direct Device API.
|
|
`hawkbit-ui` : Vaadin UI.
|
|
`hawkbit-cache-redis` : spring cache manager configuration and implementation with redis, distributed cache and distributed events.
|
|
|
|
|
|
# Device Integration
|
|
There are two device integration APIs provided by the hawkbit update server.
|
|
* [Direct Device Integration API (HTTP)](DDIA.md)
|
|
* [Device Management Federation API (AMQP)](DMFA.md)
|