Table of Contents |
---|
Information here will be moved to the Design Decisions Project Board once approved by the TSC
The EdgeX community has and will continue to explore issues of design and architecture of EdgeX Foundry, its many micro services, deployment mechanisms, testing apparatus, build process and more.
...
Readers are encouraged to review the EdgeX mailing list (in particular the edgex-devel@lists.edgexfoundry.org list) and working group meeting minutes (https://wikilf-edgexfoundry.edgexfoundryatlassian.orgnet/wiki/display/FA/Working+Groups) for more information and background on the issues.
...
- How should concepts like Device or Addressable be uniquely identified? Currently using unique name strings
- How should persistent store identifiers be related/not related to these identifiers.
Service Identifiers
- How should micro services be identified uniquely and how should that relate to the address or host of the address?
- Proposed design doc on service naming, availability, configuration, etc.:
- ServiceNameDesign.odt
- ServiceNameDesign-v2.odt (inclusive of typos and clean ups and Trevor Conn comments)
- ServiceNameDesign-v2-awe-comments.odt (inclusive of comments and clean ups from Tony Espy)
- ServiceNameDesign-v3.odt (convergence of Tony/Trevor comments - keeping comments in areas still in need of cleanup/resolution)
- ServiceNameDesign-v3-awe-comments.odt (comments on V3 from Tony Espy) ServiceNameDesign-v4.odt
Closed Discussion Items
General
- Copyright header – stays the same (see contributor page) until LF has an alternative header and tool to provide
- Enums & JSON – use strings in place of any language specific enums or Iota in JSON messages and serialize/deserialize as necessary in your language of choice.
...
- Agreed to use TOML for specifying configuration information (for local config as well as to config-seed) going forward. Java code will not be altered at this time.
- Reasons for TOML (over JSON or YAML) is that white spacing is ignored and it may be validated in the future.
- In the future, EdgeX may support multiple types of configuration - allowing the user to pick the file format.
Service Identifiers
- How should micro services be identified uniquely and how should that relate to the address or host of the address?
- Proposed design doc on service naming, availability, configuration, etc.:
- ServiceNameDesign.odt
- ServiceNameDesign-v2.odt (inclusive of typos and clean ups and Trevor Conn comments)
- ServiceNameDesign-v3.odt (convergence of Tony/Trevor comments - keeping comments in areas still in need of cleanup/resolution)
- ServiceNameDesign-v4.odt
- ServiceNameDesign-v5.odt
- ServiceNameDesign-v6.pdf