diff options
author | 2016-10-14 14:09:02 +0200 | |
---|---|---|
committer | 2016-10-21 05:41:19 +0000 | |
commit | 5f1baedefebd2ee3c5003957a3441ca54ff3380e (patch) | |
tree | 2584e81f81e2d4052846aa9771089304bf6a16cd /release-notes/src/main/asciidoc/devel_guide/devel_plugin_overview.adoc | |
parent | be37eab49d25c4ed179acfd2d4c896ac1a70de1c (diff) |
Release notes
- migrated from wiki
- updated versions to current version
- notes are built with each regular build
- notes root is at: target/generated-docs/release_notes.html
- notes are inlined into site
Change-Id: I581898988f41f77f5eafb20e9e61e08f09908b98
Signed-off-by: Maros Marsalek <mmarsale@cisco.com>
Diffstat (limited to 'release-notes/src/main/asciidoc/devel_guide/devel_plugin_overview.adoc')
-rw-r--r-- | release-notes/src/main/asciidoc/devel_guide/devel_plugin_overview.adoc | 26 |
1 files changed, 26 insertions, 0 deletions
diff --git a/release-notes/src/main/asciidoc/devel_guide/devel_plugin_overview.adoc b/release-notes/src/main/asciidoc/devel_guide/devel_plugin_overview.adoc new file mode 100644 index 000000000..d844a2f5c --- /dev/null +++ b/release-notes/src/main/asciidoc/devel_guide/devel_plugin_overview.adoc @@ -0,0 +1,26 @@ += Plugin overview + +link:release_notes.html[< Home] + +Honeycomb provides a framework for plugins to participate in the data handling. The plugins use YANG modeling language to describe what: + +* *data* they can handle (Create, Read, Update, Delete operations) +* *notifications* do they emit + +NOTE: RPCs are not supported in this release. + +A plugin usually consists of: + +* *YANG models* - These models contain data and notification definitions that are implemented by the plugin. ODL's Yangtools project is used to generate Java APIs from those models (called Binding Aware APIs in ODL) and are later used in the translation code. +* *Set of readers* - Readers provide operational/state data from plugin or its underlying layer. This means that operational/state data is current state of the plugin or its underlying layer. Readers return these operational data by e.g. reading from underlying layer and transforming it into YANG modeled data. +* *Set of writers* - Writers handle configuration data for the plugin or its underlying layer This means that configuration data is the intent being sent to Honeycomb, that should be passed to plugins or their underlying layers. Writers handle these configuration data by transforming YANG modeled data into e.g. underlying layer calls. +* *Set of initializers* - Initializers are invoked right after Honeycomb starts. The gould here is to read current operational/state data of the plugin or its underlying layer and then transform the operational data into configuration data. This enables reconciliation in cases when Honeycomb looses it's persisted data, or is started fresh while the underlying layer already contains some configuration that is manifested as operational/state data +* *Plugin configuration* - Usually configuration in json format + it's Java equivalent. +* *Set of notification producers* - If there are any notifications, the producers transform the data into YANG model notifications and emit them. +* *Module* - Small class instantiating & exposing plugin's components + +What's good to add: + +* *Unit tests* +* *Documentation* (as Readme.adoc + update global release notes if the plugin is included into honeycomb integration distribution) +* *Sample REST or NETCONF requests* (as POSTMAN request collection)
\ No newline at end of file |